![]() |
![]() |
Use this command to add a sequential access storage volume or a cleaning tape to the server inventory for an automated library (other than an automated external library). The server cannot use a volume that physically resides in an automated library until that volume has been checked in.
This command creates a background process that you can cancel 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
SCSI Libraries |
>>-CHECKIn LIBVolume--library_name------------------------------> .-SEARCH--=--No-. >----+-volume_name--+---------------+-+-------------------------> +-SEARCH--=--Yes--+-------+------+ | '-| A |-' | '-SEARCH--=----Bulk--------------' .-OWNer--=--""----------. >--STATus--=--+-PRIvate-+--+-----------------------+------------> +-SCRatch-+ '-OWNer--=--server_name-' '-CLEaner-' .-CHECKLabel--=--Yes---------. .-SWAP--=--No------. >--+----------------------------+--+------------------+---------> '-CHECKLabel--=--+-Yes-----+-' '-SWAP--=--+-No--+-' +-No------+ '-Yes-' '-Barcode-' .-MOUNTWait--=--60----. >--+---------------------+--+--------------------------+------->< '-MOUNTWait--=--value-' '-CLEanings--=----number---' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Syntax
349X Libraries |
>>-CHECKIn LIBVolume--library_name------------------------------> .-SEARCH--=--No-. >----+-volume_name--+---------------+-+-------------------------> '-SEARCH--=--Yes--+-------+------' '-| A |-' .-OWNer--=--""----------. >--STATus--=--+-PRIvate-+--+-----------------------+------------> '-SCRatch-' '-OWNer--=--server_name-' .-CHECKLabel--=--Yes-----. >--+------------------------+--+------------------+-------------> '-CHECKLabel--=--+-Yes-+-' '-DEVType--=--3590-' '-No--' .-SWAP--=--No------. .-MOUNTWait--=--60----. >--+------------------+--+---------------------+--------------->< '-SWAP--=--+-No--+-' '-MOUNTWait--=--value-' '-Yes-' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Syntax
ACSLS Libraries |
>>-CHECKIn LIBVolume--library_name------------------------------> .-SEARCH--=--No-. >----+-volume_name--+---------------+-+-------------------------> '-SEARCH--=--Yes--+-------+------' '-| A |-' .-OWNer--=--""----------. >--STATus--=--+-PRIvate-+--+-----------------------+------------> '-SCRatch-' '-OWNer--=--server_name-' .-CHECKLabel--=--Yes-----. .-SWAP--=--No------. >--+------------------------+--+------------------+-------------> '-CHECKLabel--=--+-Yes-+-' '-SWAP--=--+-No--+-' '-No--' '-Yes-' .-MOUNTWait--=--60----. >--+---------------------+------------------------------------->< '-MOUNTWait--=--value-' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Parameters
Possible values are:
For SCSI libraries: The server issues a request to have the volume inserted into a cartridge slot in the library or, if available, into an entry port. The cartridge slot or entry port is identified by its element address. See http://www.tivoli.com/support/storage_mgr/tivolimain.html for details on element addresses.
For 349X libraries: The volume could already be in the library, or you could put it into the I/O station when prompted.
Notes:
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. |
TAPE01 TAPE02 TAPE03
You can specify the volumes for the command as follows: VOLLIST=FILE:TAPEVOL.
Possible values are:
If the barcode reader cannot read the barcode label, or if the tape does not have a barcode label, the server mounts the tape and reads the internal label.
This parameter is optional. The default is NO. This parameter only applies if there is a volume name specified in the command. Possible values are:
Examples
Task
Check in a volume named WPDV00 into the SCSI library named AUTO.
checkin libvolume auto wpdv00 status=scratch
Task
Scan a SCSI library named AUTOLIB1 and, using the barcode reader, look for cleaner cartridge CLNV. Use SEARCH=YES, but limit the search by using the VOLLIST parameter.
checkin libvolume autolib1 search=yes vollist=cleanv status=cleaner cleanings=10 checklabel=barcode
Task
Scan a 349X library named ABC, and limit the search to a range of unused volumes bar110 to bar130 and put them in scratch status.
checkin libvolume abc search=yes volrange=bar110,bar130 status=scratch
Task
Use the barcode reader to scan a SCSI library named MYLIB for VOL1, and put it in scratch status.
checkin libvolume mylib search=yes vollist=vol1 status=scratch checklabel=barcode
Related Commands
Table 28. 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 volumes in manual or automated libraries. |
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. |