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
- Click the Event Binding tab in the CICS event binding editor.
- Click Add. The Add
Event Specification window opens.
- 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".
- Optional: Enter a description for your event
specification.
- Click OK. A new event
specification is listed in the Event Specifications section.
- 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.
- 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:
- Click Add. The Event
Information window appears.
- 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".
- 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.