Administrator's Reference

LABEL LIBVOLUME (Label a Library Volume)

Use the LABEL LIBVOLUME command to label tape volumes or in automated libraries to label the volumes automatically as they are checked into a library. This command also allows the volumes to be labeled with the full length label with which they are often prelabeled.

Currently, this command is only implemented for 349x, SCSI, and MANUAL libraries.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-LABEl LIBVolume--libraryname---+-volname-----------+--------->
                                  '-+-SEARCH=Yes--+---'
                                    '-SEARCH=BULK-'
 
>----LABELSource--=--+-Barcode-+--+--------------------------+-->
                     '-Prompt--'  '-CHECKIN--=--+-SCRatch-+--'
                                                '-PRIvate-'
 
                                    .-OVERWRITE--=--No-------.
>---+----------------------------+--+------------------------+-->
    '-DEVTYPE--=--+-CARTRIDGE-+--'  '-OVERWRITE--=--+-No--+--'
                  '-3590------'                     '-Yes-'
 
>----VOLRange--=--+-volname1-+---------------------------------><
                  '-volname2-'

Parameters

libraryname

Specifies the name of the library where the storage volume is to be located. This parameter is required.

volname

Specifies a volume to be labeled. For automated libraries, mount the volume in the entry/exit slot of the library. If no entry/exit slot is available, the operator will be prompted to mount the volume in an empty slot. For manual libraries, the operator will be prompted to load the volume directly into a drive.

Notes:

If an existing label is found, it will not be overwritten unless OVERWRITE=YES and the existing label is not defined in a storage pool or volume history. If it is, the volume will not be labeled and a message will be displayed.
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.
To use the LABEL LIBVOLUME command, a drive that is not in use by another ADSM process must be available. This includes drives that are mounted with idle volumes. If necessary, use the DISMOUNT VOLUME command to dismount an idle volume and make that drive available.

SEARCH=YES

Specifies that ADSM searches the library for usable volumes to be labeled and labels each volume, unless it is already labeled or its barcode cannot be read.

Do not enter a volume name when SEARCH = YES. If a volume name is entered under this condition, an error is issued.

SEARCH=BULK

Specifies that ADSM searches the library's Entry/Exit ports for usable volumes to be labelled. When using the LABELSOURCE=PROMPT option, the volume is moved from the Entry/Exit ports to the drive. The user is prompted to issue the REPLY command containing the label string and that label is written to the tape. When using the LABELSOURCE=BARCODE, the volume's 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 specificed. Please note, for barcode support to correctly work, the ADSM device drivers must be installed for ADSM controlled libraries.

LABELSource=labelsourcevalue

Specifies how or whether ADSM should read sequential media labels of volumes during LABEL LIBVOLUME command processing. This parameter can only be specified when SEARCH=YES. Setting the labelsource to BARCODE allows ADSM to utilize, if available, any barcode information. This parameter is valid only for SCSI devices (not for manual or 3494 libraries).

Possible values are:

Prompt: Prompts for volume names as necessary.
Barcode: ADSM attempts to read the barcode label from each cartridge. If the barcode scan fails, the volume will not be labeled and a message will be displayed.

CHECKIN=checkinvalue

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

SCRatch: Specifies that the volumes will be checked in and added to the library's scratch pool.
PRIvate: Specifies that the volumes will be checked in and designated PRIVATE. They will only be available when requested by name.

DEVTYPE=devtypevalue

This option is only necessary when CHECKIN= is specified and you are using a 349X tape library with mixed 3490/3590 drive. This parameter is optional. The following are possible values:

CARTRIDGE: Specifies the volumes will be checked in and noted that they are to be mounted on 3490 drives.
3590: Specifies the volumes will be checked in and noted that they are to be mounted on 3590 drives.

OVERWRITE=overwritevalue

Specifies whether ADSM should attempt to overwrite existing labels. This parameter is optional. The default is No. Possible values are as follows:

No: Specifies that ADSM will only label unlabeled volumes.
Yes: Specifies that ADSM will overwrite existing labels ONLY if both the existing label and the prompted/barcode label are not already defined in any ADSM storage pool or volume history list (database dump or export volume).

VOLRange=volrangevalue

Specifies the volume range for this command. The volname format can be any combination of alphanumeric characters. Basically, it contains prefix, incremental, and suffix areas.

The prefix and suffix areas are optional. If they are used, they are identical alphanumeric characters between volname1 and volname2. Prefix area begins at the first character and ends at the first non-compare numeric character. The incremental area is numeric characters. The incremental area begins at the first non-compare character and ends at the next alpha character. The incremental numeric of volname2 must be greater than the numeric of volname1. The suffix area begins at the end of the incremental area. If all characters of volname1 and volname2 are identical, then all characters are prefix area and only one volume is in the range. The possible combination for volume ranges are: AnA, nA, An, n, or A.

A equals the prefix or suffix area where alphanumeric characters of volname1 and volname2 are identical.

n equals the numeric incremental area.

When VOLRange is specified, SEARCH=YES must also be specified.

You can override swap processing by selecting a volume in the library and then explicitly issuing the CHECKOUT LIBVOLUME command prior to the CHECKIN LIBVOLUME command.

Examples

Task

Label a tape volume named AUTO automatically as you are checking the volume into a library.

Command:

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

Related Commands

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

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 ]