DEFINE LIBRARY (Define an External library)
Use this syntax to define an External library.
Privilege class
To issue this command, you must have system privilege or unrestricted storage privilege.
Syntax
Parameters
- library_name (Required)
- Specifies the name of the library to be defined. The maximum length of this name is 30 characters.
- LIBType=EXTernal (Required)
- Specifies that the library is managed by an external media management system. This library type
does not support drive definitions with the DEFINE DRIVE command. Rather, the
external media management system identifies the appropriate drive for media access operations.
In an IBM Spectrum® Protect for Storage
Area Networks environment, this parameter specifies that StorageTek Automated Cartridge System
Library Software (ACSLS) or Library Station software controls the library. Software, such as Gresham
EDT-DistribuTAPE, allows multiple servers to share the library. The drives in this library are not
defined to IBM Spectrum Protect. ACSLS identifies the drive for
media operations. - 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.
- 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.
Example: Define an external library for a SAN configuration
For an IBM Spectrum Protect for Storage Area Networks configuration, define a library named EXTLIB with the library type of EXTERNAL. If you are using Gresham Enterprise DistribuTAPE, the external library manager executable file is in the following directory:
- /usr/lpp/dtelm/bin/elm
/opt/OMIdtelm/bin/elm- c:\program files\GES\EDT\bin\elm.exe
- /opt/IBM/TSLM/client/tsm/elm
- ...\IBM\rmm\client\tsm\elm.exe
- Define the library:
define library extlib libtype=external - Define the
path:
define path server1 extlib srctype=server desttype=library externalmanager="/usr/lpp/dtelm/bin/elm"define path server1 extlib srctype=server desttype=library externalmanager="/opt/OMIdtelm/bin/elm"define path server1 extlib srctype=server desttype=library externalmanager="c:\program files\GES\EDT\bin\elm.exe"