pdstscls (Close open status file)

Function

The pdstscls command closes an open status file. This command is applicable only to status files defined in the HiRDB system definition and can be executed only while HiRDB is active; it cannot close the current file.

Executor

HiRDB administrator

Format

Unit status file

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

Server status file

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

Unit status file

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

Server status file

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

Options

When a unit status file is to be closed, specifies the identifier of the unit or the name of the host corresponding to the unit status file. In the case of a HiRDB/Single Server, this option can be omitted because the host and unit are fixed.

-x host-name[Figure]<identifier> ((1-32))
Specifies the name of the host corresponding to the unit status file.
-u unit-identifier[Figure]<identifier> ((4 characters))
Specifies the identifier of the unit corresponding to the unit status file.

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

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

When the status file corresponding to a specific physical file is to be closed, specifies the absolute path name of the physical file. A physical file name must be specified in the format HiRDB-file-system-area-name/HiRDB-filename. This option is used in the event of an error in order to close the file version in STANDBY status, not the file version in shutdown status.

Rules

  1. The pdstscls command can be executed only while HiRDB is active.
  2. The pdstscls command must be executed at the server machine containing the single server or the server machine where the system manager is located.

Note

  1. The following are the pdstscls command's return codes:
    0: Normal termination
    8: Abnormal termination (such as an invalid option or rsh error)
  2. The result of the pdstscls 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 closed depends on the site at which the command is executed:
    • At the transaction execution site
      The status file for transaction processing is closed. The status file for log application processing cannot be closed.
    • At the log application site
      The status file for log application processing is closed. The status file for transaction processing cannot be closed.