Event processing adapter - EPADAPT

The Event processing adapter (EPADAPT) views display information about a specified event processing adapter.

Supplied views

To access from the main menu, click:

CICS operations views > Application operations views > Event processing adapter

Table 1. Views in the supplied Event processing adapter (EPADAPT) view set
View Notes
Event processing adapter

EYUSTARTEPADAPT.DETAILED

Detailed information about the selected Event Processing Adapter.
Event processing adapter

EYUSTARTEPADAPT.DETAILED1

Detailed information about the Event Processing Adapter resource signature.
Event processing adapter

EYUSTARTEPADAPT.DISABLE

Disable an event processing adapter. When disabled, the event processing adapter and its associated resources are not available to CICS.
Event processing adapter

EYUSTARTEPADAPT.ENABLE

Enable an event processing adapter. When enabled, the event processing adapter and its associated resources are available to CICS.
Event processing adapter

EYUSTARTEPADAPT.SET

Set attribute according to values specified in input fields.
Event processing adapter

EYUSTARTEPADAPT.TABULAR

Tabular information about event processing adapter.

Actions

Table 2. Actions available for EPADAPT views
Action Description
DISABLE Disable an event processing adapter. When disabled, the event processing adapter and its associated resources are not available to CICS.
ENABLE Enable an event processing adapter. When enabled, the event processing adapter and its associated resources are available to CICS.
SET Set attribute according to values specified in input fields.

Fields

Table 3. Fields in EPADAPT views
Field Attribute name Description
Adapter type ADAPTERTYPE Indicates the type of the EPADAPTER. Values are:
  • CUSTOM
    • A user-written event processing adapter that emits events in any format that you require to any destination.
  • HTTP
    • The IBM supplied HTTP event processing adapter that emits events to an HTTP server for consumption by products such as IBM Operational Decision Manager and IBM Business Monitor.
  • TDQUEUE
    • The IBM supplied TDQ event processing adapter that emits events to a named CICS TD queue.
  • TRANSTART
    • The IBM supplied Transaction Start event processing adapter that emits events to a named CICS transaction.
  • TSQUEUE
    • The IBM supplied TSQ event processing adapter that emits events to a named CICS TS queue.
  • IBM MQ
    • The IBM supplied IBM MQ event processing adapter that emits events to an IBM MQ Queue for consumption by products such as IBM Operational Decision Manager and IBM Business Monitor.
Authority AUTHORITY Indicates the Authority of the event processing adapter. Values are:
  • CONTEXT
    • The event processing adapter runs using the user ID of the task that caused the event to be captured. This is always the case when EMITMODE is SYNCHRONOUS or when 'Use Context User ID' is specified for the event processing adapter.
  • REGION
    • The event processing adapter runs using the CICS region user ID.
  • USERID
    • The event processing adapter is attached using the identifier specified in the event processing adapter 'User ID' and returned in the AUTHUSERID attribute.
  • DEFAULT
    • The EP adapter runs using the CICS default user ID.
Authority user ID AUTHUSERID The 8-character user identifier to be used to start the event processing adapter transaction. This attribute is only set if AUTHORITY is USERID.
Bundle name BUNDLE Name of the bundle from which the event processing adapter is installed.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This field is not applicable for this resource.
  • OVERRIDE - Resource was last changed by resource overrides.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
Event processing adapter configuration data CONFIGDATA1 A 64-character data area containing the primary configuration data item for the event processing adapter. If the primary configuration data item is less than 64 bytes, the field is padded with blanks. The data item returned is dependent upon ADAPTERTYPE, as follows:
  • CUSTOM
    • The first 64 bytes of custom event processing adapter configuration data.
  • HTTP
    • The 8-character name of the URIMAP definition to be used by an HTTP event processing adapter to locate the HTTP server.
  • TDQ
    • The 4-character name of the transient data queue for the event emitted by a TDQ event processing adapter.
  • TRANSTART
    • The 4-character name of the event consumer transaction that is started by a Transaction Start event processing adapter.
  • TSQ
    • The 16-character name of the temporary storage queue for the event emitted by a TSQ event processing adapter.
  • IBM MQ
    • The 48-character name of the IBM MQ queue for event messages emitted by this IBM MQ event processing adapter. This data is in the code page defined by the LOCALCCSID system initialization parameter.
Event format DATAFORMAT The format of events emitted by this event processing adapter. Values are:
  • USER
    • The format is user-defined.
  • CBER
    • Common Base Event REST format for the IBM Business Monitor REST HTTP server.
  • CBE
    • Common Base Event format for consumption by products such as IBM Business Monitor.
  • CCE
    • CICS Container Event format.
  • CFE
    • CICS Flattened Event format.
  • DSIE
    • Decision Server Insights Event format.
  • WBE
    • WebSphere Business Events XML format.
Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
Emission mode EMITMODE The event emission mode of this event processing adapter. Values are:
  • ASYNCHRONOUS
    • Event emission is asynchronous of the capturing transaction. The unit of work for the capturing transaction might complete successfully even when the event is not emitted.
  • SYNCHRONOUS
    • Event emission is synchronous with the capturing transaction. The unit of work for the capturing transaction does not complete successfully when the event is not emitted.
Enabled status ENABLESTATUS Indicates whether the event processong adapter is enabled or not. Values are:
  • DISABLED
    • The event binding is not enabled.
  • ENABLED
    • The event binding is enabled.
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • BUNDLE - The resource was installed by a bundle deployment.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
Invoke type INVOKETYPE Indicates how the event processing adapter is invoked. Values are:
  • ATTACH
    • The event processing adapter is attached as a separate task.
  • LINK
    • The event processing adapter program is linked to.
Name NAME Specifies the name of this event processing adapter. The name can be up to 32 characters in length.
Priority PRIORITY Indicates the dispatching priority of event emission for this event processing adapter. This attribute is ignored when EMITMODE is SYNCHRONOUS. Values are:
  • HIGH
    • Events emitted for this event processing adapter are high priority.
  • NORMAL
    • Events emitted for this event processing adapter are normal priority.
Program PROGRAM The 8-character name of the event processing adapter program. If the ADAPTERTYPE is CUSTOM, this attribute is only applicable if INVOKETYPE is LINK.
Number of events emitted PUTEVENTS The number of events that have been emitted by this event processing Adapter.
Transaction TRANSACTION The 4-character name of the transaction definition that is used if the event processing adapter transaction is attached. The TRANSACTION attributes is only applicable if INVOKETYPE is ATTACH.
Transactionality TRANSMODE Indicates the event transactionality attribute of this event processing adapter. Values are:
  • NONTRANS
    • Events are not transactional. Events can be emitted regardless of whether the unit of work for the capturing transaction completes successfully.
  • TRANS
    • Events are transactional. Events can be emitted only when the unit of work for the capturing transaction completes successfully.