Start of change

Event binding

An event binding is an XML definition that defines one or more business events to CICS®. An event binding consists of event specifications, capture specifications, and adapter and dispatcher information.

The event binding is the unit for deploying, enabling, and disabling CICS events. The event binding groups sets of events that are to be handled using the same EP adapter and configuration and the same dispatching policy.

You create an event binding in a CICS bundle project using the CICS event binding editor. Development of an event binding can be top-down or bottom-up:

Top-down development
The business analyst creates an event specification. The application analyst then completes one or more corresponding capture specifications.
Bottom-up development
The application analyst first creates likely capture specifications. The business analyst then selects one or more of these capture specifications to correspond with the event specification required.

When the business analyst has completed the event specification and the application analyst has completed the corresponding capture specifications and dispatcher information, the event binding is complete.

An event binding is saved by the CICS event binding editor as an XML event binding file with the suffix .evbind in a CICS bundle project. You can deploy the bundle to a CICS system. You can define, install, enable, disable, and uninstall a deployed CICS bundle in a CICS system. In addition, you can enable and disable individual deployed event bindings.

The CICS event binding editor creates an XML file conforming to the event binding schemas. To deploy to a CICS system, an event binding must be included in a CICS bundle and must conform to the event binding schemas. The following event binding schema files are installed with CICS in /usr/lpp/cicsts/cicsts41/schemas/eventprocessing/

:

Schema versions

The schema version is identified by a version and release number shown in the schema; for example:
CICSEPSchemaRelease="1" CICSEPSchemaVersion="1"

The schema version number is incremented at each CICS release, if the release contains a new schema. The release number is incremented during the CICS release if a new schema is introduced during the release.

The CICS event binding editor keeps your schema at the lowest level possible to provide the greatest compatibility with systems that might not support later schema versions. The CICS event binding editor sets the version and release numbers in the evbind file to the minimum level for the options chosen by the user. If the event binding file is using a later schema version than the schema version supported by CICS, the installation of the event binding file fails. If a feature is not listed in Table 1 it is a base feature with a minimum schema level of 1.0.

Table 1. Minimum schema version for event binding features
Feature Schema version
HTTP EP adapter v1.1
End of change