Volume not in library installation exit (CBRUXVNL) return codes for job step processing

The following return codes can be passed back to OAM from CBRUXVNL for job step setup processing:

Code

Meaning

0

Perform normal processing.

The system allocates a stand-alone tape drive capable of handling the requested volume. If the required device type is not installed, the job or dynamic allocation fails.

4

Retry the failing operation.

Locate the requested tape volume, using the tape management system inventory or other sources, and enter it into any tape library connected to the system on which the requesting job is running.

The system rereads the tape volume record for the specified tape volume. If the tape volume record exists in the TCDB and the record indicates that the volume is library-resident, the system proceeds with normal library-resident tape volume processing. If the tape volume record exists but indicates that the tape volume is still shelf-resident, the CBR3646D message is issued to allow the operator to retry or cancel the job request.

Note: CBRUXVNL is mostly used for old data sets, but new data sets can specify a specific volume serial number. When this occurs and the volume is entered into a tape library at the direction of CBRUXVNL, the library name is subsequently made available to the ACS routines. The ACS routines must assign a storage class and a tape storage group to the request; otherwise, the request fails.

8

Cancel.

The job step or dynamic allocation is canceled.

16

Do not call the exit again.

CBRUXVNL is not invoked again until reactivated. The system allocates a stand-alone tape drive. If there is no stand-alone tape drive capable of handling the tape volume request, the job or dynamic allocation fails.