pdls [-d rpc] (Display server communication control information)
Function
Displays communication control information about a communication-established server. This command can be used when it is necessary to determine whether processing control is on the HiRDB side or on the client side if the client stops responding during UAP operation.
Format
Options
Displays communication control information about all processes in the HiRDB system. This option can be used to determine details of communication control information.
Notes
- Return code 0 for the pdls -d rpc command indicates normal termination, and return code 8 indicates abnormal termination.
- Client information (process ID, IP address, UAP information, OS type, group name, XA interface usage status) is not displayed if the version of the client library that is linked with the UAP is earlier than 04-00.
- If the -a option is specified, the client OS type, the client group name, and the XA interface usage status are displayed if the server type is F or S, and the client is connected.
Output format
- Default option (UAP connected)
[aaaa]
Client Information :
PID ADDR NAME OS GROUP XA
bb...b cc...c dd...d e ff g
Server Information :
PID SVID STATUS SYS_EVENT USR_EVENT CRITICAL(MASK) SERVICE SYS_CALL
hh...h ii...i jj...j 0xkk...k 0xll...l m(0xnn...n) oo...o 0xtt...t
: : : : : : : :
[aaaa]
Client Information :
: |
- Default option (Utility connected)
[aaaa]
Server Information :
PID SVID STATUS SYS_EVENT USR_EVENT CLITICAL(MASK) SERVICE SYS_CALL
hh...h ii...i jj...j 0xkk...k 0xll...l m(0xnn...n) oo...o 0xtt...t
: : : : : : : :
[aaaa]
Server Information :
: |
- The -a option specified
HOSTNAME : ss...s
PID SVID STATUS SYS_EVENT USR_EVENT CLITICAL(MASK) SERVICE OS GROUP XA ..1
hh...h ii...i jj...j 0xkk...k 0xll...l m(0xnn...n) oo...o e ff Y ...2
CLTKIND SVRKIND CLTPID CLTADDR CLTNAME ACTID SYS_CALL .........................3
p q bb...b cc...c dd...d 0xrr...r 0xtt...t ............................4
: : : : : : : |
- Explanation
Items 1-4 are displayed in one line each. Items 2 and 4 are displayed repetitively for each process.
- aaaa
- Item number
- Bb...b
- Process ID of the client connected to a server process (in decimal, up to 10 digits)
- cc...c
- IP address of the client connected to a server process (up to 15 characters)
- dd...d
- UAP identification information for the client connected to a server process (up to 30 characters)
- Displays identification information about the UAP specified in the PDCLTAPNAME client environmental variable. If PDCLTAPNAME is not specified, the command displays Unknown.
- e
- Client operating system
- W
- Workstation-based client
- P
- PC-based client
- M
- Mainframe-based client
- ff
- Client group name (up to 2 characters) of the client connected to a server process.
- 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 |
DF | Distributed client |
PC | PC client |
WS | WS client |
MF | Mainframe-based client |
- g
- Use of X/Open XA interface
- Y
- Used
- N
- Not used
- hh...h
- Server process ID (up to 10 decimal digits)
- ii...i
- Server name (up to 8 characters)
- jj...j
- Process status display (up to 12 characters)
- ACTIVE
- currently processing
- SUSPEND (QUE)
- processing suspended (service wait state: queued)
- SUSPEND (CLT)
- processing suspended (waiting for next service)
- SUSPEND (SVR)
- processing suspended (waiting for other messages)
- kk...k
- Display of process status details (26 characters)
- Displays system internal code.
- ll...l
- Display of process status details (8 characters)
- Displays system internal code.
- mm...m
- Critical status display
- Y
- Critical
- N
- Not critical
- n
- Critical information display (8 hexadecimal digits)
- oo...o
- Service name display (up to 32 characters)
- Displays internal system information.
- p
- Client type
- C
- Client
- U
- Utility
- Blank
- Other than above
- q
- Server type (With -a option, displays a server type only when the client type is C.)
- F
- Front-end server (FES)
- B
- Back-end server (BES)
- D
- Dictionary server (DIC)
- S
- Single server (SDS)
- rr...r
- Activity ID (18 characters)
- This is not displayed for a process that does not have an activity ID.
- ss...s
- Host name (up to 32 characters)
- tt...t
- Internal information used by the system (8 characters)
Example of information verification
- SQL not responding
- If the STATUS is ACTIVE, the server is processing.
- To determine whether current control is with the client or the server:
- This can be determined based on the information indicated in the STATUS display on the front-end server (single server). If the STATUS display on the front-end server is SUSPEND (CLT), control is with the client.