CANCEL SESSION (Cancel one or more client sessions)

Use this command to cancel existing administrative or client node sessions, and to force an administrative or client node session off the server. Any outstanding mount requests related to this session are automatically cancelled. The client node must start a new session to resume activities.

If you cancel a session that is in the idle wait (IdleW) state, the client session is automatically reconnected to the server when it starts to send data again.

If this command interrupts a process, such as backup or archive, the results of any processing active at the time of interruption are rolled back and not committed to the database.

Privilege class

To issue this command, you must have system or operator privilege.

Syntax


>>-CANcel SEssion--+-session_number-+--------------------------><
                   '-ALl------------'

Parameters

session_number: Specifies the number of the administrative, server, or client node sessions that you want to cancel.
ALl: Specifies that all client node sessions are cancelled. You cannot use this parameter to cancel administrative client or server sessions.

Example: Cancel a specific client node session

Cancel the client node session with NODEP (session 3).

cancel session 3

Related commands

Table 1. Commands related to CANCEL SESSION
Command	Description
DISABLE SESSIONS	Prevents new sessions from accessing Tivoli Storage Manager but permits existing sessions to continue.
LOCK ADMIN	Prevents an administrator from accessing Tivoli Storage Manager.
LOCK NODE	Prevents a client from accessing the server.
QUERY SESSION	Displays information about all active administrator and client sessions with Tivoli Storage Manager.