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

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

Decision Server Insights project configuration

The following high-level procedure shows the steps you must perform when you build your Decision Server Insights project. For more information about the setup of the Decision Server Insights component of IBM® Operational Decision Manager, see IBM Operational Decision Manager.
  1. Create a Solution Project to contain the basis of the Insights solution. This step also creates a Business Object Model (BOM) project that is used to describe the business model.
  2. Import the schema, as exported from CICS into the BOM project. This defines the type of events to be consumed by the Solution.
  3. In the BOM Project, create a Business Model Definition file to define the entities required by the Solution.
  4. Create a Rule Agent Project to contain the rules that detect situations of interest.
  5. Define connectivity in the Solution Project for the events that are emitted from CICS.
  6. Deploy the Solution to a running Insights Server to start receiving, and processing, events from 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 Insights.
  • portnumber is the HTTPS port of Decision Server Insights. This can be found from the bootstrap.properties file of the Insight Server.
  • 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 Insights.
  • portnumber is the HTTPS port of Decision Server Insights. This can be found from the bootstrap.properties file of the Insight Server.
  • 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 Insights 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.