Running the sample custom EP adapter

The sample custom Event Processing (EP) adapter is provided as a model to help you create your own custom EP adapter.

Before you begin

For assured event emission, synchronous transactional events must have a recoverable temporary storage (TS) queue and synchronous nontransactional events must have an unrecoverable TS queue. Whether or not TS queues are recoverable depends on the value of a matching TSMODEL option. TS queues are recoverable only when there is a matching TSMODEL option that specifies that the TS queue is recoverable. When you use the sample custom EP adapter for synchronous transactional events, your program cannot issue a DELETEQ TS command for the event TS queue in the unit of work that captures the event.

About this task

To use the sample custom EP adapter, use the event binding editor to create and deploy an event binding. From CICS®, you then make the sample custom EP adapter available.

Procedure

  1. From the event binding editor Adapter tab, select Custom (User Written) in the Adapter field.
  2. Depending on the type of event, enter the required information:
    • For asynchronous events, type EPAT in the Transaction ID field.
    • For synchronous events, type DFH0EPAC in the Program ID field.
  3. In the Data passed to the Custom Adapter field, type the name of the TS queue to which you want the events written, or leave this field blank if you want the sample custom EP adapter to create a TS queue name from the user ID and program name of the program that the events originated from.
  4. Optional: For synchronous emission, click the Sync radio button in the Emission Mode field in Advanced Options.
  5. Optional: For transactional events, select the Events are Transactional check box in Advanced Options.
  6. Complete the event binding.
    For more information, see Specifying EP adapter and dispatcher information in the CICS Explorer product documentation.
  7. Deploy the event binding to your CICS system.
    For more information, see Deploying a CICS bundle in the CICS Explorer product documentation.
  8. On your CICS system, install the event binding in a bundle.
    For more information about installing your event binding bundle, see Enabling an event binding in the CICS Explorer product documentation.
  9. Make the sample custom EP adapter available by installing group DFH$EPAG.
    For more information, see Supplied resource definitions, groups, and lists.
  10. Run the program from which you want to generate events.

What to do next

Check the TS queue for results; click Operations > Queues > TS Queues.