SET EVENTBINDING

Set the status of a specified event binding to enabled or disabled.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

SET EVENTBINDING

Read syntax diagramSkip visual syntax diagramSET EVENTBINDING( data-value)ENABLESTATUS( cvda)ENABLEDDISABLED

Conditions: INVREQ, NOTAUTH, NOTFND

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations. For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

This command is threadsafe.

Description

Use the SET EVENTBINDING command to change the status of a particular event binding. If installation of the EVENTBINDING caused an EPADAPTER of the same name to also be installed, the state of the related EPADAPTER, if still available, is unaffected.

Options

EVENTBINDING (data-value)
Specifies the 32-character name of an event binding.
ENABLESTATUS (cvda)
Specifies whether events matching capture specifications in this event binding are captured and emitted. CVDA values are as follows:
ENABLED
The event binding is enabled. Capture of events matching capture specifications in this event binding starts immediately.
DISABLED
The event binding is disabled. Capture of events matching capture specifications in this event binding is stopped immediately. Any events already captured are emitted.

Conditions

INVREQ
RESP2 values are:
4
ENABLESTATUS has an invalid CVDA value.
NOTAUTH
RESP2 values are:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to update the event binding.
NOTFND
RESP2 values are:
3
The specified event binding cannot be found.