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

Organization of this section
(1) Function
(2) Format
(3) Options
(4) Notes
(5) Output format

(1) Function

Displays server processing status.

(2) Format

pdls -d prc [{-a | -s server-name}] [-c] [-C [-H]]
[{-x host-name[,host-name]...|-u unit-identifier[,unit-identifier]...}]

(3) Options

(a) {-a | -s server-name}

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 ~<identifier> ((1-8))
Specifies the name of a server whose processing status is to be displayed.
(b) -c

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.

(c) -C

Specifies that the server process status is to be output in DAT format.

(d) -H

Specifies that a title line is to be output (applicable when the -C option is specified).

(e) -x host-name[,host-name]...

Specifies the names of hosts whose information is to be displayed.

If this option is specified together with the -s option, the -s option is effective and the -x option is ignored. If you specify multiple host names, there must be no spaces before or after a delimiter comma.

(f) -u unit-identifier[,unit-identifier]...

Specifies units whose information is to be displayed.

If this option is specified together with the -s option, the -s option is effective and the -u option is ignored. If you specify multiple unit names, there must be no spaces before or after a delimiter comma.

(4) Notes

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

(5) Output format

(a) When the -C option is omitted

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).
If the process is a user server, the value shown below is displayed. If the process is not connected, nothing is displayed (in DAT format, the null element is displayed). If single-byte spaces are specified at the end of PDCLTAPNAME, the value is displayed in DAT format with those single-byte spaces deleted.
  • When PDCLTAPNAME is specified in the client environment definition
    The value specified in PDCLTAPNAME is displayed.
  • When PDCLTAPNAME is not specified in the client environment definition
    Unknown is displayed.
If the process is not a user server, ******** is displayed.
nn...n
Process ID of the client (UAP or utility) that was connected to the server process (up to 10 decimal digits).
The process ID is not displayed for a server process that was not connected to the client (in DAT format, the null element is displayed). The value 0 is displayed as the process ID in the following cases:
  • The version of the client library connected to the UAP is earlier than 04-00
  • Connection is made from a Type4 JDBC driver
oo...o
IP address of the client (UAP or utility) that was connected to the server process (up to 15 characters).
The IP address, including the parentheses, is not displayed for a server process that was not connected to the client (in DAT format, the null element is displayed).
pp
Client group name (up to 2 characters) of the client connected to a server process.
The client group name is not displayed for a server process that was not connected to the client (in DAT format, the null element is 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
PCPC client
WSWS client
MFMainframe-based client
Notes
If a server process has just been activated, nothing or ****** might be displayed as the server name (in DAT format, the null element might be displayed). When the status of a HiRDB command process is being displayed, 0 is displayed as both the user ID and the group ID.
(b) When the -C -H option is specified

"EDIT-TIME","HOSTNAME","STATUS","PID","UID","GID","SVID","TIME","PROGRAM","C-PID",
"C-ADDR","C-GRP"
"qq...q","aa...a","e",ff...f,gg...g,hh...h,"ii...i","jjkkll","mm...m",nn...n,
"oo...o","pp"

Explanation

For explanations of aa...a through pp, see the information above for when the -C option is omitted.

For the rules for output in DAT format, see 1.5.3 Rules for output of command execution results in DAT format.

One line displays information about one server process.

qq...q:
Time the pdls command was executed, in the format YYYY/MM/DD hh:mm:ss (4-digit-year/month/date hour:minute:second)