Chapter 4. Decision server events 99
Figure 4-27 The completed Adapter specification that CICS uses to transmit the events
6. Save the event binding and close the Event binding editor.
4.4.8 Deploying the bundle to CICS
The RequestForQuote CICS bundle now contains the completed Request event binding. The
event binding describes the fields that are emitted in the Request event, how the event is
triggered, and how data from the COBOL application is mapped into the event fields.
The next step is to configure CICS to emit the Request event to the Decision Server Events
run time each time that a customer requests a quotation.
Enabling CICS for events
First, CICS must be enabled for event processing. Event processing is enabled by default
when a START=INITIAL or START=COLD parameter is used during the startup of your CICS
TS V4.1 or V4.2 system. When a START=WARM or START=EMERGENCY parameter is
used, the settings from the previous run of CICS are used. So, unless the setting changed,
event processing is enabled.
You can inquire on EVENTPROCESS to check whether event processing is enabled, for
example, by using the CICS Explorer. You can stop and start event processing from the IBM
CICS Explorer, the CICSplex SM Web User Interface, or the CICS SPI or API command. You
might want to stop event processing for an upgrade or system maintenance, and then start
event processing again.
Note: The adapter is defined in the event bundle here for a quick deployment. In an
actual scenario, it is recommended that the adapter is defined as an EPADAPTER in
CICS. This approach separates the creation and management of the adapter from the
event binding file.
100 Flexible Decision Automation for Your zEnterprise with Business Rules and Events
Deploying the bundle
The CICS bundle must be transferred to a directory in the z/OS Distributed File Service (zFS)
for CICS to use it. The CICS Explorer provides the required functionality to transfer the CICS
bundle to the zFS.
To transfer the bundle, follow these steps:
1. Ensure that you configure an FTP connection under Window Preferences CICS
2. Next, right-click the RequestForQuote bundle, and select Export Bundle Project to
z/OS UNIX File System.
3. Navigate to a directory to which you have write access, typically in your home directory, for
example, /u/hiscm/RequestForQuote, and click Finish.
The CICS Explorer deploys the bundle to the specified directory.
Creating a bundle definition
After the bundle is deployed to the zFS, its location must be defined to CICS by using a
bundle definition (BUNDEF).
To create the bundle definition, follow these steps:
1. Select Explorer New Wizards Other.
2. Expand the CICS Definitions folder, select Bundle Definition, and click Next. The
completed panel is shown in Figure 4-28 on page 101.
3. Enter the group as WODMEV.
4. Enter the name of the bundle definition as RFQ.
5. Enter the Bundle Directory as the same location that you specified previously, for example,
6. Click Finish to complete the creation of the bundle definition.
Chapter 4. Decision server events 101
Figure 4-28 The completed bundle definition
Now that the bundle definition is created, it must be installed into CICS. Follow these steps to
install the new bundle definitions:
1. Open the Bundle Definitions view by selecting Window Show View and select Bundle
2. Right-click the newly created RFQ bundle.
3. Select install.
102 Flexible Decision Automation for Your zEnterprise with Business Rules and Events
4. Then, select IYGBNCAI, which is the CICS into which to install the bundle, and click OK,
as shown in Figure 4-29.
Figure 4-29 Installing the RFQ resource bundle
Creating the URI mapping definition
The URI mapping definition DSEVENTS was used on the event adapter to tell CICS how to
send the event to the Decision Server Events run time. Create this URI mapping definition:
1. Open the URI Mapping Definition view by selecting Window Show View and select
URI Mapping Definition.
2. Right-click in the new view and select New. The completed panel is shown in Figure 4-30
on page 103.
3. Enter the resource group as WODMEV.
4. Enter the name as DSEVENTS.
5. Enter the host where the Decision Server Events run time is located.
6. Enter the path as /wbeca/HTTPEventConnector.
7. Click Client and enter the port on which the Decision Server Events run time is listening.
8. Click Finish.
User ID access: Ensure that the user ID under which CICS is running has the appropriate
access to the UNIX System Services directory to which the event binding is transferred.