pdlogsync (Collect a synchronization point dump)

Function

The pdlogsync command collects a synchronization point dump.

Executor

HiRDB administrator

Format

HiRDB/Single Server

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

HiRDB/Parallel Server

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

Options

Specifies that a synchronization point dump is to be acquired.

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

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. Refer to Examples for examples of creating a backup acquisition shell.

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.

Rules

  1. The pdlogsync command can be executed only when HiRDB is running.
  2. The pdlogsync command should be executed on a server machine with either a single server or the system manager.

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)

Examples

Following is an example of creating a backup acquisition shell using the pdlogsync command in conjunction with the operation of a system log without unloading. In this example, a backup is generated after the synchronization point dump is enabled, so that any system log files collected before a backup was acquired can be released.

#!/bin/sh
$PDDIR/bin/pdlogsync -d  sys   w
if [ $status = 0 ]     ; then
   $PDDIR/bin/pdcopy -m host2:/dbarea/area1/rdmt1 -i -p /usr/ofile -f /usr/seifile/cof101
else
       echo  "Synchronization point enabling failed"
fi

Explanation
  • Because the w option is specified in the pdlogsync command, a return code 0 indicates the successful enabling of the synchronization point dump.
  • If the synchronization point dump is enabled, HiRDB uses the database copy utility (pdcopy) to acquire a backup. If the enabling process fails, HiRDB does not acquire a backup.