TYPERUN

Used to specify both the parameters that affect the general functioning of the utility, and the execution mode of the utility. Mandatory.

Only one TYPERUN statement can be specified for each run of this utility.

Valid subparameters are:

• MODE — Mode in which the utility runs. Mandatory. Valid values:

  - NORMAL — SMF records are read and the Media database is updated according to the tape activity recorded in the SMF records. Default.The utility produces a report that lists the tape activity extracted from SMF records.

  - SIMULATION — SMF records are read but the Media database is not updated. The utility produces a report of tape activity from SMF records without updating the Media database.

• DYNVOL — Instructions for handling volumes that were accessed but do not exist in the Media database. Optional.

  - Y — Create a volume record for each of these volumes automatically. This value is not valid if DYNDS is set to N (see below). Default.

  - N — Do not create a volume record for the volume. Information about data sets on the volume and the volume chain to which it belongs is not recorded in the Control-M/Tape Media database.

• DYNDS — Instructions for handling data sets that were accessed for Read or Update but are not defined in the Media database. This parameter is ignored if CREATE is specified for parameter ACCTYPE (described below). Optional.

  - Y — Create a data set record for each of these data sets and insert the appropriate information. Default.

  - N — Do not create data set records for these data sets (meaning, do not record tape activity for these data sets).

• ACCTYPE — Types of tape activity to be processed during this run of the utility. Optional.

  - CREATE — Process only SMF records that describe creation of new data sets.

  - UPDATE — Process only SMF records that describe an update of a tape data set (including creation of new data sets).

  - ALL — Process all SMF records of tape activity that were stored in the sequential files specified as input to the utility. Default.

TYPERUN (cont)

• SYNCHLVL — Instructions for handling conflicts (for example, when an SMF record indicates creation of a data set that overwrites an existing data set) between the Media database and the SMF records. Optional.

  - MATCH — If a conflict occurs, the conflict is described in the utility report. The Media database is not updated with the conflicting information. Default.

  - FORCE — If a conflict occurs, the Media database is modified to reflect the changes described in the SMF record.

• X98000 — Instructions for handling data sets for which LABEL=EXPDT=98000 was specified. Optional.

  - SKIP — Do not process data sets specified with LABEL=EXPDT=98000. Default.

  - UPDATE — Process all data sets regardless of their EXPDT specification.

INCLUDE / EXCLUDE

SMF records are in sequential files referenced by DD statement DASMFIN. These records can be filtered by one or more INCLUDE / EXCLUDE statements.

The INCLUDE / EXCLUDE statements can reference the following fields:

• BLOCKCT
• BLKSIZE
• CPUID
• CREDT
• DDNAME
• DSEXCP
• DSLABEL
• DSNAME
• DSOPNTIM
• DSVOLSER
• JCLEXPDT
• JOBNAME
• JSTRTDAT

INCLUDE / EXCLUDE (cont)

The CTTRSM utility reads SMF records that describe tape access.

• JSTRTTIM
• LBLTYP
• LRECL
• RECFM
• RFORMAT
• TRTCH
• UNITADR
• USERID
• VOLSER

For more detailed information on these fields, see the INCONTROL for z/OS Administrator Guide.

Note: For more information about INCLUDE / EXCLUDE statements, see Record Selection Logic (INCLUDE / EXCLUDE Statements) (CTM). Optional.

REPORT

Indicates the report to be created by the utility. Mandatory.

The following parameter must be specified:

NAME=SMFRCV

An SMF recovery report is produced by the utility, listing all data sets whose access (or creation) is described in the SMF records processed by the utility. The fields in this report are determined by the FIELDS statement (described below).

FIELDS

Indicates which fields to include in the report that the utility creates. You can include the following fields:

• ACCTYPE
• BLOCKCT
• BLKSIZE
• CPUID
• CREDT
• DDNAME
• DSEXCP
• DSLABEL
• DSNAME
• DSOPNTIM
• DSVOLSER
• JCLEXPDT
• JOBNAME
• JSTRTDAT
• JSTRTTIM
• LBLTYP
• LRECL
• RECFM
• RFORMAT
• TRTCH
• UNITADR
• USERID
• VOLSER

For more detailed information on these fields, see the INCONTROL for z/OS Administrator Guide.

In addition to the fields above, you can include the following special field:

• STATUS–Indicates the action performed on the data set record by the CTTRSM utility. This field is empty if the data set was processed successfully. Otherwise, this field contains a rejection reason that explains why the data set was not processed.

SORTBY

Order in which the report is sorted. Optional. Valid sort fields are all data set record and volume record fields, described in the appendix that discusses logical field names for the Control-M/Tape Repository in the INCONTROL for z/OS Administrator Guide.

ATTR

Override of default attributes defined for a field in the report. Optional.

BREAK

Attributes of the summary header lines printed when a field break occurs. Optional.

Note: For a description of the parameters for these statements, see the FIELDS, SORTBY, ATTR and BREAK statements in CTTRPT – Database extraction and report utility.