Utilities: How to Use the CHRGLIST Utility

Transcription

1 UFIT EI&O Document ID: D0083 Last Updated: 07/03/2002 The CHRGLIST utility provides detailed information about the monthly charges applied to your userid. This document contains JCL examples, sample input formats, and output information. Related subjects include accounting, utilities, jobs, billing NE Waldo Rd, Suite 2100 Gainesville Florida (352) UF Information Technology 1

2 Table of Contents Utilities: How to Use the CHRGLIST...3 Introduction...3 Input Data Format...3 How Do You Know Your CNS Group?...5 Output Information...5 Sample Job Setups...6 When Will Charges be Applied to My Account Balance?...8 Questions...9 2

3 The easiest way to use the CHRGLIST utility is via the interactive Web interface provided at To use the CHRGLIST utility in batch mode, you must create a simple program to run on our z/os (formerly OS/390) operating system. Use a text editor (like ISPF Edit in TSO) to type the JCL and input statements into a file. Items in lowercase are supplied by you; items in uppercase must be typed exactly as they appear. All text in the file must be in uppercase. Save your file. To run your job, enter SUBMIT filename Use the IOF command to view a list of your current/recent jobs. You can read, save, or discard the output from there. See D0030, IOF, The Interactive Output Facility for more information on using IOF. Introduction Utilities: How to Use the CHRGLIST The CHRGLIST utility provides detailed information on the charges applied to userids during the month's billing period. Data for the current and previous months are kept online. Data for earlier months are kept on tape and must be accessed using a SETUP statement. You may get detailed information dating from June 1979 to the present by using the CHRGLIST utility. The following job setup should be used to access data for the current or previous month: //jobname JOB (,,time,lines),'your name',class=u...input statements... Class U may be used to select charges from the current or previous month. Charges for earlier months must be run under standard job classes (see D0058). To access data from earlier months, use the setup below: SETUP TAPEC,1...input statements... Input Data Format Commands may appear anywhere between columns 1 and 72 of the input statements. Continuation is allowed and is indicated by a trailing comma on the input statement. All commands may be abbreviated to the first character of the keyword name. 3

4 USER= GROUP= KEYWORDS ACCOUNT/ACCESS= SEQUENCE= MONTH= DESCRIPTIONS CNS userid. The default is the userid under which the CHRGLIST job is being run. CNS default group. This parameter may be used to select charges for an entire default group. A wild card character (*) is permitted in the group parameter. The group parameter may not be used to select charges prior to September Account/access number. This parameter may be used to select charges by account number for charges after August 1994 OR to select charges by access number for charges prior to September If you use this parameter to select by access number, you may also specify a beginning and ending range. Sequence number or beginning and ending sequence numbers. If an access number with no sequence number is specified on the CHRGLIST control statement, charge records for all sequence numbers under that access number will be selected. Month(s) for which charge records are to be selected. The default is the current month. Months are requested in the form mmmyy for month and year, LAST for the previous month, and CURNT for the current month. If more than one month is requested, the months must be enclosed in parentheses. Requests for the current or previous month's charges may be run under CLASS=U. LINES= Lines per page. The default is a full page (84 lines). XREF= FORMTYPE= Cross reference totals. Valid values are SEQ, ACC, RNG, USER, or GROUP. SEQ (sequence number), ACC (access/account number), USER (userid), and GROUP (group) specify a listing of each charge type, the number of times it occurs, and the amount of each charge type to be printed at the requested intervals. RNG provides totals at sequence number and access number intervals or userid, group, or account number intervals, depending on the selection criteria. SEQ may not be used to select charges after August 1994 and GROUP may not be used to select charges prior to September The default is XREF=NO (no cross reference). Special Option. If FORMTYPE=BAL is 4

5 DETAIL= KEYWORDS DESCRIPTIONS requested, the current balance will be displayed for each userid requested. The default is FORMTYPE=NO. Detail records to print. If DETAIL=NO is requested, detail charge record printing will be suppressed and ONLY totals will be shown. The default is DETAIL=YES. How Do You Know Your CNS Group? If you do not know the group identifier for your userid or access number, you can use the BALance command to get this information. Type: BAL userid or BAL accessnumber,seq and press <Enter>. The group identifier is listed under the title Group and is the third item from the left of the screen. Output Information The title contains the run date and the month for which the information is listed. Information listed includes the userid, access number/sequence number, or group; date of charge; time of charge; CPU id; jobname; JES2 job number; charge amount; type of charge; programmer name or comment; quantity; CPU time; and class. The information given under each of these headings may vary according to the type of job being run. Some examples are given below: BATCH JOBS TSO SESSIONS PRINT OR PUNCH NERSP (AIX) CICS See The quantity is the number of tape mounts, and class is the job execution class.. See The jobname is the logon id. Programmer name is the name associated with the userid. Quantity is the connect time in seconds.. See The comment is the output device and, if not standard, the forms number. Quantity is the number of lines printed and the number of pages printed or it is the number of statements punched. Class is the the output class.. See The comment is the count of sessions, count of I/O to block devices, and count of processes. The quantity is the connect time.. See The jobname is the terminal id and operator number. Comment is CICS region. Quantity is the number of 5

