2.116 pdstsopen (Open status file)

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

(1) Function

The pdstsopen command opens a status file initialized by the pdstsinit command or a status file closed by the pdstscls command. This command is applicable only to status files defined in the HiRDB system definition and can be executed only while HiRDB is active.

(2) Executor

HiRDB administrator

(3) Format

(a) HiRDB single server configuration
Unit status file

pdstsopen [-x host-name|-u unit-identifier}]
          {-n logical-filename|-f physical-filename}

Server status file

pdstsopen -s server-name
          {-n logical-filename|-f physical-filename}

(b) HiRDB parallel server configuration
Unit status file

pdstsopen {-x host-name|-u unit-identifier}
          {-n logical-filename|-f physical-filename}

Server status file

pdstsopen -s server-name
         {-n logical-filename|-f physical-filename}

(4) Options

(a) {-x host-name|-u unit-identifier}

When a unit status file is to be opened, specifies the identifier of the unit or the name of the host corresponding to the unit status file. For a HiRDB single server configuration, this option can be omitted because the host and unit are fixed.

-x host-name ~<identifier> ((1-32))
Specifies the name of the host corresponding to the unit status file.
-u unit-identifier ~<identifier> ((4 characters))
Specifies the identifier of the unit corresponding to the unit status file.
(b) -s server-name ~<identifier> ((1-8))

When a server status file is to be opened, specifies the name of the server corresponding to the server status file.

(c) -n logical-filename ~<identifier> ((1-8))

When a status file corresponding to a specific logical file is to be opened, specifies the name of the logical file. Both versions (A and B) of the specified logical file will be opened at the same time. However, to open both files (A and B), one of the following must apply:

(d) -f physical-filename ~<pathname> ((up to 167 characters))

When the status file corresponding to a specific physical file is to be opened, specifies the absolute pathname of the physical file. A physical filename must be specified in the format HiRDB-file-system-area-name/HiRDB-file-name. This option is specified to open a status file that has been placed in shutdown status due to an error or a physical file initialized by the pdstsinit in order to extend its capacity.

When you execute the command at the log application site, the specified physical file cannot belong to a status file. When you execute the command at the transaction execution site, the specified physical file name cannot belong to a status file for log application processing.

(5) Rules

  1. The pdstsopen command can be executed only while HiRDB is active.
  2. The pdstsopen 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 current status file is in single-operation mode, the physical file version in shutdown status can be used as the current status file by initializing it with the pdstsinit command and then executing the pdstsopen command.

(6) Notes

  1. The following are the pdstsopen command's return codes:
    0: Normal termination
    8: Abnormal termination (such as an invalid option or rsh error)
  2. The result of the pdstsopen command can be checked by the pdls command (with -d sts specified).
  3. If you use Real Time SAN Replication based on the log-only synchronous method, the status file to be opened depends on the site at which the command is executed:
    • At the transaction execution site
      The status file for transaction processing is opened. The status file for log application processing cannot be opened.
    • At the log application site
      The status file for log application processing is opened. The status file for transaction processing cannot be opened.