Previous Topic: TSSREPORT2 UtilityNext Topic: TSSRPTST Utility


TSSREPORT3 Utility

TSSREPORT3 takes the output from the TSSCPR utility to produce a single report depicting the contents of the CPF Recovery File.

TSSREPORT3 JCL

The JCL is found in CAI.SAMPJCL on the distribution tape.

//REPORT        JOB
//Earl          EXEC PGM=Earl,REGION=4096K
//EarlLIB         DD DISP=SHR,DSN=your.source.library
//EarlOBJ         DD  UNIT=unit,SPACE=(3200,(50,4),RLSE)
//SYSUT1          DD  UNIT=unit,SPACE=(3200,(15,4),RLSE)
//SYSUT2          DD  UNIT=unit,SPACE=(3200,(4,4))
//SYSUT3          DD  UNIT=unit,SPACE=(3200,(4,4))
//SYSUT4          DD  UNIT=unit,SPACE=(3200,(10,4),RLSE)
//SYSUT5          DD  UNIT=unit,SPACE=(3200,(70,4),RLSE)
//SYSUT6          DD  UNIT=unit,SPACE=(3200,(15,1),RLSE)
//SORTIN          DD  UNIT=unit,SPACE=(3200,(70,4),RLSE)
//SORTOUT         DD  UNIT=unit,SPACE=(3200,(70,4),RLSE)
//WORK1           DD  UNIT=unit,SPACE=(3200,(300,200))
//SORTWK01        DD  UNIT=unit,SPACE=(3200,(70,4))
//SORTWK02        DD  UNIT=unit,SPACE=(3200,(70,4))
//SORTWK03        DD  UNIT=unit,SPACE=(3200,(70,4))
//SYSUDUMP        DD  SYSOUT=*
//SYSPRINT        DD  SYSOUT=*
//SYSOUT          DD  SYSOUT=*
//TSSCPFR         DD  DSN=name.of.tsscpr
//SYSIN           DD  DISP=SHR,DSN=your.source.library(TSSEarlE)
EarlLIB

Defines the CA‑Earl macro library. This source statement library is referenced by the COPY statement within the user's CA‑Earl source program.

EarlOBJ

Defines the file on which the CA‑Earl text file is stored.

SORTIN

Defines the temporary hit file, which contains only the fields from the input records, which are needed to produce the final printed reports. If required to sort the hit file, SORTIN defines the input file to the stand‑alone sort invoked by CA‑Earl.

SORTOUT

Defines the temporary output file from the stand‑alone sort.

WORK1

Defines the SRAM (Sort Reentrant Access Method) file.

SORTWK01

Used with SORTWK02 and SORTWK03, defines the temporary work files for the stand‑alone sort.

TSSCPFR

The name of your CPFOUT file. You must run TSSCPR before running TSSREPORT3. See the chapter “TSSCPR Utility” for the JCL needed to run that utility.

You can generate reports by putting the TSSCPR output (OUT DD) in a permanent data set and using this data set to run multiple CA‑Earl reports. This saves time by allowing you to run many reports from the same data.

You can also run TSSCPR and write the output to a temporary data set. Use this temporary data set as input for your TSSREPORT3 JCL.

SYSIN

The input control statement. Put the name of the report you wish to run (in this case TSSEarlE) after the name of your source library.

Note: TSSREPORT3 produces a preformatted report depicting the entire contents of the CPF Recovery File. There are no additional parameters or selection criteria that can be specified.

Sample Report E CPF Recovery File

This report produces a list of the contents of the CPF Recovery File.

PARM=

There are no input parameters for this report.

07/07/02    Sample /MVS Report 3                      PAGE       1
                                                 CPF Recovery File
__________________________________________________________________
CMD   ACID   Cmd buffer in 80 byte segments                   Count
Dest______________________________________________________________

XE56  USER01  TSS LIST(USER01) DATA(NAMES) TARGET(*) WAIT(N)

XE56  MASTER  TSS REP(TWFRED) PASS(?)

XE56  MASTER  TSS REP(USERJM) PASS(?)

XE56  MASTER  TSS ADD(RJDEV1) PASS(?)

XE56  MASTER  TSS LIST(RJDEV1) DATA(ALL) TARGET(*)

XE56  MASTER  TSS REP(KELDEV) PASS(?)

XE56  AUDVAC  TSS CREATE(AUDIT01) TYPE(USER) 
                  NAME('John Smith') DEPT(AUDEPT) PASSWORD(?)

XE56  AUDVAC  TSS CREATE(AUDIT02) TYPE(USER) NAME('Charles Browne') 
                  DEPT(AUDEPT) PASSWORD(?) VXAUFGROUP(GROUP1) 
                  VXACCOUNT(ACCT1) VXGNAME(GROUP1)

XE56  RDBRRN  TSS LIST(RDT) RESCLASS(JOBNAME)

Note: Passwords are printed as question marks (?) and not revealed.

CMD Dest

Indicates the node to which the command was propagated.

ACID

Indicates the ACID issuing the command.

Cmd buffer

Displays the syntax of the command that was issued, in 80 character segments

Count

Indicates both the total number of commands issued to each node and, at the end of the report, the total number of commands issued.