Terminal Server Commands: QUERY

SUMMARY

QUERY replaces QUSER, QPROCESS, QOBJECT, QAPPSERV, QWINSTA from Citrix Winframe.

The query utilities are used to display current information about the system such as the current allocation of resources and system status. The query command can invoke any one of the query utilities. The command line format is:

query [appservers | object | process | session | user] [/?]
/? (help)
				

Syntax

Query Appservers:

Query appservers [servername] [/domain:domainname] [/address] [/continue] [/?]

Parameters

servername /domain:domainname /address /continue /? (help)

Query Appservers -- Additional Notes

Query Appservers searches the network for all attached application servers and returns the following information:

The servername. The network and node address (if the /address option is used).

The following is an example for query appservers:

   C:\>query appserversAPPLICATION SERVERfast_eddieengineeringaccess_1
   *brand_x
				

The asterisk (*) indicates the current servername. APPLICATION SERVER identifies the servername.

Query Appservers -- Examples

To display information about all application servers found on the network, type: To display information about the fasteddie application server, type: To display information about all application servers in domain SYSTEM, type: To display the network and node address for the NABBY application server, type:

Syntax

Query Object: query object [Objectname] [/device] [/?]

Parameters

Objectname /device /? (help)

Query Object -- Examples

To display information about the objects that are in the \Driver namespace, type: To display information about the objects that are in the \DosDevices namespace in a modified format, type:

Syntax

Query Process: query process [processID] [/server:servername] [/system] [/?]
query process[username] [/server:servername] [/system] [/?]
query process[sessionname] [/server:servername] [/system] [/?]
query process[/ID:sessionID] [/server:servername] [/system] [/?]
query process[programname] [/server:servername] [/system] [/?]
query process[*] [/system] [/server:servername] [/?]

Parameters

processID username sessionname /ID:sessionID programname /server:servername /system /? (help)

Security Restrictions

Query process is used to query only those processes belonging to the current user, unless the current user has sufficient security classification to query processes belonging to other users. Administrators have full access to all query process functions.

Query Process -- Additional Notes

If no process or session is specified, query process queries all processes belonging to the current user. If a session is specified, it must identify an active session. You can use wildcards to identify the process. If a single wildcard is present (*), all processes in the system are identified.

Query process returns the following information:

  The user that owns the process.
  The session that owns the process.
  The ID of the session.
  The process name.
  The process state.
  The ID of the process.
				

The following is an example for query process:

   C:>query process
   USERNAME SESSION ID STATE PID
   >edj rdp-tcp#002 0 wait 353 progman.exe
   >edj rdp-tcp#002 0 wait 49 cmd.exe
   >edj rdp-tcp#002 0 wait 139 query.exe
   >edj rdp-tcp#002 0 run 375 qprocess.exe
				

The > character identifies the current user. Session identifies the session where the user is logged on the system. ID specifies the ID of the session.

State indicates the state of the process. PID identifies the processID of the program that follows.

Query Process -- Examples

To display information about process 8, type: To display information about all processes for user EDDIEJ, type: To display information about all processes in session rdp-tcp#002, type: To display information about all processes in session 4, type: To display information about the process Netclient.exe, type: To display information about all processes in the system, type: To displays information about all processes on the system, including system processes, type:

Syntax

Query Session: Query session [sessionname] [/server:servername] [/mode] [/flow] [/connect] [/?]
Query session[username] [/server:servername] [/mode] [/flow] [/connect] [/?]
Query session[sessionID] [/server:servername] [/mode] [/flow] [/connect] [/?]

Parameters

sessionname username sessionID /server:servername /mode (session mode) /flow (flow control) /connect (connect settings) /? (help)

Security Restrictions

A user can always query the session where the user is currently logged on. The user must have Query Information access permission to query other sessions.

Query Session -- Additional Notes

If no session is specified, query session displays all active sessions in the system. Otherwise, the session must identify an active session.

The following is an example for query session:

   C:>query session
   SESSION USERNAME ID STATE TYPE DEVICE
   >console administrator 0 active
   rdp-tcp#003 eddiej 1 active
   rdp-tcp 2 listen
   rdp-tcp 3 listen
   rdp-tcp 4 idle 5 idle
				

The > character identifies the current session. Session specifies the session name. Username identifies the name of the user connected at the session, if any. ID identifies the ID of the session connected to the system, if any. State provides information on the current state of the session and can be any of the following:

   Active. The session is connected and active.
   Conn. The session is connected. No user is logged on.
   ConnQ. The session is in the process of connecting. If this state
        continues, it indicates a problem with the connection.
   Shadow. The session is shadowing another session.
   Listen. The session is ready to accept a client connection.
   Disc. The session is disconnected.
   Idle. The session is initialized.
   Down. The session is down, indicating the session failed to initialize correctly.
   Init. The session is initializing.
				

Type indicates the session type. Device is the device name assigned to the session (not present for the console or network-connected sessions). The comment following the session information is from the profile.

A session initially configured as disabled does not show up in the query session list until it is enabled.

Query Session -- Examples

To display information about all active sessions on server ACCTG, type: To display information about session MODEM02, if it is active, type:

Syntax

Query User: query user [username] [/server:servername] [/?]
query user[sessionname] [/server:servername] [/?]
query user[sessionID] [/server:servername] [/?]

Parameters

username sessionname sessionID /server:servername /? (help)

Security Restrictions

A user must have Query Information access permission to query other users.

Query User -- Additional Notes

Displays information about users who are logged on the system. Users who are not logged on the system are not included.

If no user or session is specified, query user displays all users who are logged on the system. The session must identify an active session.

Query user returns the following information:

   The name of the user
   The name of the session
   The ID that identifies the session
   The state of the session (active or disconnected)
   The idle time-the time since a keystroke or mouse movement was received
    at the session
   The logon time, when the user logged on the system
				

The following is an example for query user:

   C:\>query user
   USERNAME SESSION ID STATE IDLE TIME LOGON TIME
   admin console 0 active 55 10/07/94 17:30
   >edj rdp-tcp#004 4 active 10/10/94 09:03
				

The > character indicates the current user. Username identifies the user. Session identifies the session where the user is logged on the system. ID identifies the session. Idle time is a measure of interaction between the user and the system by indicating the time in minutes since the last keystroke or mouse movement. A dot (.) indicates that the time is less than a minute. Logon time is the time when the user logged on the system.

Query User -- Examples

To display information about all users logged on the system, type: To display information about the user EDJ on server WF06, type: To display information about the user at session rdp-tcp#001, type: