Use this command to label tape volumes, or in an automated library, to label the volumes automatically as they are checked in. This command allows the server to use the full-length label with which the volumes are often pre-labeled.
Note: | Use this command only for 349X, SCSI and MANUAL libraries. The LABEL 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 a volume with the DISMOUNT VOLUME command. Once a library drive is available, the LABEL LIBVOLUME command can be reissued. Ensure that a drive is available for the server to process this command. |
Privilege Class
To issue this command, you must have system privilege.
Syntax
>>-LABEl LIBVolume--library_name--volume_name-------------------> >-----+--------------------------+---SEARCH--=--+-Yes-------+---> '-CHECKIN--=--+-SCRatch-+--' | (1) | '-PRIvate-' '-Bulk------' >-----+---------------------------------------------+-----------> '-VOLRange--=----volume_name1,volume_name2----' >-----+-------------------------------------+-------------------> | .-,-------------. | | V | | '-VOLList--=--+----volume_name---+-+--' '-FILE:--file_name---' (2) >-----LABELSource-------=--+-Barcode-+--------------------------> '-Prompt--' .-OVERWRITE--=--No------. >-----+-----------------------+---+-----------------------+---->< '-DEVTYPE--=----3590----' '-OVERWRITE--=--+-No--+-' '-Yes-'
Notes:
Parameters
For SCSI libraries, the server issues a request to have the volume inserted into a cartridge slot within the library, or if available, inserted into the library's entry and exit port. If the cartridge slot is used, it is identified by its element address. See http://www.tivoli.com/support/storage_mgr/tivolimain.html for details on element addresses.
For manual libraries, the server issues a request to have the volume inserted into a drive.
Note: | If the specified volume name is already defined in a storage pool or volume history, the volume will not be labeled and a message will be displayed. |
Possible values are:
If you specify the LABELSOURCE=PROMPT option, the volume is moved from the Entry/Exit ports to the drive. The server prompts you to issue the REPLY command containing the label string, and that label is written to the tape.
If you specify LABELSOURCE=BARCODE, the volume barcode is read, and the tape is moved from the Entry/Exit to a drive where the barcode label is written. After the tape is labelled, it is moved back to the Entry/Exit port or to a storage slot, depending on if the CHECKIN option is specified.
Note: | For barcode support to work properly, the TSM device drivers must be installed for the server-controlled libraries. |
Specifies a range of volume names separated by a comma. Use this parameter to limit the search when you specify SEARCH=YES.
Note: | VOLRange is designed to act as a filter for volumes that need to be checked in or labeled. For SCSI libraries, the VOLRANGE parameter requires that LABELSOURCE=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: | VOLList is designed to act as a filter for volumes that need to be checked in or labeled. For SCSI libraries, the VOLLIST parameter requires that LABELSOURCE=BARCODE is specified. |
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:
Examples
Task 1
Label tapes in a library named AUTO automatically as you are checking the volumes in.
label libvolume auto checkin=scratch search=yes labelsource=barcode overwrite=yes
Task 2
Label 3 volumes from bar11a to bar13a.
label libvolume abc checkin=scratch search=yes volrange=bar11a,bar13a labelsource=barcode
The 3 volumes are labeled: bar11a, bar12a, bar13a.
Related Commands
Table 130. Commands Related to LABEL 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. |
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. |
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. |