Tivoli Storage Manager for HP-UX Administrator's Reference

LABEL LIBVOLUME (Label a Library Volume)

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:

  1. This parameter applies only to SCSI libraries.

  2. This parameter applies only to SCSI libraries.

Parameters

library_name (Required)
Specifies the name of the library that contains the storage volume.

volume_name
Specifies a volume to label.

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.

CHECKIN
Specifies whether the server checks in the volume. This parameter is optional. The following are possible values:

SCRatch
Specifies that the server checks in the volumes and adds them to the library's scratch pool.

PRIvate
Specifies that the server checks in the volumes and designates them as private. Private volumes are available only when you request them by name.

SEARCH
Specifies that the server searches the library for usable volumes to label.

Possible values are:

Yes
Specifies that the server labels each volume, unless the volume is already labeled or its barcode cannot be read. Use the VOLRange or VOLList parameter to limit the search. Do not enter a volume name with this search.

Bulk
Specifies that the server searches the library Entry/Exit ports for usable volumes to label. This parameter only applies to SCSI libraries.

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.

VOLRange

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.

VOLList
Specifies the list of volumes to be processed for the command. Use this parameter to limit the search when you specify SEARCH=YES. Possible values are:

volume_name
Specifies the names of one or more values that are used for the command. Example: VOLLIST=TAPE01,TAPE02.
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.

FILE:file_name
Specifies the name of a file that contains a list of volumes for the command. In the file, each volume name must be on a separate line. Blank lines and comment lines that begin with an asterisk are ignored. For example, to use volume TAPE01, TAPE02 and TAPE03, create a file, TAPEVOL, that contains these lines:
TAPE01
TAPE02
TAPE03

You can specify the volumes for the command as follows: vollist=FILE:TAPEVOL.

Note:The file name is case-sensitive.

LABELSource
Specifies how or whether the server reads sequential media labels of volumes. This option is only valid for SCSI libraries. Specify this parameter only when SEARCH=YES or SEARCH=BULK.

Possible values are:

Prompt
Prompts for volume names as necessary.

Barcode
The server attempts to read the barcode label. If the attempt fails, the server will not label the volume and will display a message.

DEVType
Specifies the device type for the volume being checked in. This parameter applies to 349X libraries containing 3590 devices. Possible values are:

3590
Specifies that the volume being checked in is for a 3590 device type.

OVERWRITE
Specifies whether the server attempts to overwrite existing labels. This parameter is optional. The default is NO. Possible values are:

No
Specifies that the server only labels unlabeled volumes.

Yes
Specifies that the server overwrites existing labels only if both the existing label and the prompted/barcode label are not already defined in any the server storage pool or volume history list.

Examples

Task 1

Label tapes in a library named AUTO automatically as you are checking the volumes in.

Command:
label libvolume auto checkin=scratch search=yes 
labelsource=barcode overwrite=yes

Task 2

Label 3 volumes from bar11a to bar13a.

Command:
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.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]