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 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---'
 
>-----+--------------------------+---+-----------------------+-->
      '-CHECKIN--=--+-SCRatch-+--'   '-DEVTYPE--=----3590----'
                    '-PRIvate-'
 
      .-OVERWRITE--=--No------.
>-----+-----------------------+--------------------------------><
      '-OVERWRITE--=--+-No--+-'
                      '-Yes-'
 

Parameters

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

volume_name
Specifies a volume to label.

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.

SEARCH=YES
Specifies that TSM searches the library for usable volumes to label and labels each volume, unless the volume is already labeled or its barcode cannot be read.

Do not enter a volume name when SEARCH=YES.

SEARCH=BULK
Specifies that TSM searches the library's Entry/Exit ports for usable volumes to label.
Note:For barcode support to work properly, the TSM device drivers must be installed for TSM 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.

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.

LABELSource
Specifies how or whether TSM reads sequential media labels of volumes. Specify this parameter only when SEARCH=YES or SEARCH=BULK.

Possible values are:

Prompt
Prompts for volume names as necessary.

Barcode
TSM attempts to read the barcode label. If the attempt fails, TSM will not label the volume and will display a message. This parameter is valid only for SCSI devices.

VOLList
Specifies the list of volumes to be processed for the command. Possible values are:

volume_name
Specifies the names of one or more values used for the command. Example: VOLLIST=TAPE01,TAPE02.
Note:VOLList is designed to only be a filter of volumes to be checked in or labeled, and it requires that LABELSOURCE=BARCODE.

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 a asterisk are ignored. For example, to use volume TAPE01, TAPE02 and TAPE03, create a file names TAPEVOL that contain these lines as in the following example:

TAPE01
TAPE02
TAPE03

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

Note:The file name is case sensitive.

CHECKIN
Specifies whether TSM checks in the volume. This parameter is optional. This parameter is valid only for 349X and SCSI libraries. The following are possible values:

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

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

DEVTYPE
Specifies the device type for the volume. This option is required only when SEARCH=YES and you are using a 349X tape library This parameter is optional. The possible values are:

3590
Specifies that the volume to check in is for a 3590 device type. Use this option if you have a 349x library attached only to 3590 devices.

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

No
Specifies that TSM only labels unlabeled volumes.

Yes
Specifies that TSM overwrites existing labels only if both the existing label and the prompted/barcode label are not already defined in any TSM 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 search=yes labelsource=barcode 
 checkin=scratch overwrite=yes

Task 2

Label 3 volumes from bar11a to bar13a.

Command:
label libvolume abc checkin=scratch volrange=bar11a,bar13a search=yes labelsource=barcode

The 3 volumes are labeled: bar11a, bar12a, bar13a.

Related Commands

Table 129. 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.


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