Tivoli Header

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:

Configuration Task Syntax Diagram
LAN -- Update an ACSLS library Syntax ( Update an ACSLS Library on a Local Area Network)
SAN -- Update a library ( SCSI, 349X, FILE) defined to a library manager server. Syntax (SAN -- Update a Library Defined to a Library Manager)
SAN -- Update a library (SHARED) defined to a library client server. Syntax (SAN -- Update a Defined Library to a Library Client)
SAN or LAN -- Update a SCSI library to be accessed by NAS data mover. Syntax (Update a Library Used for NDMP Operations)
SAN -- Update an EXTERNAL library to be to be shared with storage agents. Syntax (SAN -- Update an EXTERNAL Library Shared with Storage Agents)

Privilege Class

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

Syntax



Update an ACSLS Library on a Local Area Network

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

Syntax

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

Update a Library Defined to a Library Manager

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



Update a Library Defined to a Library Client

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

Syntax



Update a Library Used for NDMP Operations

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

Syntax



Update an EXTERNAL Library Shared with Storage Agents

>>-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

Command Description
AUDIT LIBRARY Ensures that an automated library is in a consistent state.
DEFINE DRIVE Assigns a drive to a library.
DEFINE LIBRARY Defines an automated or manual library.
DEFINE PATH Defines a path from a source to a destination.
DELETE DRIVE Deletes a drive from a library.
DELETE PATH Deletes a path from a source to a destination.
DELETE LIBRARY Deletes a library.
QUERY DRIVE Displays information about drives.
QUERY LIBRARY Displays information about one or more libraries.
QUERY PATH Displays information about the path from a source to a destination.
UPDATE DRIVE Changes the attributes of a drive.
UPDATE PATH Changes the attributes associated with a path.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]