指定 EP 适配器和分派器信息

可以在自己的事件绑定中指定信息,控制 CICS 如何发出由事件绑定生成的事件。

关于此任务

您可以使用分派器信息来定义由该绑定创建的事件会发生的情况。您可以选择 EP 适配器来发出事件,然后选择与 EP 适配器关联的选项。

过程

  1. 单击 CICS® 事件绑定编辑器 上的适配器选项卡 以指定要用于该事件绑定的 EP 适配器配置以及任何高级信息。
  2. 适配器列表中选择 EP 适配器类型。 您可以指定以下 EP 适配器类型:
    TS 队列
    以某种 XML 格式(公共基本事件 (CBE)、公共基本事件 REST (CBER) 或 WebSphere® Business Events (WBE))或以非 XML (CFE) 格式向指定的 CICS TS 队列。该 EP 适配器用于验证已捕获带有正确数据的正确事件,并向从 TS 队列进行读取的任何使用者发出事件。
    事务启动
    向指定的 CICS 事务发出事件。 传递给事务的数据采用基于容器的事件格式。您可以指定要运行该事务的 CICS 系统。如果无需事件数据,那么可以使用现有事务。
    定制(用户写入)
    以您所需的任何格式发出事件。定制 EP 适配器是可写入的 CICS 程序,用于提供由 CICS 提供的 EP 适配器所不支持的事件格式化和路由的组合。定制 EP 适配器不得执行任何其他处理,例如,使用事件。
    WMQ 队列
    以 XML 格式(以供 WebSphere Business Events 使用)、“公共基本事件”(CBE) 格式(供 WebSphere Business Monitor 使用)或非 XML 格式向 WebSphere 消息队列发出事件。
    更新开始HTTP更新结束
    更新开始以 XML 格式用 HTTP POST 向兼容 HTTP 1.1 的服务器发出事件,这种格式供诸如 WebSphere Business EventsWebSphere Business Monitor 之类的产品使用。更新结束
  3. 为所选的 EP 适配器类型指定选项:
    • 为 TS 队列 EP 适配器指定以下选项:
      • 指定 CICS 队列名称。您必须指定队列名称。
      • 如果目标队列为远程队列,请指定系统标识。
      • 如果需要,请选择使用辅助临时存储器
    • 为事务启动 EP 适配器指定以下选项:
      • 指定作为事件结果运行的 CICS 应用程序的事务标识。您必须指定事务标识。
      • 指定事务用户标识。由事务启动 EP 适配器启动的事务会使用该用户标识运行。
    • 为定制(用户写入)EP 适配器指定以下选项:
      • 为用户写入的 CICS 应用程序指定事务标识,该应用程序会格式化、路由并发出事件。
      • 将要传递的数据写入定制 EP 适配器。您的定制 EP 适配器会处理该数据。
    • 为 WMQ 队列 EP 适配器指定以下选项:
      • 指定 WebSphere MQ 队列的“队列名称”,由此事件绑定发出的事件将置于该队列上。您必须指定队列名称。
      • 指定消息是否持久。从持久列表中选择以下值之一。
        由 WMQ EP 适配器置于队列上的消息为非持久消息。
        由 WMQ EP 适配器置于队列上的消息为持久消息。
        队列缺省值
        置于队列上的消息会继承指定队列的缺省持久状态。
      • 指定消息优先级。您可以选择队列缺省值,或者针对 WebSphere MQ 消息优先级在优先级字段中输入 0 - 9 之间的一个值。
      • 指定过期时间。您可以选择永不过期,或者在过期时间字段中为 WebSphere MQ 消息过期输入一个值。该时间以十分之几秒表示。如果在这段时间内未从目标队列中除去消息,那么就可以丢弃该消息。
      • 指定事件的数据格式。从数据格式列表中选择以下值之一:
        CICS 序列化事件 (CFE) 格式
        事件数据采用非 XML 格式。
        WebSphere Business Events XML 格式
        将消息以 WebSphere Business Events 所需的 XML 格式置于队列上。
        针对 WebSphere Business Monitor 的公共基本事件格式
        将消息以 WebSphere Business Monitor 所需的 CBE 事件格式置于队列上。
    更新开始
    • 为 HTTP EP 适配器指定以下选项:
      • 指定 URIMAP。表示与兼容 HTTP 1.1 的服务器连接的 URIMAP 资源。
      • 指定事件的数据格式。从数据格式列表中选择以下值之一。
        针对 WebSphere Business Monitor 的公共基本事件 REST 格式
        根据 WebSphere Business Monitor 的需要,将事件以 XML 格式发送到兼容 HTTP 1.1 的服务器。
        WebSphere Business Events XML 格式
        将事件以 WebSphere Business Events 所需的 XML 格式发送到兼容 HTTP 1.1 的服务器。
        针对任何使用者的公共基本事件格式
        事件会以支持“公共事件基础结构”的任何产品使用的 CBE 事件格式发送到兼容 HTTP 1.1 的服务器。
    更新结束
  4. 可选: 您可以导出该事件绑定中的一个或多个事件规范。
    要导出事件规范:
    • 使用 TSQ EP 适配器或 WMQ EP 适配器,并选择 CFE 格式以采用二进制形式发出事件,以便提供 COBOL 副本 (.cpy)。
    • 使用任何其他 EP 适配器和格式来提供 XML 模式定义 (.xsd)。
    1. 单击导出事件规范 这样会显示“导出事件规范”窗口。
    2. 选择想要导出的事件规范。
    3. 要导出事件规范,请在目标目录字段中指定目录。
    4. 单击导出
    针对所选的每个事件规范,指定的目录中会创建一个文件。
    以下是一些示例规范:
    • 例如,如果您指定 WMQ 队列适配器和公共基本事件格式,并选择称为 example1example2 的两个事件规范,那么会创建两个 XML 模式文件,即 example1.xsdexample2.xsd。 您可以将这些模式文件导入 WebSphere Business Monitor,以帮助定义入站事件。
    • 如果您指定 WMQ 队列 EP 适配器和 WebSphere Business Events (XML) 格式,并选择一个称为 example1 的事件规范,那么会创建一个 XML 模式文件,即 example1.xsd。 可以在 WebSphere Business Events Design Data 工具中使用该模式文件,以帮助定义事件。
    • 更新开始如果您指定 HTTP EP 适配器和公共基本事件 REST 格式,并选择称为 example1example2 的两个事件规范,那么会创建两个 XML 模式文件,即 example1.xsdexample2.xsd。 您可以将这些模式文件导入 WebSphere Business Monitor,以帮助定义入站事件。更新结束
    • 更新开始如果您指定 HTTP EP 适配器和 WebSphere Business Events (XML) 格式,并选择一个称为 example1 的事件规范,那么会创建一个 XML 模式文件,即 example1.xsd。 可以在 WebSphere Business Events Design Data 工具中使用该模式文件,以帮助定义入站事件。更新结束
    • 更新开始如果您指定 HTTP EP 适配器和公共基本事件格式,并选择称为 example1example2 的两个事件规范,那么会创建两个 XML 模式文件,即 example1.xsdexample2.xsd。 您可以将这些模式文件导入接受 CBE 格式的任何使用者,以帮助定义入站事件。更新结束
    • 如果您指定 TS 队列 EP 适配器,并选择称为 example1example2 的两个事件规范,那么会创建两个 COBOL 副本,即 example1.cpyexample2.cpy。 可以使用这些副本来处理事件使用者程序中的数据。

    请注意,如果您导出事件规范,然后再次将相同的事件规范导出到相同的目录,那么 CICS 事件绑定编辑器会提示您是覆盖现有文件还是取消导出操作。

  5. 可选: 指定任何必需的高级分派器选项。 这些选项适用于高级用户,它们可以控制 EP 适配器在 CICS 系统中的运行方式。
    注: 通常,使 CICS 在分派器线程下运行 EP 适配器会更有效。但是,可能需要将 EP 适配器作为单独的事务来运行;例如,需要使用具有针对 WebSphere MQ 队列的写权限的特定用户标识来运行该适配器时,或是希望控制使用 TRANCLASS 设置的并发 EP 适配器任务的数量时。
    1. 指定分派优先级。 您可以指定普通优先级,控制事件分派器如何处理与该事件绑定关联的事件。根据事件是事务性的设置,高优先级事件一旦可用就可发出。根据事件是事务性的设置,普通优先级事件一旦可用就可发出,但是要在任何未完成的高优先级事件之后发出。
    2. 更新开始指定事务标识(不可用于 CICS 事务 EP 适配器)。更新结束 EP 适配器程序使用该事务标识运行。

      更新开始如果不指定事务标识并且未指定用户标识,那么将使用缺省事务 CEPH 连接和运行 HTTP EP 适配器。 所有其他 EP 适配器都使用分派器事务进行链接。更新结束

    3. 指定用户标识。 如果您指定用户标识,那么 EP 适配器事务会使用该用户标识运行。如果您选择使用上下文用户标识,那么 EP 适配器会使用捕获事件的用户标识运行。
      如果您指定用户标识,但是未指定事务标识,那么 EP 适配器会使用该 EP 适配器类型的缺省事务运行:
      • WMQ 队列 EP 适配器会使用 CEPQ 事务。
      • 更新开始HTTP EP 适配器会使用 CEPH 事务。更新结束
      • TS 队列 EP 适配器会使用 CEPT 事务。
    4. 指定系统标识(只可用于事务 EP 适配器)。 EP 适配器事务会使用该系统标识在 CICS 系统上运行。
    5. 指定事件是否是事务性的。 如果希望 CICS 仅在与事件关联的业务工作单元 (UOW) 成功完成时才捕获事件,请选中事件是事务性的复选框。

      如果希望 CICS 在事务外处理与该事件绑定关联的事件,请取消选中事件是事务性的复选框。事件会在生成时发出。

结果

现在即完成了针对事件绑定的适配器和分派器信息。