Setting up IBM Business Monitor for the HTTP EP adapter

To send events from CICS® to a IBM® Business Monitor server, you must create a URIMAP resource and specify the configuration settings you require. Use these examples to help you set up and configure your URIMAP resource.

IBM Business Monitor setup

To configure IBM Business Monitor to receive your events from CICS you must create a Monitor Model. For more information about IBM Business Monitor, see IBM Business Monitor.

CICS setup for non-SSL with no authentication

Create a URIMAP resource with the following attributes:
URIMAP(mapname) GROUP(groupname)
                PATH(/rest/bpm/events)
                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 the IBM Business Monitor server.
  • portnumber is the WC_defaulthost port of the IBM Business Monitor server; 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.
Note: You cannot use Basic Authentication with the HTTP Scheme because the IBM Business Monitor server redirects basic authentication requests to the HTTPS port.

CICS setup for SSL with no authentication

Create a URIMAP resource with the following attributes:
URIMAP(mapname) GROUP(groupname)
                PATH(/rest/bpm/events)
                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 the IBM Business Monitor server.
  • portnumber is the WC_defaulthost_secure port of the IBM Business Monitor server; 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 the IBM Business Monitor server 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 the CICS region is running, issue the PERFORM SSL REBUILD command to refresh the cache of certificates in the SSL environment for the CICS region.

CICS setup for SSL with basic authentication

Create a URIMAP resource with the following attributes:
URIMAP(mapname) GROUP(groupname)
                PATH(/rest/bpm/events)
                SCHEME(HTTPS)
                USAGE(CLIENT)
                HOST(hostname)
                PORT(portnumber)
                AUTHENTICATE(BASIC)
                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 the IBM Business Monitor server.
  • portnumber is the WC_defaulthost_secure port of the IBM Business Monitor server; 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 the IBM Business Monitor server 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 the CICS region is running, issue the PERFORM SSL REBUILD command to refresh the cache of certificates in the SSL environment for the CICS region.

The XWBAUTH global user exit must be provided, as it is this exit that supplies the user ID and password.