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

Privilege Class

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

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

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.

Examples

Task

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

Command:
update library pollux primarylibrarymanager=castor

Related Commands

Table 313. 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 ]