Tivoli Header
Administrator's Reference
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: MediaW |
| Wait Time: 13 S |
| Bytes Sent: 648 |
| Bytes Recvd: 167 |
| Sess Type: Node |
| Platform: AIX |
| Client Name: N25XY |
| Media Access Status: Waiting for mount of output volume: |
| COPYVOL1, 8MMPOOL ( 12 seconds ) |
| |
| Waiting for mount point: |
| 8MMCLASS, ONSITEPOOL ( 45 seconds ) |
| |
| Waiting for output volume: |
| COPYVOL2, OFFSITEPOOL ( 30 seconds ) |
| User Name: |
|Date/Time First Data Sent: 07/12/01 13:54:18 |
| |
+--------------------------------------------------------------------------------+
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. When a session is in a media wait state, this field displays a list
of all mount points and sequential volumes for the session. The list of
mount points specifies the device class and the associated storage
pool. The list of volumes specifies the primary and any copy storage
pool volumes along with their assigned storage pool.
- 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 214. 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 ]