pdlogcls (Close open log file)

Function

The pdlogcls command closes an open physical file that comprises a specified file group, so that it cannot be used by the active HiRDB. However, the following physical files cannot be closed:

Executor

HiRDB administrator

Format

HiRDB/Single Server

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

HiRDB/Parallel Server

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

Options

Specifies the type of log file to be closed:

sys
System log file
spd
Synchronization point dump file

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

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

When a system log file or synchronization point dump file is to be closed, specifies that the primary physical file is to be closed.

When a system log file or synchronization point dump file is to be closed, specifies that the secondary physical file is to be closed. If the system log 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:

Rules

  1. The pdlogcls command can be executed only while HiRDB is active.
  2. The pdlogcls 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 closed, a warning message (KFPS01283-W or KFPS02168-W) is output.

Notes

  1. The following are the pdlogcls command's return codes:
    0: Normal termination
    4: Abnormal termination
    8: Abnormal termination (such as an invalid option or rsh error)
  2. The pdlogcls command may result in an error if it is executed while log files are being swapped or being processed by another operation command.
  3. The result of the pdlogcls command can be checked by the pdlogls command.
  4. If pd_log_remain_space_check=safe is specified in the system definition and closing a system log file with the pdlogcls command results in a space shortage, the command issues the KFPS01280-E message (reason code: 712) and results in an error. In such a case, increase the available space for the system log file and then re-execute the pdlogcls command. For details about using the facility for monitoring free area for system log files, see the HiRDB Version 8 System Operation Guide.
  5. If you use Real Time SAN Replication based on the log-only synchronous method, the file to be closed depends on the site where the command is executed.
    • At the transaction execution site
      The system log file and the synchronization point dump file for transaction processing are closed. The synchronization point dump file for log application processing cannot be closed.
    • At the log application site
      The synchronization point dump file for log application processing is closed. Neither the system log file nor the synchronization point dump file for transaction processing can be closed.