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

HiRDB administrator

(a) HiRDB single server configuration

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

(b) HiRDB parallel server configuration

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

(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:

• If the system log file is not dualized, the command opens physical file A in the same manner as when the -a option is specified
• If the system log file is dualized, the command opens physical files A and B in the same manner as when the -a and -b options are both specified

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.

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.
4. If you use Real Time SAN Replication based on the log-only synchronous method, the file to be opened 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 opened. The synchronization point dump file for log application processing cannot be opened.
     
   • At the log application site
     The synchronization point dump file for log application processing is opened. Neither the system log file nor the synchronization point dump file for transaction processing can be opened.