2.62 pdls [-d act] (Display user status)

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

(1) Function

Displays user status.

(2) Format

pdls -d act [-s server-name]
[{-x host-name[,host-name]...|-u unit-identifier[,unit-identifier]...}]

(3) Option

(a) -s server-name ~<identifier> ((1-8))

Specifies that the status of users in the specified server is to be displayed. When this option is omitted, the status of users associated with all servers in the HiRDB system is displayed.

(b) -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.

(c) -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 act command indicates normal termination, and return code 8 indicates abnormal termination. When the return code is 8, see the previous message and eliminate the cause of the error.

(5) Output format

HOSTNAME : aa...a(bbccdd)
SVID    PID    ACTID                 LOCK-STATE
ee...e  ff...f gg...g-hh...h-ii...i  j

Explanation
The items from SVID (server name) to LOCK-STATE (lock hold status of UNTIL DISCONNECT specification) are separated by at least one single-byte space.
aa...a
Host name (up to 32 characters)
bbccdd
Time when pdls command was executed (hour:minute:second)
ee...e
Server name (up to 8 characters)
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.
0 is displayed in the case of user information recovered by a unit restart.
gg...g-hh...h-ii...i:
User identification number (up to 22 characters)
If this value is more than 21 characters in AIX or HP-UX (IPF), or if it is more than 19 characters in any other OS, the items that follow LOCK-STATE (lock hold status of the UNTIL DISCONNECT specification) are shifted to the right.
j
Lock hold status of UNTIL DISCONNECT specification:
Y
Lock is held
N
Lock is not held
Output example
When a process ID of 100000 or more is subject to display in AIX or HP-UX (IPF):

HOSTNAME : HOST0001(144031)
SVID      PID     ACTID              LOCK-STATE
SERVER01  38095   16-1-1             N      ... Process ID is 99999 or less
SERVER01  108221   16-1-2            N      ... Process ID is 100000 or more
SERVER01   8101   16-1-3             N      ... Process ID is 99999 or less