Choosing an EP adapter resource

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

About this task

This task covers two 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.
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. Choose an EP adapter resource.
    You can either open the Choose an EP Adapter dialog in the Adapter tab of the event binding editor, or the edit page of the EP adapter set configuration editor.

    For an event binding, perform the following steps:

    1. Optional: 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. Optional: 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.
  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 embedded adapters 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 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.