(a) -p
Specifies that the termination is to be by planned termination.
Difference between planned termination and normal termination is as follows:
Connected to HiRDB | Transaction | Normal termination | Planned termination |
---|
No | No | Y | Y |
Yes | N | N |
Yes | No | N | Y |
Yes | N | N |
- Legend:
- Y: Can be executed.
- N: Cannot be executed.
(b) -f
Specifies that the termination is to be by forced termination. When this option is omitted, normal termination is executed.
(c) {-x host-name|-u unit-identifier|-s server-name}
Specifies the unit or server that is to be terminated. When this option is omitted, the HiRDB system is terminated.
- -x host-name ~<identifier> ((1-32))
- When a unit is to be terminated, specifies the name of the host containing the unit. The host containing the system manager cannot be specified.
- When the standby-less system switchover (effects distributed) facility is used, the command terminates the host and guest BESs on the specified host's unit. If the terminated server was the running system, it is released from acceptable status when viewed from another unit in the HA group.
- -u unit-identifier ~<identifier> ((4 characters))
- When a unit is to be terminated, specifies the identifier of the unit. The unit identifier of the unit in which the system manager is located cannot be specified.
- When the standby-less system switchover (effects distributed) facility is used, the command terminates the host and guest BESs on the specified unit. If the terminated server was the running system, it is released from acceptable status when viewed from another unit in the HA group.
- -s server-name ~<identifier> ((1-8))
- When a server is to be terminated, specifies the name of the server.
- When the standby-less system switchover (effects distributed) facility is used:
- When the -u option is omitted, the command terminates the specified servers on all active units in the HA group.
- When the -u option is specified, the command terminates the specified server on that unit. If the terminated server was the running system, it is released from acceptable status as viewed from other units in the HA group.
- For details about the standby-less system switchover (effects distributed) facility, see the HiRDB Version 9 System Operation Guide.
(d) -z
Specifies that a unit other than the system manager is to be directly logged into and terminated forcibly; this option is specified when the system manager in a HiRDB/Parallel Server terminates abnormally and cannot be restarted.
If the pdstop command with the -z option specified is executed by mistake during HiRDB system startup or normal termination, the unit may terminate abnormally or the command may not be executed.
(e) -d
Specifies that a dump of shared memory is to be output at the time of termination. If the -s option is specified, this option is ignored. The shared memory dump is output to %PDDIR%\spool\pdshmdump\shmdump.
(f) -q
If the system switchover facility is used, this option specifies that the specified system is to be terminated forcibly. You can specify this option if use is specified in the pd_ha operand, and the pd_ha_unit operand is also specified in the system definitions.
(g) -c
When the standby-less system switchover (1:1) facility is being used, specifies that the alternate system is to be terminated forcibly. Specify this option in the following cases:
- When Hitachi HA Toolkit Extension is being used and the alternate system is to be switched over to the primary system (specify the pdstop -q -c command in the termcommand operand of Hitachi HA Toolkit Extension).
- When only the alternate system is to be terminated forcibly without stopping the alternate BES unit. While the alternate system is running, you can also terminate the alternate system forcibly by executing one of the following commands from the unit that contains the system manager: pdstop -f -u unit-identifier-of-normal-BES-unit or pdstop -f -x host-name-of-normal-BES-unit
To execute the pdstop -q -c command, directly log onto the host of the alternate system that is to be terminated forcibly (host specified in -x of the pdunit operand in the system definition).