2.97 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
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
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, 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.

(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).