![]() |
![]() |
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.
Privilege Class
To issue this command, you must have system privilege.
Syntax
Manual Library |
>>-LABEl LIBVolume--library_name------volume_name---------------> .-OVERWRITE--=--No------. >--+-----------------------+----------------------------------->< '-OVERWRITE--=--+-No--+-' '-Yes-' |
Syntax
SCSI Library |
>>-LABEl LIBVolume--library_name--------------------------------> >----+-volume_name------------------------------------------------+----> '-SEARCH--=--+-Yes--+-------+-+--LABELSource--=--+-Barcode-+-' | '-| A |-' | '-Prompt--' '-Bulk-----------' .-OVERWRITE--=--No------. >--+-------------------------+--+-----------------------+------>< '-CHECKIN--=--+-SCRatch-+-' '-OVERWRITE--=--+-No--+-' '-PRIvate-' '-Yes-' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Syntax
349X Library |
>>-LABEl LIBVolume--library_name--------------------------------> >----+-volume_name-------------------+--------------------------> '-SEARCH--=--Yes----+-------+---' '-| A |-' >--+-------------------------+--+------------------+------------> '-CHECKIN--=--+-SCRatch-+-' '-DEVType--=--3590-' '-PRIvate-' .-OVERWRITE--=--No------. >--+-----------------------+----------------------------------->< '-OVERWRITE--=--+-No--+-' '-Yes-' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Syntax
ACSLS Library |
>>-LABEl LIBVolume--library_name--------------------------------> >----+-volume_name-------------------+--------------------------> '-SEARCH--=--Yes----+-------+---' '-| A |-' .-OVERWRITE--=--No------. >--+-------------------------+--+-----------------------+------>< '-CHECKIN--=--+-SCRatch-+-' '-OVERWRITE--=--+-No--+-' '-PRIvate-' '-Yes-' A (SEARCH=Yes) |--+-VOLRange--=----volume_name1,volume_name2---+---------------| | .-,-----------. | | V | | '-VOLList--=--+---volume_name-+--+-----------' '-FILE:--file_name-' |
Parameters
Possible values are:
If you specify the LABELSOURCE=PROMPT option, the volume is moved into the drive from its location in the library or entry/exit ports. 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 bar code is read, and the tape is moved from its location in the library or in the entry/exit ports to a drive where the bar-code label is written. After the tape is labeled, it is moved back to its location in the library, to the entry/exit ports, or to a storage slot if the CHECKIN option is specified. For bar-code support to work correctly for libraries supported by Tivoli Storage Manager, the Tivoli Storage Manager server, and the device driver must be at the same level. Bar-code support is available for libraries supported by Tivoli Storage Manager and which use the Tivoli Storage Manager device driver or the RMSS Magstar(R) or LTO Ultrium device driver.
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 labeled: bar110, bar111, bar112 ,...bar129, bar130. |
volrange=bar11a,bar13a | The 3 volumes are labeled: bar11a, bar12a, bar13a. |
volrange=123400,123410 | The 11 volumes are labeled: 123400, 123401, ...123409, 123410. |
Possible values are:
TAPE01 TAPE02 TAPE03
You can specify the volumes for the command as follows: vollist=FILE:TAPEVOL.
Possible values are:
Examples
Task
Label tapes in a SCSI library named AUTO automatically as you are checking the volumes in.
label libvolume auto checkin=scratch search=yes labelsource=barcode overwrite=yes
Task
Label 3 volumes from bar11a to bar13a in a SCSI library named ABC..
label libvolume abc checkin=scratch search=yes volrange=bar11a,bar13a labelsource=barcode
The 3 volumes are labeled: bar11a, bar12a, bar13a.
Related Commands
Table 149. 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. |