IBM Tivoli Storage Manager, Version 7.1

PERFORM LIBACTION (Define or delete all drives and paths for a library)

Use this command to define or delete all drives and their paths for a single library in one step.

This command can be used when you set up a library environment or modify an existing hardware setup that requires changes to many drive definitions. After you define a library, issue PERFORM LIBACTION to define drives and their paths for the library. You can also delete all drives and paths for a library by issuing the command with ACTION=DELETE.

This command is only valid for library types of SCSI and VTL. To use this command with ACTION=DEFINE, the SANDISCOVERY option must be supported and enabled.

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

Privilege class

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

Syntax


>>-PERForm LIBACTion--library_name------------------------------>

>----ACTion--=--+-DEFine--| A |-+------------------------------->
                '-DELete--------'     

                               .-PREView--=--No------.   
>--+------------------------+--+---------------------+---------><
   '-SOURCe--=--source_name-'  '-PREView--=--+-Yes-+-'   
                                             '-No--'     

A (DEFine)

|--+--------------------------------+--------------------------->
   '-DEVIce--=--library_device_name-'   

   .-PREFix--=--library_name------.   
>--+------------------------------+-----------------------------|
   '-PREFix--=--drive_prefix_name-'

Parameters

library_name (Required)

Specifies the name of the library to be defined or deleted. The maximum length of this name is 30 characters unless you are issuing PERFORM LIBACTION with ACTION=DEFINE and using the default PREFIX value. In that case, the maximum length of the name is 25 characters.

ACTion

Specifies the action for the PERFORM LIBACTION command. Possible values are:

DEFine: Specifies that drives and their paths are defined for the specified library. SAN discovery must be enabled before you specify this parameter value.
DELete: Specifies that drives and their paths are deleted for the specified library.

DEVIce

Specifies the library device name that is used when you define paths if a path to the library is not already defined. If a path is already defined, the DEVICE parameter is ignored. The maximum length for this value is 64 characters. This parameter is optional.

PREFix

Specifies the prefix that is used for all drive definitions. For example, a PREFIX value of DR creates drives DR0, DR1, DR2, for as many drives as are created. If a value is not specified for the PREFIX parameter, the library name is used as the prefix for drive definitions. The maximum length for this value is 25 characters.

SOURCe

Specifies the source server name to be used when you define or delete drive path definitions on a library client or LAN-free client. Use this parameter only if the drives in the library are set up for the local server. If no value is specified for the SOURCE parameter, the local server name, which is the default, is used. The maximum length for the source name is 64 characters.

If a source name other than the local server name is specified with ACTION=DEFINE, drive path definitions are defined with the token value of UNDISCOVERED. The path definitions are then updated dynamically by library clients that support SAN Discovery the first time the drive is mounted.

PREView

Specifies the output of all commands that are processed for PERFORM LIBACTION before the command is issued. The PREVIEW parameter is not compatible with the DEVICE parameter. If you are issuing the PERFORM LIBACTION command to define a library, you cannot specify both the PREVIEW and the DEVICE parameter.

Possible values are:

No: Specifies that a preview of the commands that are issued for PERFORM LIBACTION is not displayed.
Yes: Specifies that a preview of the commands that are issued for PERFORM LIBACTION is displayed.

Example: Define a shared library

Assume that you are working in a SAN and that you have configured a library manager named LIBMGR1. Now, define a library named SHAREDTSM to a library client server named LIBCL1.

Issue DEFINE LIBRARY from the library client server, LIBCL1:

define library sharedtsm libtype=shared primarylibmanager=libmgr1

Then, issue PERFORM LIBACTION from the library manager, LIBMGR1, to define the drive paths for the library client:

perform libaction sharedtsm action=define source=libcl1

Note: The SANDISCOVERY option must be supported and enabled on the library client server.

Example: Define a library with four drives

Define a SCSI library named KONA:

define library kona libtype=scsi

Then, issue the PERFORM LIBACTION command to define drives and paths for the library: