DEFINE LIBRARY (Define a library)

Use this command to define a library. A library is a collection of one or more drives, and possibly robotic devices (depending on the library type), which can be used to access storage volumes.

A library can be accessed by only one source: an IBM Spectrum Protect™ server or a data mover. However, the drives in a library can be accessed by multiple sources.

For detailed and current library support information, see the Supported Devices website for your operating system:
Windows operating systems

To automatically label tape volumes in SCSI-type libraries, use the AUTOLABEL parameter on the DEFINE LIBRARY and UPDATE LIBRARY commands. Using this parameter eliminates the need to pre-label a set of tapes. It is also more efficient than using the LABEL LIBVOLUME command, which requires you to mount volumes separately. If you use the AUTOLABEL parameter, you must check in tapes by specifying CHECKLABEL=BARCODE on the CHECKIN LIBVOLUME command.

A label cannot include embedded blanks or periods and must be valid when used as a file name on the media.

You must label CD-ROM, Zip, or Jaz volumes with the device utilities from the manufacturer or the Windows utilities because IBM Spectrum Protect does not provide utilities to format or label these media types. The operating system utilities include the Disk Administrator program (a graphical user interface) and the label command.

Related commands

Table 1. Commands related to DEFINE LIBRARY
Command Description
AUDIT LIBRARY Ensures that an automated library is in a consistent state.
CHECKIN LIBVOLUME Checks a storage volume into an automated library.
CHECKOUT LIBVOLUME Checks a storage volume out of an automated library.
DEFINE DRIVE Assigns a drive to a library.
DEFINE PATH Defines a path from a source to a destination.
DEFINE SERVER Defines a server for server-to-server communications.
DELETE DRIVE Deletes a drive from a library.
DELETE LIBRARY Deletes a library.
DELETE PATH Deletes a path from a source to a destination.
LABEL LIBVOLUME Labels volumes in manual or automated libraries.
PERFORM LIBACTION Defines all drives and paths for a library.
QUERY DRIVE Displays information about drives.
QUERY LIBRARY Displays information about one or more libraries.
QUERY LIBVOLUME Displays information about a library volume.
QUERY PATH Displays information about the path from a source to a destination.
UPDATE DRIVE Changes the attributes of a drive.
UPDATE LIBRARY Changes the attributes of a library.
UPDATE LIBVOLUME Changes the status of a storage volume.
UPDATE PATH Changes the attributes associated with a path.