Tivoli Storage Manager for HP-UX Administrator's Reference

QUERY SESSION (Query Client Sessions)

Use this command to display information about administrative and client node sessions.

Privilege Class

Any administrator can issue this command.

Syntax

>>-Query SEssion--+---------+----------------------------------->
                  '-sessnum-'
 
>-----+-------------------------------+------------------------->
      '-MINTIMethreshold--=--minutes--'
 
>-----+-----------------------------------------+--------------->
      '-MAXTHRoughput--=--kilobytes_per_second--'
 
      .-Format--=--Standard-----.
>-----+-------------------------+------------------------------><
      '-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.

MINTIMethreshold
Specifies to display sessions that have had at least this number of minutes elapse from the time the client sent data to the server for storage. This parameter is optional. The minimum number of minutes is 1. The maximum number of minutes is 99999999.

MAXTHRoughput
Specifies to display sessions that are transferring data at a rate less than this number of kilobytes per second. This parameter is optional. The minimum number of kilobytes per second is 0. The maximum number of kilobytes per second is 99999999.

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:                                                      |
|Date/Time First Data Sent:                                                      |
|                                                                                |
+--------------------------------------------------------------------------------+

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.

Date/Time First Data Sent
Specifies the date and time that the client first sent data to the server for storage.

Related Commands

Table 189. 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 ]