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
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
- {-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.
- -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.
Rules
- The pdstsswap command can be executed only while HiRDB is active.
- 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
- The following are the pdstsswap command's return codes:
0: Normal termination
8: Abnormal termination (such as an invalid option or rsh error)
- The result of the pdstsswap command can be checked by the pdls command (with -d sts specified).
- 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.