Creating an EP adapter set file

You create an EP adapter set file in a CICS® bundle project to contain your EP adapter set specification. When an EP adapter set is installed, events can be sent to multiple destinations through this EP adapter set.

About this task

An EP adapter set specification is an XML definition that defines one EP adapter set to CICS. An EP adapter set consists of the names of one or more EP adapters.

In certain situations you might want to use an EP adapter set. For example, if an event binding has been created that names an EP adapter to send events to a WebSphere® MQ queue. You might also want events to be sent to another EP adapter such as a TS queue. You can use an EP adapter set specification to name multiple EP adapter names and then change the event binding to name the EP adapter set so that events are sent to both the WebSphere MQ queue and the TS queue.

Note: When you use an EP adapter set specification you can easily share it between event bindings, resulting in only one resource to manage.

Procedure

  1. Optional: If you do not already have a project for the EP adapter set, create a CICS bundle project in the CICS Explorer®:
    1. If you are not already in the Resource perspective, switch to the Resource perspective. From the main menu, click Window > Open Perspective > Other. Select Resource from the Open Perspective window, and click OK. The CICS Explorer switches to the Resource perspective.
    2. From the main menu, click Explorer > New Wizards > Other > CICS Resources > CICS Bundle project. The Bundle Project wizard is displayed.
    3. In the Project name field, type a name for your new project.
    4. Click Finish.
    The new CICS bundle project is listed in the Project Explorer view.
  2. Create an EP adapter set file in the project you created:
    1. Right-click the project name in the Project Explorer view.
    2. From the menu, click New > CICS Event Processing Adapter Set.
    3. Specify the name of the EP adapter set file. The name must not contain embedded spaces.
    4. Click Finish.
    A new EP adapter set file is created, and opens in the event processing (EP) adapter set configuration editor.
  3. Complete the general information to describe and further identify this EP adapter set.
  4. Add one or more EP adapter names. Click Add to specify an adapter. For more information, see Choosing an EP adapter resource.

Results

You can now reference this EP adapter set by adding its name to the Adapter tab of an event binding file. For more information, see Adapter tab.