Previous Topic: TSSCHART Sample ExecutionsNext Topic: Using CA Earl


TSSCPR Utility

This section contains the following topics:

About the TSSCPR Utility

Authority and Scope

JCL Requirements

About the TSSCPR Utility

The TSSCPR utility is a batch utility that gives the user the ability to produce customized reports extracted from the CPF Recovery File.

Authority and Scope

All scope and administrative authority restrictions are honored by this utility, thereby preventing unauthorized access to the CPF Recovery File.

TSSCPR can only be issued by the MSCA or by an SCA, otherwise the following message is issued:

TSS8081E MUST BE MSCA OR SCA

To execute the TSSCPR utility, an SCA must have or be given the following administrative access:

TSS ADMIN(acid) ACID(REPORT) RESOURCE(REPORT) DATA(authority level(s))

JCL Requirements

To execute TSSCPR, use the following JCL

//TSSCPR                 JOB
//XTRACT                 EXEC    PGM=TSSCPR
//CPFOUT                 DD      DSN=dsname,UNIT=????,VOL=SER=????????
//                       DISP=(,CATLG,DELETE),SPACE=(TRK,(15,15),RLSE),
//                       DCB=(RECFM=FB,LRECL=4500,BLKSIZE=22500)
//CPFFILE                DD      DSN=cpf.recovery.file.name, DISP=SHR

The following is a description of the DD statements used with TSSCPR:

DD Statement

Description

CPFOUT

Contains formatted records of information extracted from the CPF Recovery File.

CPFFILE

Contains the CPF Recovery File.

The following DCB defaults are used with TSSCPR:

DD Statement

Description

DDNAME

DCB Defaults

CPFOUT

DSORG=PS, LRECL=4500, BLKSIZE=22500, RECFM=FB

The record layout for TSSCPR is as follows:

Field Position

Description

1 to 8

Internal Flags

9 to 16

Command Destination

17 to 20

Internal Flags

21 to 24

Record ID 'TCPL'

25 to 43

Internal Control Fields

44 to 51

ACID name

52 to 148

Internal Control Fields

149 to 158

Date of Command

159 to 404

Internal Control Fields

405 to 406

Command Length

407 to 408

Internal Flags

409 to 844

Command Buffer

Only the Command Destination, ACID Name and Command Buffer fields can be displayed.

For information on using the TSSREPORT3 facility to produce an CA‑Earl® report from TSSCPR output, see the chapter “Using CA‑EARL”