2.99 pdstsswap (Swap status files)

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

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

(2) Executor

HiRDB administrator

(3) Format

(a) HiRDB/Single Server
Unit status file

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

Server status file

pdstsswap -s server-name

(b) HiRDB/Parallel Server
Unit status file

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

Server status file

pdstsswap -s server-name

(4) Options

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

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 ~<identifier> ((1-32))
Specifies the name of the host corresponding to the unit status files.
-u unit-identifier ~<identifier> ((4 characters))
Specifies the identifier of the unit corresponding to the unit status files.
(b) -s server-name ~<identifier> ((1-8))

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

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

(6) Notes

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