Setting up the Decision Server Events component of IBM Operational Decision Manager (ODM) for the HTTP EP adapter

To send events over HTTP to Decision Server Events, you must create resources in both CICS® and Decision Server Events. Use these examples to help you set up and configure both environments.

Decision Server Events project configuration

The following high-level procedure shows the steps you must perform when you build your Decision Server Events project. For more information about IBM® Operational Decision Manager and Decision Server Events setup, see IBM Operational Decision Manager.
  1. Create an Event project using the Event Designer tool.
  2. Insert a new folder.
  3. Insert a new event using the template exported from the Event Binding Editor.
  4. Amend the properties of the event and navigate to the Connector tab.
  5. Select HTTP connection.
  6. Select your preferred transport; either HTTP or HTTPS, as required.

For more information about event processing and CICS, see IBM Redbooks: Event Processing with CICS.

CICS setup for non-SSL authentication

Create a URIMAP resource with the following attributes:
URIMAP(mapname) GROUP(groupname)
PATH(/wbe/servlet/EventConnectorServlet)
SCHEME(HTTP)
USAGE(CLIENT)
HOST(hostname)
PORT(portnumber)
SOCKETCLOSE(hhmmss)
  • mapname is the URIMAP name referred to in the event binding file.
  • groupname is the CSD group to which the resource is to be added.
  • hostname is the host name or IP address of Decision Server Events.
  • portnumber is the WC_defaulthost port of Decision Server Events; the default port is 9080.
  • hhmmss is a period of time for which CICS keeps client connections that were opened by the HTTP EP adapter available in a pool for reuse. Choose a suitable time period depending on the frequency of event emissions. If you do not set this attribute, the connection is closed after each event is emitted.

CICS setup for SSL authentication

Create a URIMAP resource with the following attributes:
URIMAP(mapname) GROUP(groupname)
PATH(/wbe/servlet/EventConnectorServlet)
SCHEME(HTTPS)
USAGE(CLIENT)
HOST(hostname)
PORT(portnumber)
SOCKETCLOSE(hhmmss)
  • mapname is the URIMAP name referred to in the event binding file.
  • groupname is the CSD group to which the resource is to be added.
  • hostname is the host name or IP address of Decision Server Events.
  • portnumber is the WC_defaulthost_secure port of Decision Server Events; the default port is 9443.
  • hhmmss is a period of time for which CICS keeps client connections that were opened by the HTTP EP adapter available in a pool for reuse. Choose a suitable time period depending on the frequency of event emissions. If you do not set this attribute, the connection is closed after each event is emitted.
Because the URIMAP resource uses the HTTPS scheme, the CICS region requires a key ring allocated to it. You must add the signing SSL certificate of Decision Server Events to this key ring as a certificate authority before sending the event because CICS checks the server certificate for authenticity. If you add the certificate to the key ring while CICS is running, issue the PERFORM SSL REBUILD command to refresh the cache of certificates in the SSL environment for the CICS region.