Scalable Database Server, HiRDB Version 8 Command Reference

[Contents][Index][Back][Next]

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.
    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 the event log, eliminate the cause of the error, and then restart the service.
    • If the front-end server status is SUSPEND and does not change to ONLINE, an error may have occurred. See the message output to the event log, 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, the service has stopped. Before starting HiRDB, start the service.

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]: Service is running.
UNSETUP: Service is stopped.
[Figure]: One single-byte space.