The lib_cmd command-line utility is an alternative to the ACSLS GUI for managing and monitoring resources in ACSLS logical libraries.

• lib_cmd assign drive drive_id lib_id

  Adds the specified drive to the logical library.

• lib_cmd unassign drive lib_id logical_drive_id

  Removes the specified logical drive from the logical library configuration.

• lib_cmd assign volume [ vol_id | vol-range ] lib_id

  Assigns a volume for exclusive use within a logical library.

• lib_cmd unassign volume [ vol_id | vol-range ] lib_id

  Removes a volume from the logical library inventory.

• lib_cmd create library lib_name backing_acs cell_capacity drive_capacity

  Creates a new logical library.

• lib_cmd create mapping initiator_id target_id library_id

  Establishes an initiator-target (client-server) relationship for the specified library.

• lib_cmd edit library lib_id [-n name ][-c capacity ][-d drive_slots ][-f volume_label_format [6|8p|8s|all][-x imp/exp_cell_count ]
  Alters the configuration of an existing logical library. Options are:

  • -n library alias name
  • -c logical storage cell capacity
  • -d number of logical drive slots
  • -f volume label format
  • -x number of logical import/export (CAP) cells
  Volume label format may be expressed with any of the following:

  • 6 - six character legacy volume labels
  • 8p - eight character prefixed with media type code
  • 8s - eight character suffixed with media type code
  • all - accept all label formats
• lib_cmd refresh initiator

  Retrieves all initiators currently known to ACSLS.

• lib_cmd refresh target

  Retrieves all targets currently known to ACSLS.

• lib_cmd delete initiator initiator_id (y/n)

  Removes the specified initiator from the configuration. Confirmation (y) is required in order to commit the specified deletion.

• lib_cmd delete library lib_id (y/n)

  Removes the specified logical library from the ACSLS configuration. This creates a cascading delete, disassociating any assigned volumes and drives from the library.

• lib_cmd delete mapping lib_id (y/n)

  Removes all initiator-target mappings from the specified logical library. The operation disables any current client connections.

• lib_cmd delete target target_id (y/n)

  Removes the specified target from the configuration. Confirmation (y) is required in order to commit the specified deletion.

• lib_cmd display drive [drive_id ][-p acs_id | all ][-l lib_id | all ][-t drive_type ][-u acs_id ]
  Generates a summary of the specified drive or all drives in the specified library.

  • If display drive all is submitted without options, the utility generates a listing of all volumes contained in each physical ACS.
  • If the -t option is passed, only drives of the specified drive type are displayed.
  • The -p option limits the display to drives in the specified physical ACS.
  • If the -l option is included, then only the drives assigned to the specified logical library are displayed. If all is specified following the -l option, then a display is generated showing all of the drives associated with each of the configured logical libraries.
  • The -u option displays only unassigned drives in the associated ACS. This option must be followed with an argument specifying the desired ACS.
• lib_cmd display initiator

  Generates a list of all initiators identified by ACSLS. Each initiator is listed by its world-wide name and the alias name.

• lib_cmd display library [ -p acs_id | all ] [ -l lib_id | all ]
  Displays the attributes of the requested library ID.

  • l - logical libraries
  • p - physical libraries
• lib_cmd display mapping [ lib_id | all ]

  Generates a list of initiator-target mappings for each library ID (or all libraries).

• lib_cmd display target

  Generates a list of all targets identified by ACSLS.

• lib_cmd display volume [ vol_id | vol-range] [ -p acs_id | all ][ -l lib_id | all ][ -u acs_id ]

  Generates summary information for the specified volume or volume set.

• lib_cmd vary library lib_id [online|offline|diagnostic]

  Changes the desired state of the logical library to the specified (online, offline, diagnostic) state.

• lib_cmd vary library lib_id drive_id [online|offline|diagnostic]

  Changes the desired state of the logical drive to the specified (online, offline, diagnostic) state.

• lib_cmd [ exit | quit | log ]