ACFRPTCR - TSO Command Statistics Log

1
acf2src
 
 
1
 
 
The ACFRPTCR utility formats the audit information collected by the CA ACF2 TSO interface routines. To collect the TSO command statistics, specify the CMDREC field in the GSO OPTS record. For more information, see Global System Option Records. You can collect TSO command statistics for a particular use by specifying the TSO-TRC field in a user's logonid record. You can also specify that SMF records contain information for each TSO command or CLIST issued in READY mode or under ISPF.
Authorization Checking
CA ACF2 checks whether the person submitting the utility is authorized to view or manipulate the input SMF data. If you specify RPTSCOPE in the GSO OPTS record, a user is restricted to the SMF record data that matches his or her privileges and restrictions. If you specify NORPTSCOPE, no authorization checking is done.
When RPTSCOPE is specified, CA ACF2 validates the following privileges and restrictions of the user running the ACFRPTCR report as part of the report processing: SECURITY or AUDIT and the UID or LID fields in the associated scope record. If the user has one of these authorities and the SMF record is in the scope of the user's logonid, the user can view the record.
Running the Report Using the ISPF Panel
You can use the ACFRPTCR - TSO Command Statistics Log ISPF panel to create your input for the ACFRPTCR report. The following parameters are available on the ACFRPTCR ISPF panel.
 
TITLE
Specifies a character string added to other title information at the top of the report. This character string can be up to 35 characters in length. If you do not specify this parameter, the report generator uses the first 35 characters in the PARM field of the EXEC statement. If this character string is longer than 35 characters, the first 35 characters are used.
 
BUFFER
BUFFER prints the command name, time of day, calling program and the command entered by the user. NOBUFFER (the default) just prints the command name, time of day and calling program. 
 
TIME
Specifies the desired format of the time stamp in the report : M (default) displays HH.MM, S = HH.MM.SS or H = HH.MM.SS.TH.
 
OUTPUT LIST NAME: LIST ID
Specifies the 1- to 8-character output list name. ISPF prefixes the name you specify with the user's prefix from his profile and the characters ACF2.ACFRPTCR. For example, if you specify TEST as the output list name, your output list data set name will be 
dft-pfx
.ACF2.ACFRPTCR.TEST.
 
SPECIFY INPUT DATA SET(S) FOR ACFRPTCR
For an explanation of the options available, see Reporting.
 
LOGSTREAM
Indicates if LOGSTREAM SMF data needs to be retrieved. This parameter is available for z/OS1.9 and higher when the SNF data is being captured by a LGR LOGSTREAM structure. When Y is specified an ACFRPTAL is displayed to provide specific logstream parameters.
Running the Report Using JCL
You can use JCL to run the ACFRPTCR report. For information running the report, see Reporting.
The following parameters are specific to ACFRPTCR:
 
[BUFFER|NOBUFFER]
BUFFER prints the command name, time of day, calling program and the command entered by the user. NOBUFFER (the default) just prints the command name, time of day and calling program. 
 
[MASK(********|logonidmask)]
Specifies the logonid or logonids to appear in the report. For TSO, the logonid and job name are usually the same. The default is all logonids.
 
[UID(-|uidmask)]
Specifies the user or users to appear in the report. Any value specified for this parameter is expanded with asterisks to the full 24-character length of the UID. The default is all users.
 
[UPPER|NOUPPER]
UPPER specifies all uppercase characters when the output is directed to a device that does not support lowercase letters or a device that does not have a character set fold option (lowercase letters are not automatically translated to uppercase). This option only applies to the command buffer displayed when the BUFFER parameter is specified. All other report output is always displayed in uppercase. 
Common Parameters
When using the ISPF panel or JCL, 
  • LINECNT
  • JOBMASK
  • TITLE
  • SDATE
  • EDATE
  • STIME
  • ETIME
  • SELECT
  • SYSID
  • HEX
  • COND
  • TIME
