Previous Topic

Next Topic

Book Contents

Book Index

Tape Pull List Parameters

There are two ways of setting parameters for the utility.

Parameters can be passed to the Tape Pull List utility using the TAPULPRM member in the Control-M PARM library. This member is referenced by the TAPULIN DD statement in the Tape Pull List procedure, CTMTAPUL, if it is specified in option M3 (Prepare Simulation/Tape Pull List Job) of the Online Utilities.

Alternatively, parameters may be passed to the utility in-line, using the TAPULIN DD statement.

Table 272 CTMTAPUL Subparameters

Subparameter

Description

REPBYVOL

Produce a report sorted by volume serial number (volser). All tapes from the tape library are included.

REPBYTIME

Produce a report sorted by the expected mount time.

REPBYJOB

Produce a report sorted by job name.

REPBYDSN

Produce a report sorted by data set name.

JCLFILE {YES|NO|ONLY}

Whether a copy of every submitted job is written to the file referenced by the DAJCLOUT DD statement.

Valid values are:

  • YES – A copy of every submitted job is written to the file referenced by the DAJCLOUT DD statement.
  • NO – A copy of every submitted job is not written to the file referenced by the DAJCLOUT DD statement. Default.
  • ONLY – A copy of every submitted job is written to the file referenced by the DAJCLOUT DD statement, but

    — the procedure does not submit the job

    — the Tape Pull reports are not created

    — the procedure is run to create the JCL file only

Note: When dealing with submitted jobs, the utility, for internal processing purposes, inserts the following accounting code into the jobcard of the job:

CTM-FORCE-TPLNM

When operating under JES3, the following statement is also inserted:

//*NET ID=AESUSER

IGNORE DSN dsn

Data set name (or prefix) that must not appear in the report. If the last character of dsn is *, it is treated as a prefix.

IGNORE JOB jobname

Job name (or prefix) that must not appear in the report. If the last character of jobname is *, it is treated as a prefix.

The Tape Pull List job can be prepared using the (ISPF) Simulation panel (Option M3 in the IOA Online Utilities menu). A special section of the panel is designated for Tape Pull List parameters. If you want to run the Tape Pull List procedure

  1. Type Y in the TAPE PULL LIST field.
  2. Type Y in the field next to the desired type of report.

The default control parameters member name appears on the screen. This member contains IGNORE statements (procedure parameters). JOB/SCAN and PRO/JCL parameters are discussed in JOB/SCAN, PRO/JCL, DOCU/TEXT Interface.

After filling in the parameters, enter the edited JCL of a job to run the simulation and the procedure. You can submit it, or save it for future use.

Parent Topic

The CTMTAPUL Tape Pull List Procedure