Use this command to remove a sequential access storage volume from the server inventory for an automated library.
Note: | The CHECKOUT LIBVOLUME command processing will not wait for a drive to become available, even if the drive is only in the IDLE state. If necessary, a library drive may be made available by dismounting the drive with the DISMOUNT VOLUME command. After a library is available, the CHECKOUT LIBVOLUME command can be reissued. |
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
(1) >>-CHECKOut LIBVolume--library_name------volume_name------------> .-REMove--=--Yes-----------. .-CHECKLabel--=--Yes-----. >-----+--------------------------+---+------------------------+-> '-REMove--=--+-Yes-------+-' '-CHECKLabel--=--+-Yes-+-' +-No--------+ '-No--' | (2) | '-Bulk------' .-FORCE--=--No------. >-----+-------------------+------------------------------------>< '-FORCE--=--+-No--+-' '-Yes-'
Notes:
Parameters
Note: | There is a difference between the REMOVE=YES and REMOVE=BULK options. REMOVE=YES prompts the user to remove the cartridge and issue the REPLY command. REMOVE=BULK informs the user to remove the cartridge from a specific slot. |
Note: | The server issues a message stating that the tape volume should be removed from the Entry/Exit port. |
Examples
Task
Check out the volume named EXB004 from the library named FOREST.
Related Commands
Table 28. Commands Related to CHECKOUT LIBVOLUME
Command | Description |
---|---|
AUDIT LIBRARY | Ensures that an automated library is in a consistent state. |
CANCEL PROCESS | Cancels a background server process. |
CHECKIN LIBVOLUME | Checks a storage volume into an automated library. |
DEFINE LIBRARY | Defines an automated or manual library. |
DEFINE VOLUME | Assigns a volume to be used for storage within a specified storage pool. |
LABEL LIBVOLUME | Labels a library volume. |
QUERY LIBRARY | Displays information about one or more libraries. |
QUERY LIBVOLUME | Displays information about a library volume. |
QUERY PROCESS | Displays information about background processes. |
UPDATE LIBVOLUME | Changes the status of a storage volume. |