pdstsswap (Swap status files)

Function

The pdstsswap command swaps status files. It changes the current status file to a spare status file and a spare status file to the current status file.

Executor

HiRDB administrator

Format

Unit status file

pdstsswap [-x host-name|-u unit-identifier}]

Server status file

pdstsswap -s server-name

Unit status file

pdstsswap {-x host-name|-u unit-identifier}

Server status file

pdstsswap -s server-name

Options

When unit status files are to be swapped, specifies the identifier of the unit or the name of the host corresponding to the unit status files. 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 files.
-u unit-identifier[Figure]<identifier> ((4 characters))
Specifies the identifier of the unit corresponding to the unit status files.

When server status files are to be swapped, specifies the name of the server corresponding to the server status files.

Rules

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