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-------+----> +-| A |-------------+ '-| B |-------------' .-REMove--=--Yes-----------. .-CHECKLabel--=--Yes-----. >-----+--------------------------+---+------------------------+-> '-REMove--=--+-Yes-------+-' '-CHECKLabel--=--+-Yes-+-' +-No--------+ '-No--' | (2) | '-Bulk------' .-FORCE--=--No------. >-----+-------------------+---+-------------------------+------>< '-FORCE--=--+-No--+-' | (3) | '-Yes-' '-CAP--=---------x,y,z----' A |---+--------------------------------------------------+--------> | (4) | '-VOLRange--=---------volume_name1,volume_name2----' >-----+--------------------------+------------------------------| | .-,-------------. | | V | | '--+----volume_name---+-+--' '-FILE:--file_name---' B |---+------------------------------------------+----------------| | .-,-------------. | | (5) V | | '-VOLList--=-------+----volume_name---+-+--' '-FILE:--file_name---'
Notes:
Parameters
Specifies a range of volume names separated by a comma. This parameter only applies to 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.
Note: | The file name is case-sensitive. |
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. |
To display valid CAP identifiers (x,y,z) in the library, issue the QUERY CAP command with ALL specified from the 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 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. |