6 transactions.. DB2 See The jobname is the correlation value. The comment is the subsystem id, connection name, and plan. Quantity is the number of GET pages issued and buffer updates.. Note that quantity is included for information purposes only. Charges are computed by applying published rates (see the "CNS Charging Algorithm" document (D0001) for a list of rates). Sample Job Setups This example will print the current charges for the userid under which the job is run. Figure 1. Current Charges. //jobname JOB (,,time,lines),'your name',class=u This example will print the current and last months' charges for the group $STUDENT and will display current balances for each userid in the group. It assumes that $STUDENT is the default group of the userid that submits the job. Figure 2. Group Charges and Balances //jobname JOB (,,time,lines),'your name',class=u GROUP=$STUDENT,MONTH=(LAST,CURNT),FORMTYPE=BAL This job requests charges for the current month for all userids in the account A cross reference of charge types for the account number will be generated. Figure 3. Account Number and Cross Reference by Charge Type //jobname JOB (,,time,lines),'your name',class=u A= ,X=ACC This job will list charges incurred by sequence number 55 of access number for August 1994 with the output printed at 62 lines per page. 6 Figure 4. Access/Sequence Number Charges

7 SETUP TAPEC,1 A= ,S=55,M=AUG94,L=62 The following job requests the charges for userid GATOR for September 1993 with a cross reference by charge type. Figure 5. Userid Charges and Cross Reference by Charge Type SETUP TAPEC,1 U=GATOR,MONTH=SEP93,XREF=USER This job requests the charges incurred for all userids in groups beginning with $PS for the current month. It also requests the charges for sequence numbers 7 through 12 of access number for May and June Figure 6. Multiple Command Statements SETUP TAPEC,1 G=$PS* A= ,S=(7,12),M=(MAY94,JUN94) This job requests the charges incurred for all access numbers in the range to during December 1993 and January 1994 with a breakdown by charge type for the entire range of access numbers. Figure 7. Access Number Range and Cross Reference by Charge Type SETUP TAPEC,1 A=( , ),M=(DEC93,JAN94),XREF=RNG This job requests the charges incurred for the current month, by the user "GATOR." The report will only show the userid total charges and userid totals by charge type. Figure 8. Suppressing Charge Detail records USER=GATOR,DETAIL=NO,XREF=USER 7

8 When Will Charges be Applied to My Account Balance? Balances on CNS accounts are updated hourly, nightly, or monthly, depending on the charge type. Because the posting of some charges is delayed, you could see a positive balance from the BALANCE command even though you have spent enough to result in a zero balance. You would be able to sign on and do additional computing. But, the next day, after nightly or monthly charges were applied, your ture negative balance would be apparent and you would not be able to sign on. Charges for z/os (formerly OS/390) data sets and AIX file storage will be collected and charged to your account even if your balance is zero or negative. The table below shows how often charges are applied to your balance for common charge types. This table lists common charge types, the current charge application cycle for those charge types, and planned changes to that schedule. 8 Table 1. Application Cycle of Charges to CNS Account Balances CHARGE TYPE CYCLE PLANNED CHANGE 1 BATCH NIGHTLY HOURLY 2 TSO NIGHTLY HOURLY 7 PRINT/PUNCH NIGHTLY HOURLY 9 CICS NIGHTLY 11 CIRCA NIGHTLY 12 ALL POINTS ADDRESSABLE NIGHTLY 17 DB2 NIGHTLY 21 LASER PRINT NIGHTLY 22 TERMINAL SERVER NIGHTLY 23 NERSP CPU NIGHTLY 32 BULK RATE CHARGES AND ADJUSTMENT 33 NOT ELIGIBILE FOR BULK ADJUSTMENT 34 MATERIALS NO DISCOUNT HOURLY 35 MATERIALS HOURLY 37 z/os (formerly OS/390) DATA SETS NIGHTLY HOURLY

9 (DSMS) 40 TELEPROCESSING NO DISCOUNT 42 MICROFICHE CHARGES NIGHTLY 44 SALES TAX 45 MINIMUM INVOICE CHARGE 50 TELEPROCESSING CHARGES 53 LARGE VOLUME DISK STORAGE 55 AIX FILES NIGHTLY 57 APLPLUS FILES NIGHTLY 90 GENERAL REFUNDS Utilities: How to Use the CHRGLIST HOURLY 91 FUND TRANSFERS HOURLY Questions Questions about using the CHRGLIST utility should be directed to the CNS Support Desk at (352) , or the UF Computing Help Desk at (352) 392-HELP, Your Comments are Welcome We welcome your comments and suggestions on this and all UFIT documentation. Please send your comments to: UFIT 2046 NE Waldo Rd, Suite 2100 Gainesville Florida (352) UF Information Technology 9

10 10