LAB Commands

Commands are sent to LAB using the CTS Message command (MSG). The following format should be used on all commands issued to the LAB subtask:

MSG LAB,xxxxxxxxxx

Where xxxxxxxxxx is the LAB command and must contain one of the following values:

STOP

to terminate label processing in a normal fashion

CANCEL

to cancel LAB including label processing with a User-111 Abend

STATUS

to request a current label processing status

VOLUME xxxxxx

to send a VOLUME request through the CA Common Services for z/OS Services CAICCI to the label processor.

SPINOFF |xxxxxxxx

to send a SPINOFF request through CA Common Services for z/OS Services CAICCI to the label processor.

The STOP command issues a CLOSE request to the label processor which terminates the process in a normal fashion. Once termination is complete, the LAB subtask ends.

The STATUS command issues a request that provides two messages indicating the time and date the label processor started along with accumulated totals of VOLUME, DATA, LABEL and SPINOFF CAICCI requests that have been received. Additionally, an error count associated with VOLUME requests is provided.

The VOLUME command directs a request for a specific volume serial number to be processed. This command requires a parameter containing the volume serial number associated with the request. For this reason, the command and parameter entered must be separated by a blank and enclosed within single quotes or parentheses, for example, 'VOLUME 980010'.

The SPINOFF command can be entered with or without a parameter.

If the SPINOFF command is entered without a parameter, the label processor closes, reallocates, and reopens ALL printer files that were originally dynamically allocated as a SYSOUT file, thus freeing the current SYSOUT to be printed.

If the SPINOFF command is entered with a parameter, the parameter must be either PRINTER1, PRINTER2 or PRINTER3 indicating the specific printer to which the request applies. Additionally, only the printer specified is closed, reallocated and reopen, freeing the current SYSOUT to be printed. In this case, the command and parameter entered must be separated by a blank and enclosed within single quotes or parentheses, for example, 'SPINOFF PRINTER1'.