2.58 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 configuration

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

(b) HiRDB parallel server configuration

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 backup acquisition shell. For examples of creating a backup acquisition shell, see Example of shell for backing up after synchronization point dump validation in the HiRDB Version 9 System Operation Guide.

(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)
    How you obtain the return code depends on the shell being used. You use echo $? in the Bourne shell (sh) and echo $status in the C shell (csh).