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.
To issue this command, you must have system privilege or unrestricted storage privilege.
>>-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-'
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.
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
define library kona libtype=scsi
Then, issue the PERFORM LIBACTION command to define
drives and paths for the library:perform libaction kona action=define device=/dev/lb3
prefix=dr
The server then runs the following commands:define path server1 kona srct=server destt=library
device=/dev/lb3
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona
device=/dev/mt1
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona
device=/dev/mt2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona
device=/dev/mt3
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona
device=/dev/mt4
perform libaction kona action=define device=/dev/rmt/tsmlb3
prefix=dr
The server then runs the following commands:define path server1 kona srct=server destt=library
device=/dev/rmt/tsmlb3
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona
device=/dev/rmt/tsmmt1
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona
device=/dev/rmt/tsmmt2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona
device=/dev/rmt/tsmmt3
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona
device=/dev/rmt/tsmmt4
perform libaction kona action=define device=/dev/tsmscsi/lb3
prefix=dr
The server then runs the following commands:define path server1 kona srct=server destt=library
device=/dev/tsmscsi/lb3
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona
device=/dev/tsmscsi/mt1
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona
device=/dev/tsmscsi/mt2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona
device=/dev/tsmscsi/mt3
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona
device=/dev/tsmscsi/mt4
perform libaction kona action=define device=/dev/rmt/3lb
prefix=dr
The server then runs the following commands:define path server1 kona srct=server destt=library
device=/dev/rmt/3lb
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona
device=/dev/rmt/1mt
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona
device=/dev/rmt/2mt
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona
device=/dev/rmt/3mt
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona
device=/dev/rmt/4mt
perform libaction kona action=define device=lb0.0.0.2
prefix=dr
The server then runs the following commands:define path server1 kona srct=server destt=library
device=lb0.0.0.2
define drive kona dr0
define path server1 dr0 srct=server destt=drive library=kona
device=mt0.1.0.2
define drive kona dr1
define path server1 dr1 srct=server destt=drive library=kona
device=mt0.2.0.2
define drive kona dr2
define path server1 dr2 srct=server destt=drive library=kona
device=mt0.3.0.2
define drive kona dr3
define path server1 dr3 srct=server destt=drive library=kona
device=mt0.4.0.2
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. |
DEFINE SERVER | Defines a server for server-to-server communications. |
DELETE DRIVE | Deletes a drive from a library. |
DELETE LIBRARY | Deletes a library. |
DELETE PATH | Deletes a path from a source to a destination. |
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 LIBRARY | Changes the attributes of a library. |
UPDATE PATH | Changes the attributes associated with a path. |