DEFINE LIBRARY (Define a FILE library)

Use this syntax to define a FILE library.

Privilege class

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

Syntax


>>-DEFine LIBRary--library_name--LIBType--=--FILE--------------->

   .-SHAREd--=--No------.   
>--+--------------------+--------------------------------------><
   '-SHAREd--=--+-Yes-+-'   
                '-No--'

Parameters

library_name (Required)

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

LIBType=FILE (Required)

Specifies that a pseudo-library is created for sequential file volumes. When you issue the DEFINE DEVCLASS command with DEVTYPE=FILE and SHARED=YES parameters, this occurs automatically. FILE libraries are necessary only when sharing sequential file volumes between the server and one or more storage agents. The use of FILE libraries requires library sharing. Shared FILE libraries are supported for use in LAN-free backup configurations only. You cannot use a shared FILE library in an environment in which a library manager is used to manage library clients.

SHAREd

Specifies whether this library is shared with other IBM Spectrum Protect™ 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.

Example: Define a shared FILE library

Define a file library with shared=yes.

define library file1 libtype=file shared=yes