25.12.2 server definition statement

Organization of this subsection
(1) switchtype operand
(2) actcommand operand
(3) termcommand operand

(1) switchtype operand

Specify the processing to be performed when a server failure is detected.

switch:
When HiRDB (or unit for a HiRDB/Parallel Server) terminates abnormally, system switchover is to be performed and HiRDB is to restart on the switchover destination system.
For the standby-less system switchover (1:1) facility, it is recommended that you specify switch in the server definition statement for the alternate portion created in the alternate BES unit. When switch is specified, the system is switched from the alternate portion to the normal BES unit if an error occurs in the alternate BES unit while alternating units; as a result, the load on the alternate BES unit can be reduced after it restarts.
For the standby-less system switchover (effects distributed) facility, it is recommended that you specify switch in the server definition statement for the guest BES. When switch is specified, the guest BES switches to another unit if an error occurs in the unit in which the guest BES is running; as a result, the load on the unit can be distributed after it restarts.
restart:
HiRDB (or unit for a HiRDB/Parallel Server) is to be restarted on the system on which the error occurred. Only if HiRDB cannot be restarted on the system on which the error occurred is system switchover to occur and HiRDB to be restarted on the switchover destination system (system switchover is reported by output of the KFPS00715-E message).
For the standby-less system switchover (1:1) facility, it is not recommended that you specify restart in the server definition statement for the alternate portion created in the alternate BES unit. When restart is specified, the alternate BES unit continues to assume the alternate processes of the normal BES unit when an error occurs in the alternate BES unit while alternating units; as a result, the load on the alternate BES unit is not reduced after it restarts.
For the standby-less system switchover (effects distributed) facility, it is not recommended that you specify restart in the server definition statement for the guest BES. When restart is specified, the guest BES continues processing if an error occurs in the unit in which the guest BES is running after the unit restarts; as a result, the load on the unit cannot be distributed after it restarts.
manual:
The systems are not to be switched automatically even if HiRDB (or unit for a HiRDB/Parallel Server) cannot be restarted.
Hint
When you use the standby-less system switchover (1:1) facility with a mutual alternating configuration, specify the same value in the switchtype operand of the alternate BES unit and the alternate portion.
When you use the standby-less system switchover (effects distributed) facility, specify the same value in the switchtype operand of all servers in the HA group.

(2) actcommand operand

Specify a command to be executed at the time of package startup or failover. Hitachi recommends that you not specify this operand in the server mode, because this is an extension issued by system switchover and the command must be issued to the standby system unit.

When a unit in the system manager is subject to system switchover, specifying the pdstart command (pdstart -q for a HiRDB/Parallel Server) in the actcommand operand makes it possible to group this command with the package startup command and start HiRDB. However, because the actcommand operand is also executed during system switchover, the pdstart command is issued to the standby system HiRDB that is already performing the startup processing and an error is output.

For the standby-less system switchover (1:1) facility, specify the pdstart -q -c command in the startup batch file if the actcommand operand must be specified for the standby system (alternate portion).

For the standby-less system switchover (effects distributed) facility, you cannot specify the actcommand operand.

(3) termcommand operand

Hitachi recommends specifying the pdstop -f -q command (pdstop -z -q command for a HiRDB/Parallel Server) for two reasons. First, specifying the forced termination option is guaranteed to stop the unit. Second, during planned system switchover, the standby system must inherit IP addresses when it restarts. Also, if planned system switchover is performed when the running system unit has not started, the pdstop command specified in the termcommand operand will result in an error. If the termcommand operand is not specified, the pdstop command must be used to terminate forcibly the running unit before system switchover occurs. If a planned system switchover is performed while the running system unit is still active, there will be two running units. If an error occurs, both systems may stop.

For the standby-less system switchover (1:1) facility, specify the pdstop -z -c command in the termcommand operand of the alternate portion.

For the standby-less system switchover (effects distributed) facility, specify the pdstop -z -s command in the termcommand operand of all servers within the HA group.