2.53 pdlogsync (Collect a synchronization point dump)

Organization of this section
(1) Function
(2) Executor
(3) Format
(4) Options
(5) Rules
(6) Notes

(1) Function

The pdlogsync command collects a synchronization point dump.

(2) Executor

HiRDB administrator

(3) Format

(a) HiRDB/Single Server

pdlogsync -d sys [-s server-name] [-w [-t timeout]]

(b) HiRDB/Parallel Server

pdlogsync -d sys -s server-name [-w [-t timeout]]

(4) Options

(a) -d sys

Specifies that a synchronization point dump is to be acquired.

(b) -s server-name ~<identifier> ((1-8))

Specifies the name of the server at which a synchronization point dump is to be collected.

(c) -w

Specifies this option if the termination of the pdlogsync command is to wait until the system point dump is enabled. This option allows the user to determine whether the synchronization point dump has been enabled, based upon a return code returned from the execution of the pdlogsync command. A return code of 0 indicates that the synchronization point dump has been enabled.

Specify this option when creating a batch file for making backups.

(d) -t timeout ~<unsigned-integer> ((10-32768)) <<180>>

When the -w option is specified, specifies a timeout value (in seconds) for the pdlogsync command. The pdlogsync command terminates if a synchronization point dump is not enabled by the time specified in this option. However, the processing for enabling the synchronization point dump will continue. A message KFPS02183-I is output when a synchronization dump is enabled. However, this message will not be output if N is specified in the pd_spd_assurance_msg operand in the system definition.

(5) Rules

  1. The pdlogsync command can be executed only when HiRDB is running.
    This command cannot be executed in the following cases:
    • While HiRDB is starting
    • While HiRDB is terminating
    • When HiRDB was started by the pdstart -r command
  2. The pdlogsync command should be executed on a server machine with either a single server or the system manager.

(6) Notes

  1. The following are the pdlogsync command's return codes:
    0: Normal termination
    4: Abnormal termination
    8: Abnormal termination (such as an invalid option or rsh error)