pdls [-d prc] (Display server process status)

Function

Displays server processing status.

Format

pdls -d prc [{-a | -s server-name}] [-c]

Options

Specifies -a to display information about all servers in the HiRDB system (including servers used internally by HiRDB), or specifies -s and a server name to display information about the specified server only. When this option is omitted, information about all servers except for servers used internally by HiRDB is displayed.

-a
Specifies that the processing status of all servers in the HiRDB system is to be displayed, including servers used internally by HiRDB.
-s server-name[Figure]<identifier> ((1-8))
Specifies the name of a server whose processing status is to be displayed.

Specifies that the process's operating status (whether or not the process is scheduled to stop) is to be displayed.

Use this option to check the process's stop status after using the pdpfresh command to refresh the process.

Notes

  1. Return code 0 for the pdls -d prc command indicates normal termination, and return code 8 indicates abnormal termination.

Output format

HOSTNAME:  aa...a(bbccdd)
STATUS PID    UID    GID   SVID  TIME   PROGRAM  C-PID      C-GRP
e      ff...f    gg...g   hh...h  ii...i   jjkkll   mm...m    nn...n(oo...o)  pp
:       :       :       :     :     :       :

Explanation
aa...a
Host name (up to 32 characters).
bbccdd
Time of pdls command execution (hour:minute:second).
e
Server's activity status:
D
Server is engaged in startup or termination processing
L
Server is active
C
Process is stopping or scheduled to stop (displayed when the -c option is specified)
ff...f
Process ID (up to 10 decimal digits).
gg...g
User ID (up to 5 decimal digits).
hh...h
Group ID (up to 5 decimal digits).
ii...i
Server name (up to 8 characters).
jjkkll
Time the service request was accepted (hour:minute:second).
If the server is not connected to a UAP, 999999 is displayed.
mm...m
UAP identification information (up to 30 characters).
The UAP's identification name as specified in PDCLTAPNAME in the client environment definition is displayed.
However, the display is in the following format for servers currently executing the distributed server function for a distributed database:
RDAUSER-AA...A
AA...A
Authorization identifier (up to 8 characters)
This is the authorization identifier specified by the system at the distributed client in order to connect to the HiRDB at the distributed server.
For an object other than a server, ****** is displayed.
If PDCLTAPNAME is undefined, Unknown is displayed.
nn...n
Process ID of the client (UAP or utility) that was connected to the server process (up to 10 decimal digits).
This information is applicable only to the server process that was connected to the client; it is not displayed for a server process that was not connected to the client. This information is not displayed if the version of the client library connected to the UAP is earlier than 04-00.
oo...o
IP address of the client (UAP or utility) that was connected to the server process (up to 15 characters).
This information is applicable only to the server process that was connected to the client; it is not displayed for a server process that was not connected to the client. This information is not displayed if the version of the client library connected to the UAP is earlier than 04-00.
pp
Client group name (up to 2 characters) of the client connected to a server process. Only server processes that are connected to a client can be specified in this operand. Server processes that are not connected to a client are not displayed. Any client libraries linked to a UAP and having a version older than 04-00 are not displayed.
When using one character, specify a user-assigned client group name; when using two characters, specify a HiRDB-supplied client group name by client type. Following is a list of HiRDB-supplied client group names by client type:
Client group nameClient type
XAX/Open XA interface
DFDistributed client
PCPC client
WSWS client
MFMainframe-based client
Notes
If a server process has just been activated, blanks and ****** may be displayed as the server name and the UAP identification information, respectively.
When the status of a HiRDB command process is being displayed, 0 is displayed as both the user ID and the group ID.