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 canceled. 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

Read syntax diagramSkip visual syntax diagramCANcel SEssionsession_numberALl

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 canceled. 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 IBM Spectrum Protect but permits existing sessions to continue.
LOCK ADMIN Prevents an administrator from accessing IBM Spectrum Protect.
LOCK NODE Prevents a client from accessing the server.
QUERY SESSION Displays information about all active administrator and client sessions with IBM Spectrum Protect.