Use this command to add a sequential access storage volume or a cleaning tape to the server inventory for an available, automated library. This command informs the server that a volume is available for use. The server does not use a volume that physically resides in an automated library until the volume has been checked in via this command.
Note: | The CHECKIN 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 must be made available by dismounting the drive with the DISMOUNT VOLUME command. Once a library drive is available, the CHECKIN LIBVOLUME command can be reissued. |
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.
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
>>-CHECKIn LIBVolume--library_name--volume_name-----------------> >-----STATus--=--+-PRIvate------+-------------------------------> +-SCRatch------+ | (1) | '-CLEaner------' .-SEARCH--=--No------------. >-----+--------------------------+------------------------------> '-SEARCH--=--+-No--------+-' +-Yes-------+ | (2) | '-Bulk------' >-----+---------------------------------------------+-----------> '-VOLRange--=----volume_name1,volume_name2----' >-----+-------------------------------------+-------------------> | .-,-------------. | | V | | '-VOLList--=--+----volume_name---+-+--' '-FILE:--file_name---' .-CHECKLabel--=--Yes--------------. >-----+---------------------------------+-----------------------> '-CHECKLabel--=--+-Yes----------+-' +-No-----------+ | (3) | '-Barcode------' .-SWAP--=--No------. >-----+----------------------+---+------------------+-----------> '-DEVType--=----3590---' '-SWAP--=--+-No--+-' '-Yes-' .-MOUNTWait--=--60-----. >-----+----------------------+---+---------------------------+->< '-MOUNTWait--=--value--' '-CLEanings--=----number----'
Notes:
Parameters
Note: | CHECKLABEL=YES is invalid for checking in a cleaner. A cleaner cartridge must be checked in separately from a data cartridge by using STATUS=CLEANER. |
Possible values are:
Notes:
Note: | Do not specify both CHECKLABEL=NO and SEARCH=BULK. |
Specifies a range of volume names separated by a comma. Use this parameter to limit the search when you specify SEARCH=YES.
Note: | This only applies to 349X, ACSLS and SCSI libraries. VOLList is designed to filter only the volumes to be checked in or labeled. For SCSI libraries, this parameter requires that CHECKLabel=BARCODE. |
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. |
Note: | This applies to 349X, ACSLS and SCSI libraries. VOLList is designed to filter only the volumes to be checked in or labeled. For SCSI libraries, this parameter requires that CHECKLabel=BARCODE. |
TAPE01 TAPE02 TAPE03
You can specify the volumes for the command as follows: VOLLIST=FILE:TAPEVOL.
Note: | The file name is case-sensitive. |
Possible values are:
Note: | For SCSI libraries, do not specify both SEARCH=YES and CHECKLABEL=NO in the same command. |
This parameter applies only to SCSI libraries. To use this option, you must specify SEARCH=YES.
If the barcode reader is unable to read a given barcode label, or if a tape does not have a barcode label, the check-in command will load that tape in a drive to read the internal label.
This parameter only applies if there is a volume name specified in the command. Possible values are:
Note: | The volume selected for the swap operation (target swap volume) is ejected from the library and replaced with the volume being checked in. The server identifies a target swap volume by checking for an available scratch volume. If none exist, the server identifies the least frequently mounted volume. |
Note: | If more than one cleaner is checked into the library, only one will be used until its CLEANINGS value decreases to zero. Another cleaner will then be selected, and the first cleaner can be checked out and discarded. |
Examples
Task 1
Check in the volume named WPDV00 into the library named AUTO.
checkin libvolume auto wpdv00 status=scratch
Task 2
Scan the library for all unused volumes and put them in scratch status.
checkin libvolume abc search=yes status=scratch
Task 3
Use the barcode reader to scan a library, MYLIB, for VOL1 and put it in scratch status.
checkin libvolume mylib vol1 search=yes status=scratch checkl=b
Related Commands
Table 27. Commands Related to CHECKIN LIBVOLUME
Command | Description |
---|---|
AUDIT LIBRARY | Ensures that an automated library is in a consistent state. |
CANCEL PROCESS | Cancels a background server process. |
CHECKOUT LIBVOLUME | Checks a storage volume out of 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. |
DISMOUNT VOLUME | Dismounts a sequential, removable volume by the volume name. |
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. |