DISABLE SESSIONS (Prevent new sessions from accessing IBM Spectrum Protect)

Use this command to prevent new sessions from accessing IBM Spectrum® Protect. Active sessions will complete. For a particular server, you can specify whether to disable inbound sessions, outbound sessions, or both.

Server processes, such as migration and reclamation, are not affected when you issue the DISABLE SESSIONS command.

Privilege class

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

Syntax

Read syntax diagramSkip visual syntax diagramDISAble SESSionsCLIentCLIentALLADMinSERVerserver_nameDIRection=BothDIRection=BothDIRection=INboundDIRection=OUTbound

Parameters

Specifies the type of session to be disabled. This parameter is optional. The default value is CLIENT. You can specify one of the following values:

CLIent
Disables only backup and archive client sessions.
ALL
Disables all session types.
ADMin
Disables only administrative sessions.
SERVer
Disables only server-to-server sessions. Only the following types of sessions are disabled:
  • Server-to-server event logging
  • Enterprise management
  • Server registration
  • LAN-free: storage agent - server
  • Virtual volumes
  • Node replication

You can also specify whether to disable inbound sessions, outbound sessions, or both for a particular server.

server_name
Specifies the name of a server whose sessions you want to disable. This parameter is optional. If you do not specify this parameter, new sessions with other servers do not start. Running sessions are not canceled.
DIRection
Specifies whether to disable inbound sessions, outbound sessions, or both. This parameter is optional. The default is BOTH. The following values are possible:
Both
Specifies that inbound sessions from the specified server and outbound sessions to the specified server are disabled.
INbound
Specifies that only inbound sessions from the specified server are disabled.
OUTbound
Specifies that only outbound sessions to the specified server are disabled.

Example: Prevent new client node backup and archive sessions on the server

Temporarily prevent new client node sessions from accessing the server.
disable sessions

Example: Prevent all new sessions on the server

Temporarily prevent any new sessions from accessing the server.
disable sessions all

Example: Disable outbound sessions to a server

Disable outbound sessions to a server named REPLSRV.
disable sessions server replsrv direction=outbound

Related commands

Table 1. Commands related to DISABLE SESSIONS
Command Description
CANCEL SESSION Cancels active sessions with the server.
DISABLE REPLICATION Prevents outbound replication processing on a server.
ENABLE SESSIONS Resumes server activity following the DISABLE command or the ACCEPT DATE command.
QUERY SESSION Displays information about all active administrator and client sessions with IBM Spectrum Protect.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.