Use the MVS LIBRARY EJECT command to eject a specific tape volume from a tape library. When this command is issued for an ATLDS, the tape volume is placed into an output station of the tape library. For an MTL, no physical movement takes place as a result of this command.

The syntax of the command to eject a specific tape volume is:

>>-+-LIBRARY-+--+-EJECT-+--,volser--+----------------+---------->
   '-LI------'  '-E-----'           '-,-+-PURGE----+-'   
                                        +-P--------+     
                                        +-KEEP-----+     
                                        +-K--------+     
                                        +-LOCATION-+     
                                        '-L--------'     

>--+------------+----------------------------------------------><
   '-,-+-BULK-+-'   
       '-B----'     

EJECT | E

Specifies a request to eject a specific tape volume from a tape library.

volser

Specifies the volume serial number of the tape volume that is ejected from the tape library.

{PURGE | P | KEEP | K | LOCATION | L}

Specifies the disposition of the volume record in the TCDB when a tape cartridge is ejected from the library. If neither PURGE nor KEEP is specified, then the disposition of the volume record in the TCDB is determined by the eject default that is entered on the ISMF Tape Library Define panel.

PURGE | P

Specifies that the volume record in the TCDB be deleted upon completion of the EJECT operation.

KEEP | K

Specifies that the volume record in the TCDB be retained upon completion of the EJECT operation.

LOCATION | L

Specifies that you want to update the shelf location associated with the tape volume. When LOCATION is specified, a write-to-operator-with-replay (WTOR) message is issued to the MVS operator prompting for 32 characters of shelf location information. The entered information is recorded in the shelf location field in the volume record in the TCDB. Specifying the LOCATION keyword implies that the volume record be retained upon completion of the EJECT operation.

{BULK | B}

Specifies that the tape volume be placed in the high-capacity or "bulk" output station of the tape library. If neither BULK nor B is specified, the tape volume is placed in the convenience output station. If the high-capacity output station is not configured, the cartridge is ejected to the convenience station. If a convenience station is not installed in a 3494, the cartridge is placed in the single cell output area. (This parameter is ignored for volumes ejected from a MTL.)

To eject a tape cartridge from a tape library, enter the following command:

     LIBRARY EJECT,TAP003