Utilities › TMSLBLPR Utility—Process External Tape Labels › Report Description › Job Control Statements

Job Control Statements

If TMSLBLPR is to be started as a system task, the following JCL should be added to SYS1.PROCLIB or to the executable procedure library of your choice.

//TMSLBLPR EXEC PGM=TMSLBLPR,
//             TIME=1440,PARM=',parm'
//STEPLIB  DD  DSN=CAI.CTAPLINK,DISP=SHR
//AUDIT    DD  DSN=CAI.CA1.AUDIT,DISP=SHR

Parameter Definitions

Each of the following parameters is optional and may be specified only once.

START={WARM|COLD}

'START=WARM' begins generating labels from the point where TMSLBLPR ceased during the last execution. TMSLBLPR uses the Audit data set as input. Control is based on the STOPPING POINT OF LAST EXECUTION OF TMSLBLPR data in the Audit header record.

The first external tape label generated is for the first output tape created after TMSLBLPR stopped. If the stopping point is zeros, as it is for users already under CA 1 control who have not previously executed TMSLBLPR, then PARM='START=COLD' should be used. Reformatting the Audit data set will reset the stopping point to one. 'START=WARM' is the default.

When 'START=COLD' is used, control is based on the NEXT AVAILABLE AUDIT RECORD TO BE WRITTEN in the Audit header record. The first external tape label generated is for the next output tape to be created.

WAIT={30|nnn}

Indicates a delay time period before TMSLBLPR begins. The default is 30 seconds. The value of nnn is time expressed in seconds and must be numeric. The length can be from 1 to 3 bytes. The value cannot be less than 5 or greater than 999.

EXIT={TMSXITL|modulename}

Is the module name of a user exit routine which may be used to select, reject, or modify the fields that are used to generate the label request. If no user exit module name is specified, TMSXITL is the standard default. If a user exit other than TMSXITL is used, the module must reside in either the STEPLIB or a link listed data set. An example of the user exit routine may be found in the CA 1 source library under the member name TMSXITL and is discussed in detail in the Programming Guide.

The following are sample parameters for this program:

PARM='WAIT=25'

PARM='START=WARM'

PARM='WAIT=67,START=COLD'