Creating an event specification

You add an event specification to an event binding to describe a business event and the information to be captured for the event.

About this task

When you have a clear idea of the events that you want to intercept, you use the CICS® event binding editor to specify them to CICS.

Procedure

  1. Click the Event Binding tab in the CICS event binding editor.
  2. Click Add. The Add Event Specification window opens.
  3. Enter a name for your event specification. The acceptable characters are A-Z, a-z, 0-9, and _. Leading and embedded blank characters are not permitted. The string must not start with 0-9, _, or the string "xml", regardless of whether it is lowercase, uppercase, or mixed case; for example, "Xml" or "xMl".
  4. Optional: Enter a description for your event specification.
  5. Click OK. A new event specification is listed in the Event Specifications section.
  6. Double-click the new event specification in the Event Specifications section, or click Edit Details. The Specification tab opens with the details of your new event specification.
  7. Specify any data that you want to capture in this event. You do not have to capture any data; you might want to emit an event with a name and no data.

    If you do want to capture data, look at the Emitted Business Information section in the Specifications tab. It contains a table of information that you want to capture for the event. For each item of business information that you want to capture, complete the following steps:

    1. Click Add. The Event Information window appears.
    2. Enter a name for the business information item. The acceptable characters are A-Z, a-z, 0-9, and _. Leading and embedded blank characters are not permitted. The string must not start with 0-9, _, or the string "xml", regardless of whether it is lowercase, uppercase, or mixed case; for example, "Xml" or "xMl".
    3. Provide a type, length, and description for the business information item. You can also specify a precision for numeric and scientific business information items. See Information Sources tab in the CICS TS V5.2 product information for more information about these fields.
    After you have added emitted business information items, you can change the order in which the items are emitted by selecting an item and using the Move Up and Move Down buttons.

Results

You can now create capture specifications to describe your event specification to CICS. You do this by clicking Add a capture specification, or, if you are adding a SIGNAL EVENT command to your program, you can generate a capture point for it by clicking Automatic Capture Specification.