The pdstart command starts a HiRDB system, unit, or server. This command is also used to initiate a restart.
HiRDB administrator
pdstart [{-i|-r|dbdestroy}] |
pdstart [{-i|-r|dbdestroy}] |
pdstart {-x host-name|-u unit-identifier}[{-r|dbdestroy}] |
pdstart -s server-name |
pdstart -a [-s front-end-server-name] |
pdstart -q [-r] |
pdstart -q -c |
pdstart [{-x host-name|-u unit-identifier}] -s server-name |
pdstart -R |
Specifies the startup mode for the HiRDB system. When this option is omitted, the HiRDB system performs normal startup if the previous termination was normal termination or performs a restart if the previous termination was forced or abnormal termination. In the case of a restart, database recovery processing is performed.
Specifies that a unit is to be started.
For details about -r and dbdestroy, see the description of {-i|-r|dbdestroy}.
When a server is to be started, specifies the name of the server.
Restarts a front-end server after resolving the cause of its SUSPEND status (waiting for the recovery of the data dictionary RDAREA or the starting of the dictionary server). Regardless of whether the -s option is specified, this option starts all the front-end servers in which an error occurred.
Specifies that the unit is to be started on a HiRDB/Parallel Server. When the standby system switchover facility is used, specify this option to start the standby unit.
When the -q option is specified, the host corresponding to the unit to be started (host with the -x or -c operand specified in the pdunit statement in the system common definition) is directly logged into and the command is executed.
If the -q option is specified, you must start all units before the pd_reduced_check_time operand value in the system definition is reached (when omitted, 20 minutes). If the command cannot start any of the units, HiRDB startup processing is cancelled.
For details about -r, see the description of {-i|-r|dbdestroy}.
When the standby-less system switchover (1:1) facility is used, specifies that the alternate system is to be placed in standby status. Specify this option in the following cases:
To execute the pdstart -q -c command, directly log onto the host of the alternate system that is to be placed in standby status (host specified in -x of the pdunit operand in the system definition).
This option is used when the HiRDB/Parallel Server terminated abnormally due to a failure on the unit for the system manager after the HiRDB/Parallel Server had been started by the pdstart -r command. For details about using this option to recover a HiRDB/Parallel Server, see Actions to take if an error occurs during a startup using the pdstart -r command in the HiRDB Version 9 System Operation Guide.
When the pdstart -R command is executed, HiRDB forcibly starts the unit for the system manager and then forcibly terminates all units that were running at the time the command executed. When the pdstart -R command is executed, the HiRDB processing depends on the system configuration and the status of each unit. The table below describes the HiRDB processing and return code that depends on the system configuration and unit status.
System configuration | Unit status | HiRDB processing | Return code of pdstart | ||
---|---|---|---|---|---|
Type | Number of units | System manager | Other | ||
HiRDB/Single Server | -- | -- | -- | pdstart command terminates with an error (KFPS05005-I message is displayed) | 8 |
HiRDB/Parallel Server | 1 | -- | -- | pdstart command terminates with an error (ONE_UNIT in KFPS05813-E message is displayed) | 8 |
2 or more | Inactive | Active by pdstart -r | All units are terminated forcibly | 0 | |
Active by other than pdstart -r |
| 8 | |||
Inactive |
| 0 | |||
Active | -- | pdstart command terminates (NOT OFFLINE is displayed in the KFPS01853-W message) | 8 |