Administrator's Reference

UPDATE LIBRARY (Update a Library)

Use this command to update a library definition. To update the device name, the ACS number, or the external manager path name of a library, you must use the UPDATE PATH command.

This section includes syntax diagrams for a number of different library configurations:

Privilege Class

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

Syntax

>>-UPDate LIBRary--library_name--+------------------+----------><
                                 '-ACSID--=--number-'
 
 

Syntax

Library Sharing in a Storage Area Network (but Not for NDMP Operations)

>>-UPDate LIBRary--library_name--+--------------------+--------><
                                 '-SHAREd--=--+-Yes-+-'
                                              '-No--'
 
 

>>-UPDate LIBRary--library_name--------------------------------->
 
>--PRIMarylibmanager--=--server_name---------------------------><
 
 

Syntax

>>-UPDate LIBRary--library_name----SHAREd--=--+-No--+----------><
                                              '-Yes-'
 
 

Syntax

>>-UPDate LIBRary--library_name--+---------------------+-------->
                                 '-LANFree--=--+-Yes-+-'
                                               '-No--'
 
>--+--------------------------------+--------------------------><
   '-OBEYMOUNTRetention--=--+-Yes-+-'
                            '-No--'
 
 

Parameters

library_name (Required)

Specifies the name of the library to be updated.

SHAREd

Specifies that this library is shared with other servers in a storage area network (SAN). You must issue this command from the server defined as the primary library manager for the shared library. This parameter is required for libraries defined to a library manager and for libraries used for NDMP operations.The possible values are:

Yes

Specifies that this library is shared with other servers.

No

Specifies that this library is not shared with other servers.

Note:

You cannot change the SHARED attribute from YES to NO if the library contains private volumes that are owned by other servers. You cannot change the SHARED attribute from NO to YES unless the server can access the library. If a library has path from a data mover (such as a NAS file server) but no connection to the Tivoli Storage Managerserver, the library cannot be shared with another Tivoli Storage Manager server.

PRIMarylibmanager

Specifies the name of the server that is responsible for controlling access to library resources. You must define this server with the DEFINE SERVER command before you can use it for a primary library manager. This parameter is only valid for libraries defined to a library client.

ACSID

Specifies the number of this STK library assigned by the ACSSA (Automatic Cartridge System System Administrator). This can be a number from 1 to 64. Issue QUERY ACS on your system to get the number for your library ID. See your STK documentation for more information.

LANFree

Specifies whether the external library is used for LAN-free operations.

Yes

Specifies that this library is used for LAN-free data movement.

No

Specifies that this library is not used for LAN-free data movement.

OBEYMOUNTRetention

Specifies whether the server uses the value set for mount retention in the device class associated with this library.

Yes

Specifies that the device class mount retention specification is valid and that the mounted volume should be retained for the specified period.

No

Specifies that the device class mount retention specification is to be ignored.

Examples

Task

Update an ACSLS library named ACSLSLIB with a new ID number.

Command:

update library acslslib acsid=1

Task

For a library client server, change the name of the library manager server to CASTOR.

Command:

update library pollux primarylibrarymanager=castor

Task

Update an external library named EXTLIB to be used in a LAN-free environment.

Command:

update library extlib lanfree=yes obeymountretention=yes

Related Commands

Table 319. Commands Related to UPDATE LIBRARY