Choosing an EP adapter resource

You choose an EP adapter resource for an event binding, an EP adapter set, or a policy in a CICS® bundle project.

About this task

This task covers three possible scenarios:
  • Choosing an EP adapter resource to be included in an event binding, in the Adapter tab of the CICS event binding editor.
  • Choosing an EP adapter resource to be included in an EP adapter set, in the EP adapter set configuration editor.
  • Choosing an EP adapter to which an event is emitted when a policy condition is met, in the Rules tab of the policy definition editor.
There are some situations where you might want to choose the resource from a list of EP adapter names. For example:
  • When the EPADAPTER resource is currently defined as a separate XML file in the workspace.
  • When the EPADAPTER resource is currently installed into a CICS region.

Procedure

  1. You can open the Choose an EP Adapter dialog from one of the following locations:
    • The Adapter tab of the event binding editor.
    • The edit page of the EP adapter set configuration editor.
    • The Rules tab of the policy definition editor.
    For an event binding, perform the following steps:
    1. If you do not already have a project with an event binding, create a CICS bundle project and a new event binding file in the CICS Explorer®. For detailed instructions, see Creating an event binding file.
    2. Double-click the event binding file in the Project Explorer view.
    3. Click the Adapter tab in the CICS event binding editor and select Use a predefined EPADAPTER resource.
    4. Click Choose.
    For an EP adapter set, perform the following steps:
    1. If you do not already have a project with an EP adapter set, create a CICS bundle project and a new EP adapter set file in the CICS Explorer. For detailed instructions, see Creating an EP adapter set file.
    2. Double-click the EP adapter set file in the Project Explorer view.
    3. Click the Event Processing Adapter Set tab in the EP adapter set configuration editor.
    4. Click Add in the EP Adapters section.
    For a policy, perform the following steps:
    1. If you do not already have a policy task or system rule, create a policy in a CICS bundle project and a task or system rule by using the CICS Explorer. For detailed instructions, see Creating a policy in a CICS bundle project.
    2. Click the Rules tab in the policy definition editor.
    3. In the Action section, select Emit an event to. Then select EP Adapter from the drop-down list.
    4. Click Choose.
  2. Choose an EP adapter.
    An image of the choose an EP adapter resource dialog

    You can use any of the following options to specify an EPADAPTER name:

    • Type the adapter name in the Name field.
    • Select an EP adapter from a list found in the workspace. When Use an EPADAPTER found in the workspace is selected, adapter definitions embedded in event bindings are not included in the adapter list.
    • Select an EP adapter from a list found in a connected CICS region or CICSplex. If you are not connected to CICS at the time, you can connect by clicking CICS System Mangement connection.

Results

If you complete this task for an event binding, the EP adapter name is specified for this event binding. If you complete this task for an EP adapter set, the EP adapter name is added to this EP adapter set. If you complete this task for a policy, an EP adapter is specified for the policy to emit an event to when the policy rule condition is met.