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 TSM to use the full length label with which they are often prelabeled.
Note: | Use this command only for 349x, SCSI, and MANUAL libraries. Ensure that a drive is available for TSM to process this command. |
Privilege Class
To issue this command, you must have system privilege.
Syntax
>>-LABEl LIBVolume--library_name--volume_name-------------------> >-----SEARCH--=--+-Yes--+---------------------------------------> '-Bulk-' >-----+---------------------------------------------+-----------> '-VOLRange--=----volume_name1,volume_name2----' >-----LABELSource--=--+-Barcode-+-------------------------------> '-Prompt--' >-----+-------------------------------------+-------------------> | .-,-------------. | | V | | '-VOLList--=--+----volume_name---+-+--' '-FILE:--file_name---' .-OVERWRITE--=--No------. >-----+--------------------------+---+-----------------------+->< '-CHECKIN--=--+-SCRatch-+--' '-OVERWRITE--=--+-No--+-' '-PRIvate-' '-Yes-'
Parameters
For automated libraries, mount the volume in the entry/exit slot of the library. If no entry/exit slot is available, TSM prompts you to mount the volume in an empty slot. For manual libraries, TSM prompts you to load the volume directly 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. |
Do not enter a volume name when SEARCH=YES.
Note: | For barcode support to work properly, the TSM device drivers must be installed for TSM controlled libraries. |
Specifies a range of volume names separated by a comma. Use this parameter to limit the search when you specify SEARCH=YES.
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:
Note: | VOLList is designed to only be a filter of volumes to be checked in or labeled, and it requires that LABELSOURCE=BARCODE. |
TAPE01 TAPE02 TAPE03
You can specify the volumes for the command as follows: VOLLIST=TAPEVOL.
Note: | The file name is case sensitive. |
Examples
Task 1
Label tapes in a library named AUTO automatically as you are checking the volumes in.
label libvolume auto search=yes labelsource=barcode checkin=scratch overwrite=yes
Task 2
Label 3 volumes from bar11a to bar13a.
The 3 volumes are labeled: bar11a, bar12a, bar13a.
Related Commands
Table 135. Commands Related to LABEL LIBVOLUME
Command | Description |
---|---|
AUDIT LIBRARY | Ensures that an automated library is in a consistent state. |
CHECKOUT LIBVOLUME | Checks a storage volume out of an automated library. |
CHECKIN LIBVOLUME | Checks a storage volume into an automated library. |
QUERY LIBRARY | Displays information about one or more libraries. |
QUERY LIBVOLUME | Displays information about a library volume. |
UPDATE LIBVOLUME | Changes the status of a storage volume. |