(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.
(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
- The items from STATUS (server's activity status) to C-GRP (client group name of the client connected to a server process) are separated by at least one single-byte space.
- 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 right-aligned decimal digits in AIX or HP-UX (IPF); up to five right-aligned decimal digits in any other OS if the value is 99999 or less, and up to 10 left-aligned decimal digits if the value is 100000 or more)
- In any OS other than AIX or HP-UX (IPF), if the value is 100000 or more, the items that follow the message sequence number within the process are shifted to the right.
- gg...g
- User ID (up to five right-aligned decimal numerics if the value is 99999 or less, and up to 10 left-aligned decimal numerics if the value is 100000 or more)
- If the value is 100000 or more, the items that follow GID (group ID) are shifted to the right.
- hh...h
- Group ID (up to five right-aligned decimal numerics if the value is 99999 or less, and up to 10 left-aligned decimal numerics if the value is 100000 or more)
- If the value is 100000 or more, the items that follow SVID (server name) are shifted to the right.
- 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.
- ******** is displayed for the following processes:
- Process under start or stop processing
- System server process
- nn...n
- Process ID of the client (UAP or utility) that was connected to the server process (up to 10 left-aligned 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 name | Client type |
---|
XA | X/Open XA interface |
PC | PC client |
WS | WS client |
MF | Mainframe-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.
- Output example
- When a process ID of 100000 or more is subject to display in AIX or HP-UX (IPF):
HOSTNAME : HOST0001(151654)
STATUS PID UID GID SVID TIME PROGRAM C-PID C-GRP
L 38095 1108 700 SERVER01 151643 uap0001 7040(10.1.0.1) WS
... Process ID is 99999 or less
L 108221 1108 700 SERVER01 999999
... Process ID is 100000 or more
L 8101 1108 700 SERVER01 999999
... Process ID is 99999 or less |
(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)