9.21 monscsiclr (releases reservations for shared disks)

Format

monscsiclr server-alias-name

Users who can execute the command

Superuser

Description

The monscsiclr command releases reservations for the devices specified in the scsi_device and dmmp_device operands in the server environment definition (servers).

If the active server cannot be started because shared disks are reserved, use this command to release the reservations so that the active server can be started. You can execute this command regardless of whether HA Monitor is running.

If all the reservations are released successfully, the KAMN108-I message with detail code SUCCESS is issued. If the command fails to release the reservation for any shared disk, the KAMN108-I message with detail code FAILURE is issued. The command skips a device whose reservation could not be released and continues processing.

Options

• server-alias-name

  Specifies the alias name of the server for which shared disk reservations are to be released.

Return codes

Notes

• Do not execute the monscsiclr command while the active server whose alias name is specified in the option is running on any of the hosts. If the monscsiclr command is executed in such a case, the shared disks might no longer be locked.

• This command ignores the scsi_timeout and scsi_retry operand settings in the HA Monitor environment settings (sysdef) and assumes the default values.

Example

Display during command execution

This example assumes the following:

• /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000000 is reserved.

• /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001 is reserved, but its open processing fails when the monscsiclr command is executed.

• /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000002 is not reserved.

  > monscsiclr server1
  KAMN107-I Reservation release processing for server server1 will now start.
    Device                                                        Status
    /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000000        CLEARED
  KAMN601-W An error occurred in the open system call. Error details: 2 Functional name: scsi_cmd_ctrl.
  KAMN725-W Execution of the SCSI command on the device /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001 ended abnormally. (details code: OPEN, server: server1, host address: *(*)).
  KAMN726-E Errors occurred on all the paths to the device /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001.
    /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001        FAILED
    /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000002        NO_RESERVE
  KAMN108-I Reservation release processing for server server1 is completed. Details: FAILURE

Legend:

>: Indicates a user operation.

• The value displayed for Device consists of a maximum of 61 single-byte characters. If the path of a shared disk consists of more than 61 characters, the excess characters are not displayed.

• The following table shows the Status values and their meanings:

  Status	Meaning
  CLEARED	Reservation was released.
  FAILED	Reservation release processing failed. See the displayed message and take appropriate action.
  NO_RESERVE	Reservation had not been made.