![]() |
![]() |
Use this command to remove a sequential access storage volume from the server inventory for an automated library. This command creates a background process that can be canceled with the CANCEL PROCESS command. To display information on background processes, use the QUERY PROCESS command.
Notes:
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
SCSI Library |
>>-CHECKOut LIBVolume--library_name----volume_name--------------> .-REMove--=--Yes------. .-CHECKLabel--=--Yes-----. >--+---------------------+--+------------------------+----------> '-REMove--=--+-Yes--+-' '-CHECKLabel--=--+-Yes-+-' +-No---+ '-No--' '-Bulk-' .-FORCE--=--No------. >--+-------------------+--------------------------------------->< '-FORCE--=--+-No--+-' '-Yes-' |
Syntax
349X Library |
>>-CHECKOut LIBVolume--library_name----volume_name--------------> .-REMove--=--Yes------. >--+---------------------+------------------------------------->< '-REMove--=--+-Yes--+-' +-No---+ '-Bulk-' |
Parameters
For 349x Libraries:
For SCSI Libraries:
Table 29. How Tivoli Storage Manager Responds to REMOVE=YES or REMOVE=BULK for SCSI Libraries
If a library . . . | Then . . . |
---|---|
Does not have entry/exit ports | TSM leaves the cartridge in its current slot within the library and specifies the slot address in a message. |
Has entry/exit ports and an entry/exit port is available | TSM moves the cartridge to the available entry/exit port and specifies the port address in a message. |
Has entry/exit ports, but no ports are available | TSM leaves the cartridge in its current slot within the library and specifies the slot address in a message. |
This parameter is optional. The default is YES. Possible values are:
This parameter is optional. The default is YES. Possible values are:
Examples
Task
Check out the volume named EXB004 from the library named FOREST. Read the label the verify the volume name, but do not move the volume out of the library.
Related Commands
Table 30. 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. |