Administrator's Reference

QUERY SESSION (Query Client Sessions)

Use this command to display information on one or more administrative and client node sessions.

Privilege Class

Any administrator can issue this command.

Syntax

                                 .-Format--=--Standard-----.
>>-Query SEssion--+---------+----+-------------------------+---><
                  '-sessnum-'    '-Format--=--+-Standard-+-'
                                              '-Detailed-'
 

Parameters

sessnum
Specifies the number of the administrative or client node session to query. This parameter is optional. If you do not specify a value for this parameter, all sessions display.

Format
Specifies how the information displays. This parameter is optional. The default value is STANDARD. Possible values are:

Standard
Specifies that partial information displays for the session.

Detailed
Specifies that complete information displays for the session.

Examples

Task 1

Display information on all administrative and client node sessions that are communicating with the server.

Command:
query session

Output:
 

+--------------------------------------------------------------------------------+
|  Sess Comm.  Sess     Wait   Bytes   Bytes Sess  Platform Client               |
|Number Method State    Time    Sent   Recvd Type           Name                 |
|------ ------ ------ ------ ------- ------- ----- -------- ------               |
|    77 TCP/IP Run      0 S      134     159 Admin OS/2     ADMIN                |
+--------------------------------------------------------------------------------+

See Task 2 for parameter definitions.

Task 2

Display information in full detail about all administrative and client node sessions that are communicating with the server.

Command:
query session format=detailed

Output:

+--------------------------------------------------------------------------------+
|        Sess Number: 77                                                         |
|       Comm. Method: Tcp/Ip                                                     |
|         Sess State: Run                                                        |
|          Wait Time: 0 S                                                        |
|         Bytes Sent: 409                                                        |
|        Bytes Recvd: 202                                                        |
|          Sess Type: Admin                                                      |
|           Platform: OS/2                                                       |
|        Client Name: ADMIN                                                      |
|Media Access Status: MediaW                                                     |
|          User Name:                                                            |
|                                                                                |
+--------------------------------------------------------------------------------+

where:

Sess Number
Specifies a unique session identification number assigned by the server.

Comm. Method
Specifies the method being used by the client to communicate with the server.

Sess State
Specifies the current communications state of the server. Possible states are:

End
The session is ending (session resources are released).

IdleW
Waiting for client's next request (session is idle).

MediaW
The session is waiting for access to a sequential access volume.

RecvW
Waiting to receive an expected message from the client.

Run
The server is executing a client request (and not waiting to send data).

SendW
The server is waiting to send data to the client (waiting for data to be delivered to the client node that has already been sent).

Start
The session is starting (authentication is in progress).

Wait Time
Specifies the amount of time (seconds, minutes, or hours) the server has been in the current state shown.

Bytes Sent
Specifies the number of bytes of data sent to the client node since the session was initiated.

Bytes Recvd
Specifies the number of bytes of data received from the client node since the session was initiated.

Sess Type
Specifies the type of session in process: either ADMIN for an administrative session, or NODE for a client node session.

Platform
Specifies the type of operating system associated with the client.

Client Name
Specifies the name of the client node or the administrator.

Media Access Status
Specifies the type of media wait state. This information is only provided when the session state equals MediaW.

User Name
Specifies the user ID of the node, on a multi-user system, that connects to the server when it is not the same system user who originally connected to the server.

Related Commands

Table 188. Command Related to QUERY SESSION

Command Description
CANCEL SESSION Cancels active sessions with the server.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]