为 HTTP EP 适配器设置 IBM Business Monitor

要将事件从 CICS® 发送到 IBM® Business Monitor 服务器，必须创建 URIMAP 资源并指定所需的配置设置。 使用这些示例可帮助您设置和配置 URIMAP 资源。

IBM Business Monitor 设置

要配置 IBM Business Monitor 以从 CICS 接收事件，必须创建 Monitor Model。 有关 IBM Business Monitor的更多信息，请参阅 IBM Business Monitor。

针对无认证的非 SSL 的 CICS 设置

创建具有以下属性的 URIMAP 资源：
URIMAP(mapname) GROUP(groupname)
                PATH(/rest/bpm/events)
                SCHEME(HTTP)
                USAGE(CLIENT)
                HOST(hostname)
                PORT(portnumber)
                SOCKETCLOSE(hhmmss)
  • mapname 是事件绑定文件中所引用的 URIMAP 名称。
  • groupname 是要添加资源的 CSD 组。
  • hostname 是 IBM Business Monitor 服务器的主机名或 IP 地址。
  • portnumber 是 IBM Business Monitor 服务器的 WC_defaulthost 端口; 缺省端口为 9080。
  • hhmmss 是 CICS 保持客户机连接的时间周期，该连接由池中可用的 HTTP EP 适配器打开进行复用。 根据事件发布的频率选择适当的时间段。 如果未设置此属性，那么发布每个事件之后将关闭连接。
注: 不能将基本认证与 HTTP 方案配合使用，因为 IBM Business Monitor 服务器会将基本认证请求重定向到 HTTPS 端口。

没有认证的 SSL 的 CICS 设置

创建具有以下属性的 URIMAP 资源：
URIMAP(mapname) GROUP(groupname)
                PATH(/rest/bpm/events)
                SCHEME(HTTPS)
                USAGE(CLIENT)
                HOST(hostname)
                PORT(portnumber)
                SOCKETCLOSE(hhmmss)
  • mapname 是事件绑定文件中所引用的 URIMAP 名称。
  • groupname 是要添加资源的 CSD 组。
  • hostname 是 IBM Business Monitor 服务器的主机名或 IP 地址。
  • portnumber 是 IBM Business Monitor 服务器的 WC_defaulthost_secure 端口; 缺省端口为 9443。
  • hhmmss 是 CICS 保持客户机连接的时间周期，该连接由池中可用的 HTTP EP 适配器打开进行复用。 根据事件发布的频率选择适当的时间段。 如果未设置此属性，那么发布每个事件之后将关闭连接。

由于 URIMAP 资源使用 HTTPS 方案，因此 CICS 区域需要为其分配密钥环。 在发送事件之前，必须将 IBM Business Monitor 服务器的签名 TLS 证书作为认证中心添加到此密钥环，因为 CICS 会检查服务器证书的真实性。 如果在 CICS 区域运行时将证书添加到密钥环，请发出 PERFORM SSL REBUILD 命令以刷新 CICS 区域的 SSL 环境中的证书缓存。

使用基本认证的 SSL 的 CICS 设置

创建具有以下属性的 URIMAP 资源：
URIMAP(mapname) GROUP(groupname)
                PATH(/rest/bpm/events)
                SCHEME(HTTPS)
                USAGE(CLIENT)
                HOST(hostname)
                PORT(portnumber)
                AUTHENTICATE(BASIC)
                SOCKETCLOSE(hhmmss)
  • mapname 是事件绑定文件中所引用的 URIMAP 名称。
  • groupname 是要添加资源的 CSD 组。
  • hostname 是 IBM Business Monitor 服务器的主机名或 IP 地址。
  • portnumber 是 IBM Business Monitor 服务器的 WC_defaulthost_secure 端口; 缺省端口为 9443。
  • hhmmss 是 CICS 保持客户机连接的时间周期，该连接由池中可用的 HTTP EP 适配器打开进行复用。 根据事件发布的频率选择适当的时间段。 如果未设置此属性，那么发布每个事件之后将关闭连接。

由于 URIMAP 资源使用 HTTPS 方案，因此 CICS 区域需要为其分配密钥环。 在发送事件之前，必须将 IBM Business Monitor 服务器的签名 TLS 证书作为认证中心添加到此密钥环，因为 CICS 会检查服务器证书的真实性。 如果在 CICS 区域运行时将证书添加到密钥环，请发出 PERFORM SSL REBUILD 命令以刷新 CICS 区域的 SSL 环境中的证书缓存。

必须提供 XWBAUTH 全局用户出口，因为该出口提供用户标识和密码。