Enabling an event binding

You enable an event binding, contained in a bundle, by installing the resource object for the bundle to make it available to the CICS® region. You can enable event bindings by using a number of methods, including CICS Explorer®.

Before you begin

You must have created the required BUNDDEF resource object in the data repository to install the event binding bundle in the CICS region.

About this task

An event binding is enabled by installing the bundle resource if that resource specifies enabled as its initial state, and if the installation succeeds. The following procedure describes how to enable an event binding by using CICS Explorer.

Procedure

  1. From the main menu on the CICS Explorer workbench, click Definitions > Bundle definitions to view the list of BUNDDEF resource definitions.
  2. Right-click the event binding bundle definition name in the Bundle Definitions view and click Install.
  3. In the Perform Operation window, select the target CICS system or system group where you want to install your event binding bundle, and click OK.
  4. Use one of the following methods to check that your bundle installs successfully:
    • From the main menu of the CICS Explorer workbench, click Operations > Bundles and check the status of the bundle in the Status field.
    • From the main menu of the CICS Explorer workbench, click Operations > Bundle Parts and check the status of the bundle parts in the Enable Status field.
    If your bundle installs with any resources disabled, see Diagnosing deployment errors in CICS TS product documentation.

Results

The event binding bundle installs in the specified CICS region. CICS dynamically creates any additional resources that are defined in the bundle manifest. Events specified in the event binding are captured and emitted to an event consumer.

What to do next

After the resource definition installs successfully, you can use CICS Explorer to view the status of installed event bindings or bundles by selecting Operations > Event Processing > Event bindings or Operations > Bundles. You can also disable and discard event bindings or bundles by right-clicking in the Event bindings or Bundles views.
To replace a deployed bundle after it is installed, you can use one of the following methods:
  • Disable, discard, then install the changed version of a bundle with the same name. No events are emitted from the moment the bundle is disabled until the moment the installation completes successfully.
  • You can replace an event binding without disabling it first by creating a bundle that has a different name from the name of the original bundle and that contains an event binding of the same name. Events continue to be emitted until the bundle installation completes successfully, at which point the new event binding replaces the previous version.