Use this command to remove a sequential access storage volume from the server inventory for an automated library.
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--' |
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
Specifies a range of volume names separated by a comma. This parameter only applies to automated cartridge system library software (ACSLS) libraries. Use this parameter to specify multiple volumes to check out.
You can 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 in: bar110, bar111, bar112,...bar129, bar130. |
volrange=bar11a,bar13a | The 3 volumes are checked in: bar11a, bar12a, bar13a. |
volrange=123400,123410 | The 11 volumes are checked in: 123400, 123401, ...123409, 123410. |
Possible values are:
TAPE01 TAPE02 TAPE03
You can specify the volumes for the command as follows: VOLLIST=FILE:TAPEVOL.
For both REMOVE=YES or REMOVE=BULK, the server performs the actions shown
in the table below.
Table 29. How TSM Responds to REMOVE=YES or REMOVE=BULK
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's 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. |
To display valid cartridge access port (CAP) identifiers (x,y,z) in the library, 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.
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. |