chlib - Change library attributes

Purpose

Change specific attributes of LIBRARY objects in the TSLM database.

Parameters

library_name [...]

Specifies the libraries for which attributes must be changed. Multiple names must be separated with a blank character between each name.

-lm librarymanager_name

Sets the Library Manager that must be actively controlling the Library. If no name is given, the LM attribute of the libraries becomes empty.

-disable

Specifies that the library (and therefore all cartridges or drives in this library) cannot be used for mount operations. Mount requests block for blocking mounts and fail for immediate mounts.

Note: Unmount operations are still allowed even if a library is disabled to ensure that running mount jobs can continue and end properly. However, unmount operations are not allowed to a disabled remote library.

-enable

Specifies that the library can be used for mount/unmount operations. Sets the LibraryOnline attribute to "true".

-online

Switches the library online, which means that the actively controlling library manager is contacting the library and, in case it was successful, the Library is set to online.

Note: Switching the library to online does not automatically trigger an audit of the library. If needed, a library audit must be triggered manually by using the audit command.

-offline

Switches the library offline, which means the actively controlling library manager is shutting down its library connection.

Results

Beyond the general error code, the following command-specific error codes are returned:

• EMM1401E – in case the library (s) specified by name or match option could not be found.
• EMM1509E – in case a non-existent library manager has been specified

Related commands

• lslib - List libraries
• lslm - List Library Manager