The pdrplstart command starts HiRDB Datareplicator linkage.
(2) Executor
HiRDB administrator
(3) Format
pdrplstart
(4) Option
None
(5) Rules
The pdrplstart command can be executed only while all servers and all units in the HiRDB system are active. For example, this command cannot be executed for a HiRDB parallel server configuration if some units or servers are inactive or are performing processing in order to become inactive. However, you can execute the pdrplstart command if the only inactive units are ones that are not started due to reduced activation.
The pdrplstart command must be executed at the server machine containing the single server or the server machine where the system manager is located.
To execute the pdrplstart command, the HiRDB directory name should be set in the PDDIR environment variable. If the directory name is not set, no error message will be output if a command error occurs.
An error results if the pdrplstart command is entered again while HiRDB Datareplicator linkage is executing.
Once you execute the pdrplstart command, do not execute the pdrplstart, pdrplstop, or pdstop command (except when the -f or -z option is specified) while command processing is underway.
If you execute the pdrplstart command while database updating is underway, the update data may not be applied at the intended time. Execute the pdrplstart command after all transactions have terminated. Do not execute any new transactions until the current pdrplstart command has terminated.
(6) Notes
The results of the pdrplstart command can be checked on the basis of the return code and by whether or not there are any error messages. A return code of 0 for this command indicates normal termination; a return value of 8 indicates abnormal termination.
If a communication error occurs while the pdrplstart command is executing, some units may be left in a status with HiRDB Datareplicator linkage started, and the command may terminate abnormally with a return value of 8. In such a case, execute the pdrplstop -f command to stop HiRDB Datareplicator linkage at all units, and then re-execute the pdrplstart command.
Agreement between the extraction-side and target-side databases must be maintained when the pdrplstart command is executed. If HiRDB Datareplicator linkage is started with the databases not in agreement, the contents of the target database cannot be guaranteed.
Once the pdrplstart command is entered, pdrplstart and pdrplstop commands must not be entered until the entered pdrplstart command's processing has been completed.
If you execute the pdrplstart command while HiRDB Datareplicator cannot be linked, the unit that cannot start data linkage may terminate abnormally with abort code Psjiz09. Therefore, do not execute the pdrplstart command when linkage to HiRDB Datareplicator cannot be established.