2.50 pdlogopen (Open log file)

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

(1) Function

The pdlogopen command opens a closed physical file that comprises a specified file group, so that it can be used by the active HiRDB.

(2) Executor

HiRDB administrator

(3) Format

(a) HiRDB/Single Server

pdlogopen {-d {sys|spd} [-s server-name] -g file-group-name [-a][-b]

(b) HiRDB/Parallel Server

pdlogopen {-d {sys|spd} -s server-name -g file-group-name [-a][-b]

(4) Options

(a) -d sys|spd

Specifies the type of log file to be opened:

sys
System log file
spd
Synchronization point dump file
(b) -s server-name ~<identifier> ((1-8))

Specifies the name of the server corresponding to the file group.

(c) -g file-group-name ~<identifier> ((1-8))

Specifies the name of the file group containing the file to be opened.

(d) -a

When a system log file or synchronization point dump file is being opened, this option specifies that the primary physical file is to be opened.

(e) -b

When a system log file or synchronization point dump file is being opened, this option specifies that the secondary physical file is to be opened. If the system log file or synchronization point dump file is not dualized, specifying this option results in a command error.

When the-a and -b options are both omitted, the following processing is performed:

(5) Rules

  1. The pdlogopen can be executed only while HiRDB is active.
  2. The pdlogopen command must be executed at the server machine containing the single server or the server machine where the system manager is located.
  3. If the specified physical file is already open, a warning message (KFPS01283-W or KFPS02167-W) is output.

(6) Notes

  1. The following are the pdlogopen command's return codes:
    0: Normal termination
    4: Abnormal termination
    8: Abnormal termination (such as an invalid option or rsh error)
  2. The pdlogopen command may result in an error if it is executed while the file group status is being changed (such as during file swapping or processing by another operation command).
  3. The result of the pdlogopen command can be checked by the pdlogls command.