LISTU

LISTU

Top  Previous  Next

 

The LISTU command lists the users currently in QM.

 

 

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.

 

The user count detail information can be retrieved in a QMBasic program using SYSTEM(1056).

 

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