Use this command to remove a sequential access storage volume from the TSM 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
>>-CHECKOut LIBVolume--library_name--volume_name----------------> .-CHECKLabel--=--Yes-----. .-FORCE--=--No------. >-----+------------------------+---+-------------------+--------> '-CHECKLabel--=--+-Yes-+-' '-FORCE--=--+-No--+-' '-No--' '-Yes-' .-REMove--=--Yes------. >-----+---------------------+---------------------------------->< '-REMove--=--+-Yes--+-' +-No---+ '-Bulk-'
Parameters
Note: | The only difference between REMOVE=YES and REMOVE=BULK is that REMOVE=YES prompts the user to remove the cartridge and issue the REPLY command. REMOVE=BULK does neither. |
Note: | TSM 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 29. 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. |
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. |