Creating an EP adapter file

You create an EP adapter file in a CICS® bundle project to contain your EP adapter specification. When an EP adapter is installed as its own resource, you can easily switch events to use a different EP adapter configuration, or different EP adapter altogether, and also send the same event to multiple destinations.

About this task

An EP adapter specification is an XML definition that defines one EP adapter to CICS. An EP adapter consists of adapter and dispatcher information. Use an EP adapter to configure event emission.

There are some situations where you might want the EP adapter to be installed as its own resource. For example:

Note: When you use a separate EP adapter configuration you can easily share it between event bindings, resulting in only one resource to manage. When you specify an EP adapter configuration embedded in an event binding, then CICS creates an EPADAPTER resource for you with the same name as the event binding.

You configure this EP adapter in the Adapter tab of the EP adapter panel. As a system programmer, you set some configuration values for the event data that you want to emit. You repeat this step for each item of data you need during event processing.

Procedure

  1. Optional: If you do not already have a project for the EP adapter, create a CICS Bundle project in the CICS Explorer™.
    1. If you are not already in the Resource perspective, switch to the Resource perspective. On the main menu bar, click Window > Open Perspective > Other. Select Resource from the Open Perspective window, and click OK. The CICS Explorer switches to the Resource perspective.
    2. On the main menu bar, click Explorer > New Wizards > Other > CICS Resources > CICS Bundle project. The Bundle Project wizard opens.
    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 file in the project you created
    1. Right-click the project name in the Project Explorer view.
    2. From the menu, select New > EP adapter.
    3. Specify the name of the EP adapter file. The name must not contain embedded spaces.
    4. Click Finish.
    A new EP adapter file is created, and opens in the Event processing (EP) adapter configuration editor.
  3. Complete the general information describing this EP adapter.
    1. Click the Adapter tab in the Event processing (EP) adapter configuration editor. The adapter pane is where you specify the general information that describes this EP adapter.
    2. Describe the EP adapter. The description further identifies this EP adapter. You might want to describe the settings that this EP adapter contains.

Results

You can now create specifications and dispatcher information for your EP adapter file.