pdls [-d ust] (Display unit activity status)

Function

The pdls -d ust command displays a unit's activity status.

This command displays the activity status for only the unit where the command is executed.

Format

pdls -d ust

Option

None

Notes

  1. The following are the pdls -d ust command's return codes:
    0
    Unit is active (the front-end server can be connected if it is located at the unit where the command is executed).
    4
    Unit is starting (the front-end server is located at the unit where the command is executed, but the front-end server cannot be connected), or unit is stopping.
    8
    Restart of the process service was cancelled.
    12
    Unit is stopped (pdsetup -d command can be executed).
    16
    OS registration has been deleted.
  2. You should take one of the following actions when the unit status is PAUSE, or when the front-end server status is SUSPEND and does not change to ONLINE, or when the setup status is UNSETUP:
    • If the unit status is PAUSE, an error has occurred. See the KFPS00715-I message and the previous message output to syslogfile, eliminate the cause of the error, and then execute the pdrpause command.
    • If the front-end server status is SUSPEND and does not change to ONLINE, an error may have occurred. See the message output to syslogfile, eliminate the cause of the error, and then use the pdstart -a command to release the front-end server from SUSPEND status.
    • If the setup status is UNSETUP, HiRDB has not been registered in the OS. Before starting HiRDB, execute the pdsetup command and register HiRDB in the OS.

Output format

HOSTNAME  : aa...a(bbccdd)
SYSTEMID  : eeee
UNITID    : ffff
ENTRYHOST : gg...g
PAIRHOST  : hh...h
UNIT-STAT FES-STAT  SETUP-STAT
iiiiiiii       jjjjjjjj     kkkkkkk

Explanation
aa...a
Host name of the primary system (up to 32 characters)
bbccdd
Time the pdls command was executed (hour minute second)
eeee
HiRDB identifier (4 characters)
ffff
Unit identifier (4 characters)
gg...g
Host name of the unit where the pdls command was executed (up to 32 characters)
hh...h
Host name of the remote system (up to 32 characters) when the standby system switchover facility without IP address inheritance or the standby-less system switchover (1:1) facility is used.
Otherwise, this is blank.
iiiiiiii
Unit status (8 characters):
PAUSE[Figure][Figure][Figure]: Process server restart suspended
STOP[Figure][Figure][Figure][Figure]: Stopped
STARTING: Starting
ONLINE[Figure][Figure]: Running
STOPPING: Stopping
[Figure]: One single-byte space.
jjjjjjjj
Status of the front-end server (8 characters):
STOP[Figure][Figure][Figure][Figure]: Stopped
STARTING: Starting
SUSPEND[Figure]: Suspended
ONLINE[Figure][Figure]: Running
STOPPING: Stopping
********: Unit contains no front-end server
[Figure]: One single-byte space.
For a HiRDB/Single Server, ******** is always displayed.
kkkkkkk
Setup status (7 characters):
SETUP[Figure][Figure]: pdsetup has already been executed.
UNSETUP: pdsetup command has not been executed or the pdsetup -d command has already been executed (overwrite installation is available even when the installation directory is used for operation).
[Figure]: One single-byte space.