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


>>-DEFine LIBRary--library_name--LIBType--=--EXTernal----------->

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

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.

AIX operating systems Oracle Solaris operating systems Windows operating systems In an IBM® Tivoli® Storage Manager 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 Tivoli Storage Manager. 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 Tivoli Storage Manager 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

If you are using the IBM Tape System Library Manager, the external library manager executable file can be found in the following directory:

/opt/IBM/TSLM/client/tsm/elm
...\IBM\rmm\client\tsm\elm.exe

For more information, see the IBM Tape System Library Manager User's Guide at http://www-01.ibm.com/support/docview.wss?uid=pub1ga32220802.

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"