![]() |
![]() |
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-' |
Syntax
ACSLS Library |
>>-CHECKOut LIBVolume--library_name----+-volume_name-+----------> '-| A |-------' .-REMove--=--Yes-----. .-CHECKLabel--=--Yes-----. >--+--------------------+--+------------------------+-----------> '-REMove--=--+-Yes-+-' '-CHECKLabel--=--+-Yes-+-' '-No--' '-No--' .-FORCE--=--No------. >--+-------------------+--+-------------------+---------------->< '-FORCE--=--+-No--+-' '-CAP--=----x,y,z---' '-Yes-' A |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Parameters
Specify only volume names that can be numerically incremented. In
addition to the incremental area, a volume name can include an alphanumeric
prefix and an alphanumeric suffix, for example:
Parameter | Description |
---|---|
volrange=bar110,bar130 | The 21 volumes are checked out: bar110, bar111, bar112,...bar129, bar130. |
volrange=bar11a,bar13a | The 3 volumes are checked out: bar11a, bar12a, bar13a. |
volrange=123400,123410 | The 11 volumes are checked out: 123400, 123401, ...123409, 123410. |
Possible values are:
TAPE01 TAPE02 TAPE03
You can specify the volumes for the command as follows: VOLLIST=FILE:TAPEVOL.
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:
To display valid CAP identifiers (x,y,z), issue the QUERY CAP command with ALL specified from the automated cartridge system system administrator (ACSSA) console on the ACSLS server host. The default value is (-1,-1,-1), in which case the ACSLS server will choose any available CAP with a non-zero priority. This parameter is optional. With CAP=x,y,z specified, each identifier corresponds to:
Refer to your Storage Tek documentation for more information.
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. |