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 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. The following values are
possible:
- Standard
- Specifies that partial information displays for the session.
- Detailed
- Specifies that complete information displays for the session.
Example: List active client node sessions
Display
information about all administrative and client node sessions that
are communicating with the server. See
Field descriptions for field descriptions.
query session
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
Example: Display detailed information
about active client node sessions
Display information in full
detail about all administrative and client node sessions that are
communicating with the server. See
Field descriptions for field descriptions.
query session format=detailed
Sess Number: 77
Comm. Method: Tcp/Ip
Sess State: MediaW
Wait Time: 13 S
Bytes Sent: 2.2 K
Bytes Recvd: 1.8 K
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 )
Proxy By Storage Agent: mickeynode
User Name:
Date/Time First Data Sent: 07/08/08 18:01:21
Actions: BKIns
Failover Mode: Yes
Field descriptions
- Sess Number
- Specifies a unique session identification number
that is assigned by the server.
- Comm. Method
- Specifies the method that is used by the client
to communicate with the server.
- Sess State
- Specifies the current communications state of the
server. The following states are possible:
- 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 running 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 was already
sent).
- Start
- The session is starting (authentication is in progress).
- Wait Time
- Specifies the amount of time (seconds, minutes,
or hours) the server is in the current state shown.
- Bytes Sent
- Specifies the number of bytes of data that is sent
to the client node since the session was initiated.
- Bytes Recvd
- Specifies the number of bytes of data that is received
from the client node since the session was initiated.
- Sess Type
- Specifies the type of session in process: ADMIN for an administrative
session, NODE for a client node session, or SERVER. SERVER specifies
the server starts a session and initiates server-to-server operations
such as central configuration, library sharing, and storage agent
sessions.
- Platform
- Specifies the type of operating system that is
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. 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 storage pool volumes in addition to any copy
storage pool and active-data pool volumes along with their assigned
storage pool.
The server allows multiple sessions
to read and one session to write to a volume concurrently in a storage
pool that is associated with the FILE or CENTERA device type. As a
result, a volume in a storage pool with a device type of FILE or CENTERA
can appear as the current volume for more than one session.
- Proxy by Storage Agent
- Specifies the storage agent that is the proxy for LAN-free data
movement for the node.
- 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.
- Actions
- Displays a list of actions that are performed during
the session. An action is listed only once, even if the action occurs
multiple times during a session. The following actions are possible:
- BkIns
- One or more backup objects were stored on the server. The operation
might have been an incremental backup or a selective backup.
- BkUpd
- One or more attributes were updated for a backup object that is
stored on the server.
- BkDel
- One or more backup objects that are stored on the server are deleted.
- BkRebind
- One or more backup objects that are stored on the server are bound
to a different management class.
- NoQueryRestore
- A no-query restore operation was initiated from the client to
restore backed-up files from the server to the client system.
- ArIns
- One or more archive objects were stored on the server.
- ObjRtrv
- One or more files were retrieved from the server. This might
have been to retrieve archive files, or to restore backup data (except
for backup data from a no-query restore operation).
- MigIns
- One or more files are migrated and stored on the server by Tivoli® Storage
Manager for Space Management (HSM client).
- MigDel
- One or more space-managed files that were stored on the server
are deleted.
- MigRebind
- One or more space-managed files that are stored on the server
are bound to a different management class.
- MigRecall
- One or more space-managed files that are stored on the server
are recalled.
- MigUpd
- The attributes for one or more space-managed files that are stored
on the server are updated.
- FSAdd
- The client node added one or more new file spaces to server storage.
- FSUpd
- The client node updated attributes for one or more file spaces
that are defined to the server.
- DefAuth
- A SET ACCESS command is processed by the client
node, which caused an authorization rule for access to the client
node's data to be added.
- Failover Mode
- Specifies whether the client session was started in failover mode.
The following values are possible:
- Force
- The FORCEFAILOVER flag is specified on the
client and the session is forced into failover mode.
- Yes
- The client session was started in failover mode.
- No
- The client session was not started in failover mode.
Related commands
Table 1. Command related to QUERY SESSIONCommand |
Description |
CANCEL SESSION |
Cancels active sessions with the server. |