Input Output Files
The ACFRPTCR report utility uses the SYSIN file and the standard report generator input and output files (RECxxxxx and SYSPRINT), as explained in Reporting. 
Sort Sequence
The recommended sort sequence for the ACFRPTCR report is by job name (major), date, and time. Perform this sorting using your own routine or modify the prototype JCL.
Sample Output
The following sample outputs show the ACFRPTCR report format produced from combined SMF records. These two reports show the difference between the BUFFER and NOBUFFER report parameters when TIME(M) and TIME(H) are used. 
NOBUFFER
The default NOBUFFER TIME(M) produces this first sample report
<acf> Security - ACFRPTCR - TSO COMMAND STATISTICS - PAGE 1 DATE 08/09/06 (06.221) TIME 09.25 TESTJOBA TIME(M) 06.214 08/02 15.01 JOB=TESTJOBA UID= TESTUSR1 SYSTEM ID= SYS9 SEQUENCE COMMAND TIME OF CALLING NUMBER NAME DAY PROGRAM 00 @SLEEPX 15.00 IKJEFT02 01 @SLEEPX 15.00 IKJCT429 02 * TSOEXEC 15.00 IKJEFT02 03 * CALL 15.00 IKJEFT01 04 * CALL 15.00 IKJEFT02 05 END 15.01 IKJEFT02 06.214 08/02 15.51 JOB=TESTJOB2 UID= TESTUSR1 SYSTEM ID= SYS9 SEQUENCE COMMAND TIME OF CALLING NUMBER NAME DAY PROGRAM 00 ACF 15.51 IKJEFT02 NOTE: 'C' INDICATES CLIST OR INVALID COMMAND, * INDICATES COMMAND WITHIN CLIST
In the ACFRPTCR report, the command trace entries are grouped into sections. The entries in one section were written to SMF as one record.
The previous example shows one section. The section heading line (third printed line) shows the Julian and Gregorian calendar dates on which the record was written. This line also shows the time of day in format HH.MM when the record was written, the job name associated with the commands being traced, the UID of the submitter, and the system ID.
BUFFER
The BUFFER parameter produced this second sample report:
<acf> Security - ACFRPTCR - TSO COMMAND STATISTICS - PAGE 1 DATE 08/09/06 (06.221) TIME 09.28 TESTJOBA BUFFER TIME(H) 06.214 08/02 15.01.32.41 JOB=TESTJOBA UID= TESTUSR1 SYSTEM ID= SYS9 SEQUENCE COMMAND TIME OF CALLING NUMBER NAME DAY PROGRAM 00 @SLEEPX 15.00.43.97 IKJEFT02 @SLEEPX SECONDS(45) 01 @SLEEPX 15.00.45.45 IKJCT429 @SLEEPX SECONDS(45) 02 * TSOEXEC 15.00.46.09 IKJEFT02 TSOEXEC CALL 'QAT.HOTP.APFLOAD(SLEEP)' '45' 03 * CALL 15.00.46.65 IKJEFT01 CALL 'QAT.HOTP.APFLOAD(SLEEP)' '45' 04 * CALL 15.00.46.65 IKJEFT02 CALL 'QAT.HOTP.APFLOAD(SLEEP)' '45' 05 END 15.01.31.72 IKJEFT02 END 06.214 08/02 15.51.43.42 JOB=TESTJOB2 UID= TESTUSR1 SYSTEM ID= SYS9 SEQUENCE COMMAND TIME OF CALLING NUMBER NAME DAY PROGRAM 00 ACF 15.51.33.77 IKJEFT02 ACF NOTE: 'C' INDICATES CLIST OR INVALID COMMAND, * INDICATES COMMAND WITHIN CLIST
Field Descriptions
The following fields are available on the ACFRPTCR report.
  •  
    CALLING PROGRAM
    Indicates the name of the module that called the command.
  •  
    COMMAND NAME
    Indicates the name of the command or CLIST that was issued. An asterisk (*) preceding a command name indicates that the command was issued from a CLIST. A 
    C
     before a command name indicates an implicit CLIST command.
    Implicit CLISTs are recognized by CA ACF2 from their special notation (a percent sign (%) prefix under TSO). However, sometimes implicit CLISTs are not entered with the special notation. When this situation occurs, CA ACF2 assumes that these CLISTs are real commands, because:
    • The CLIST is not part of the user's command limiting list
    • The user does not have a command limiting list
  • Because of these two factors, the ACFRPTCR report shows a blank and not an asterisk (*) or a C next to the command name. This blank space indicates that CA ACF2 is unsure whether the command entered was an implicit CLIST or a command issued from a CLIST.
  •  
    SEQUENCE NUMBER
     
    Specifies the sequence number of the command during the session where it was executed. Because of z/OS SMF processing, the output SMF records do not necessarily reflect the order in which the commands were issued. The command sequence field provides a means of determining this order. This sequence number is incremented by one for each command issued.
  •  
    TIME OF DAY
     
    Indicates, in minutes and seconds, the time of day when the command was issued. This time is based on a 24-hour clock.