Use PERFORM LIBACTION command to define all tape drives

Tivoli Storage Manager has a new feature command PERFORM LIBACTION where we can define or delete all drives and their paths for a single library in one step. This command is only valid for library types of SCSI and VTL. 

If you are setting up or modifying your hardware environment and must create or change large numbers of drive definitions, the PERFORM LIBACTION command can make this task much simpler. You can define a new library and then define all drives and paths to the drives. 


If you have an existing library that you want to delete, you can delete all existing drives and their paths in one step. The PREVIEW parameter allows you to view the output of commands before they are processed to verify the action that you want to perform. If you are defining a library, a path to the library must already be defined if you want to specify the PREVIEW parameter. You cannot use the PREVIEW and DEVICE parameters together.

If you are defining drives and paths for a library, the SANDISCOVERY option must be supported and enabled.

Read: IBM Spectrum Protect (TSM) Basic Free Tutorials


Skip visual syntax diagram
>>-PERForm LIBACTion--library_name------------------------------>

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

   '-SOURCe--=--source_name-'  '-PREView--=--+-Yes-+-'   

A (DEFine)



Read: 200+ TSM Interview Question & Answers to crack any interview

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.

Specifies the action for the PERFORM LIBACTION command. Possible values are:
Specifies that drives and their paths are defined for the specified library. SAN discovery must be enabled before you specify this parameter value.
Specifies that drives and their paths are deleted for the specified library.

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.

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.

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.

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:
Specifies that a preview of the commands that are issued for PERFORM LIBACTION is not displayed.
Specifies that a preview of the commands that are issued for PERFORM LIBACTION is displayed.

Ex: To set up a VTL library named VTLLIB, complete these steps:
  • Define the library.
          define library VTLLIB libtype=vtl
  • Define two drives and their paths for your new library, VTLLIB. 
         perform libaction VTLLIB action=define device=/dev/lb3 prefix=dr

The server then issues the following commands:

define path tsmserver VTLLIB srct=server destt=library device=/dev/lb3 

define drive VTLLIB dr0

define path tsmserver dr0 srct=server destt=drive library=VTLLIB device=/dev/mt1 

define drive VTLLIB dr1
define path tsmserver dr1 srct=server destt=drive library=
VTLLIB device=/dev/mt2

What Others are Reading Now...

0 Comment to "Use PERFORM LIBACTION command to define all tape drives"

Post a Comment