DEFINE LIBRARY (Define a 349X library)

Use this syntax to define a 349X library.

Privilege class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax


>>-DEFine LIBRary--library_name--LIBType--=--349X--------------->

   .-SHAREd--=--No------.  .-RESETDrives--=--No----------.   
>--+--------------------+--+-----------------------------+------>
   '-SHAREd--=--+-Yes-+-'  |                         (1) |   
                '-No--'    '-RESETDrives--=--+-Yes-+-----'   
                                             '-No--'         

   .-AUTOLabel--=--Yes-----------.   
>--+-----------------------------+------------------------------>
   '-AUTOLabel--=--+-No--------+-'   
                   +-Yes-------+     
                   '-OVERWRITE-'     

   .-SCRATCHCATegory--=--301----.   
>--+----------------------------+------------------------------->
   '-SCRATCHCATegory--=--number-'   

   .-PRIVATECATegory--=--300----.   
>--+----------------------------+------------------------------->
   '-PRIVATECATegory--=--number-'   

>--+--------------------------------+--------------------------><
   '-WORMSCRatchcategory--=--number-'

Notes:

The default value of the RESETDRIVES parameter is conditional. If the SHARED parameter is set to NO, the value of the RESETDRIVES parameter is NO. If the SHARED parameter is set to YES, the value of the RESETDRIVES parameter is YES.

Parameters

library_name (Required)

Specifies the name of the library to be defined. The maximum length of this name is 30 characters.

LIBType=349X (Required)

AIX operating systems Linux operating systems Specifies that the library is an IBM 3494 or 3495 Tape Library Dataserver.

Windows operating systems Specifies that the library is an IBM 3494 Tape Library Dataserver or an IBM Tape System Library Manager emulating a 3494 Tape Library Dataserver.

Restriction: IBM 3494 libraries support only one unique device type at a time.

SHAREd

Specifies whether this library is shared with other servers in a storage area network (SAN). This parameter is required when you define a library to the library manager.

YES: Specifies that this library can be shared with other servers. When you specify YES, the library manager server mounts volumes as requested by other servers and tracks drive and volume allocation to other servers.
NO: Specifies that this library cannot be shared with other servers. SHARED=NO is required if the library is controlled by passing commands through a NAS file server.

AUTOLabel

Specifies whether the server attempts to automatically label tape volumes. This parameter is optional. The default is YES.

To use this option, you must check in the tapes with CHECKLABEL=BARCODE on the CHECKIN LIBVOLUME command.

Restriction: If you are defining a library that has drives that are attached to a network-attached storage (NAS) device, you must use the LABEL LIBVOLUME command to label the volumes for this library.

No: Specifies that the server does not attempt to label any volumes.
Yes: Specifies that the server labels only unlabeled volumes.
OVERWRITE: Specifies that the server attempts to overwrite an existing label. The server overwrites existing labels only if both the existing label and the bar code label are not already defined in any server storage pool or volume history list.

SCRATCHCATegory

Specifies the category number to be used for scratch volumes in the library. This parameter is optional. The default value is 301 (becomes X'12D' on the IBM 3494 since it uses hexadecimal values). You can specify a number from 1 to 65279. This number must be unique. It cannot be shared with other applications or defined libraries, and it must be different from the other category numbers in this library.

PRIVATECATegory

Specifies the category number for private volumes that must be mounted by name. This parameter is optional. The default value is 300 (this value becomes X'12C' on the IBM 3494 because it uses hexadecimal values). You can specify a number from 1 to 65279. This number must be unique. It cannot be shared with other applications or defined libraries, and it must be different from the other category numbers in this library.

WORMSCRatchcategory

Specifies the category number to be used for WORM scratch volumes in the library. This parameter is required if you use WORM volumes. You can specify a number from 1 to 65279. This number must be unique. It cannot be shared with other applications or defined libraries, and it must be different from the other category numbers in this library. This parameter is only valid when 3592 WORM volumes are used.

Restriction: If the WORMSCRATCHCATEGORY is not defined and the WORM parameter is set to YES for the device class, the mount operation fails with an error message.

RESETDrives

Specifies whether the server preempts a drive reservation with persistent reserve when the server is restarted or when a library client or storage agent reconnection is established. If, for example, a storage agent becomes unavailable but is still holding the path to a drive, persistent reserve allows the server to break the storage agent's reservation and access the drive.

AIX operating systems Windows operating systems If persistent reserve is not supported, the server completes a reset of the path to the target device.

Linux operating systems If persistent reserve is not supported, the server is not able to reset the path to the target device.

Support for persistent reservation has the following limitations:

If you are using the IBM Spectrum Protect™ device driver, persistent reserve is only supported on some tape drives. See Technote 1470319 for details.
If you are using the IBM® device driver, persistent reserve must be enabled at the device driver level. See the IBM Tape Device Drivers Installation and User's Guide for information about driver configuration.
If you are using a virtual tape library that is emulating a supported drive, it might not support persistent reserve.

The following table describes the three possible configurations for drives that are attached to NAS devices.

Table 1. Configurations for drives that are attached to NAS devices.
Library device configuration	The behavior for persistent reserve
The library device is attached to the IBM Spectrum Protect server, and the tape drives are shared by the server and the NAS device.	Drive reservation preemption is supported when the NAS device supports persistent reserve and it is enabled. For more information about setting persistent reserve, see the documentation for your NAS device.
The library device is attached to the IBM Spectrum Protect server and the tape drives are accessed only from the NAS device.	Drive reservation preemption is not supported. If you enable persistent reserve on the NAS device for these drives and a reservation is set by the NAS device but never cleared, you must use another method to clear the reservation.

Yes: Specifies that drive preemption through persistent reserve or target reset are used. YES is the default for a library that is defined with SHARED=YES.
No: Specifies that drive preemption through persistent reserve or target reset are not used. NO is the default for a library that is defined with SHARED=NO. The RESETDRIVES parameter must be set to YES in a clustered environment when SHARED=NO.

Yes: Specifies that drive preemption through persistent reserve is used. YES is the default for a library that is defined with SHARED=YES.
No: Specifies that drive preemption through persistent reserve is not used. NO is the default for a library that is defined with SHARED=NO.

Note: A library manager will not be able to break a drive reservation if the system that has the drive reservation is not configured to use persistent reservation.

Example: Define a 3494 library

Define a library named my3494 with a scratch category number of 550, a private category number of 600, and a WORM scratch category number of 400®

define library my3494 libtype=349x scratchcategory=550
privatecategory=600 wormscratchcategory=400