Parameter descriptions

TYPE=TAPE

Specifies a request related to the TCDB.

FUNC=EJECT

Specifies a request to eject or query the eject status of a tape volume from a tape library.

VOLUME=volume-serial-number

Specifies the name of a character variable (six-byte length) that contains the volume serial number of the volume to be ejected. The volume serial number must be left justified in the field and padded on the right with blanks.

EJECTOPT=KEEP

Specifies that the TCDB record for the tape volume being ejected should not be deleted after the eject completes successfully.

EJECTOPT=PURGE

Specifies that the TCDB record for the tape volume being ejected should be deleted after the eject completes successfully.

If the EJECTOPT parameter is specified on the macro invocation, the cartridge eject installation exit may override it.

If the EJECTOPT parameter value is not specified on the macro invocation, the eject default is used. (This default is established when the library is defined by the storage administrator using the ISMF library define panel.) However, the cartridge eject installation exit (CBRUXEJC) may ultimately override the value.

EJECTOPT=QUERY

Specifies a request to query the OAM internal work queues to determine if an eject request is pending. CBRXLCS FUNC=QVR should be invoked first to determine if an eject request is pending at the library or if the eject request has completed. If the status of the eject request from the QVR function cannot be determined, you can use this option to determine if the eject request resides on an OAM internal queue but might not have been sent to the library yet.

BULKEJCT=YES

Specifies that the ejected cartridge be placed in the high-capacity output station of an ATLDS. If this parameter is not specified or the high-capacity output station is not configured, the cartridge is placed in the convenience output station. If a convenience station is not installed in a 3494, the cartridge is placed in the single cell output area.

BULKEJCT=NO

Specifies that the cartridge be placed in the convenience output station of an ATLDS. This is the default.

Note: For a manual tape library, BULKEJCT is ignored.

EXITINFO=installation-exit-information

Specifies the name of a character variable (16-byte length) that contains a customer specified free-form value that is passed to the cartridge eject installation exit (CBRUXEJC).

USERID=userid

Specifies the name of a character variable (8-byte length) that contains a TSO user ID. The field must be left-justified and padded on the right with blanks.

After the eject request is successfully scheduled (a zero return and reason code from the CBRXLCS macro invocation), eject completion or failure messages are sent to this user ID through the system services SEND interface.