LISTU, SORTU

The LISTU command lists the users currently in QM sorted by user number. The SORTU command is identical except that it sorts by user name.

Format

LISTU {DETAIL}

The LISTU command displays a list of users in QM. For each user, it shows their QM user number, the corresponding operating system process id and their network address or device name, user name and account name. The network address is shown as "Console" for console users (sessions running QM directly rather than a network connection) or "Phantom" for a background process. The login time is shown in the local time zone of the user executing the command.

The user executing the LISTU command is marked by an asterisk at the left edge of the displayed report. For phantom users, the parent user number is shown unless the original parent process has logged out. The parent user number is followed by "G" if the phantom process is grouped to logout with its parent.

Use of the DETAIL keyword adds a line at the start of the report that shows:

•the current number of interactive (terminal user) processes

•the current number of QMClient processes

•the current number of interactive phantom processes that consume a QM licence

•the current number of other phantom processes that do not consume a QM licence

•the peak number of processes that consumed a licence since QM was started. Note that on a system with device licensing, this figure can be lower than the current total process count.

The user count detail information can be retrieved in a QMBasic program using SYSTEM() with key value 1056 (SYS$USER.COUNTS).

Example

LISTU

 User  Pid     Puid  Login time    Origin : User name, Account

*    1  156           15 Apr 11:48  Console: ADMINISTRATOR, QMSYS

    2  186           15 Apr 11:21  193.118.13.10: JSMITH, SALES

    4  196        2  15 Apr 12:02  Phantom: ADMINISTRATOR, QMSYS

The example report above shows three processes logged on. The user running this command is marked with an asterisk.

Use of the DETAIL keyword might produce a report such as that below, showing the current count of each process type and the peak number of processes that were included in the licensed user count.

LISTU DETAIL

 2 interactive, 0 QMClient, 0 iPhantom, 1 phantom, 6 peak

 User  Pid     Puid  Login time    Origin : User name, Account

*    1  156           15 Apr 11:48  Console: ADMINISTRATOR, QMSYS

    2  186           15 Apr 11:21  193.118.13.10: JSMITH, SALES

    4  196        2  15 Apr 12:02  Phantom: ADMINISTRATOR, QMSYS

 
See also:

LIST.PHANTOMS, STATUS, !LISTU(), LGNWAIT configuration parameter