6.19.4 User command issuance format: when the HA Monitor status has changed
This subsection explains the format of user commands that are issued by HA Monitor when the HA Monitor status has changed.
- Organization of this subsection
(1) Format of user commands issued by HA Monitor
When the HA Monitor status has changed, HA Monitor issues a user command created by the user in the following format:
command-name HA-Monitor-status-parameter [start/end-parameter] [details-parameter]
(2) Parameters
- command-name
-
Indicates the command name of a user command created by the user and specified in the HA Monitor environment settings.
- HA-Monitor-status-parameter
-
Indicates the status of HA Monitor. The following parameter is passed:
-
-m: HA Monitor start or termination status or HA Monitor error status on the remote host
-
- start/end-parameter
-
Indicates whether this is the start or the end point of the HA Monitor status change (HA Monitor processing). One of the following values is passed:
-
start: Start point of the HA Monitor status change (HA Monitor processing)
-
end: End point of the HA Monitor status change (HA Monitor processing)
-
- details-parameter
-
If HA-Monitor-status-parameter indicates an HA Monitor failure status on the remote host, this parameter indicates the corresponding remote host. The following parameter is passed:
-
-d host-name: Name of the host on which an HA Monitor failure has occurred
If an HA Monitor failure is detected on the remote host (-m -d host-name), the user command is issued only on the host that is paired with the host resulting in the failure and that is subject to hot standby processing.
-
(3) Examples of user commands issued by HA Monitor
-
This example issues a user command (/usr/bin/usrcmd) when HA Monitor starts on the local host:
/usr/bin/usrcmd -m start
-
This example issues a user command (/usr/bin/usrcmd) when an HA Monitor failure is detected on the host named host:
/usr/bin/usrcmd -m -d host