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

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

关于此任务

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

过程

  1. 单击 CICS 事件绑定编辑器 上的适配器选项卡 以指定要用于该事件绑定的 EP 适配器配置以及任何高级信息。 更新开始可以选择是使用预定义的 EPADAPTER 资源,还是使用“适配器”选项卡的“适配器”部分中定义的适配器。 有关预定义 EPADAPTER 资源的更多信息,请参阅事件处理 (EP) 适配器配置编辑器主题。如果指定了预定义的 EPADAPTER 资源,那么必须在名称字段中输入名称。更新结束
  2. 可选: 您可以导出该事件绑定中的一个或多个事件规范。
    要导出事件规范,请输入预定义 EPADAPTER 资源的名称,或者选择您希望的适配器。
    • 使用 TSQ EP 适配器或 WebSphere® MQ EP 适配器 并选择 CFE 格式以二进制形式发出事件,以便提供 COBOL 副本 (.cpy)。
    • 使用任何其他 EP 适配器和格式来提供 XML 模式定义 (.xsd)。
    1. 单击导出事件规范 如果使用 EPADAPTER 资源并且工作空间中包含多个同名的适配器,那么系统会要求您从列表中选择一个适配器。 这样会显示“导出事件规范”窗口。
    2. 选择想要导出的事件规范。
    3. 要导出事件规范,请在目标目录字段中指定目录。
    4. 如果使用了未出现在工作空间中的预定义 EPADAPTER 资源,那么必须选择合适的数据格式
    5. 单击导出
    在指定的目录中,将针对所选的每个事件规范创建一个文件。
    以下是一些示例规范:
    • 例如,如果指定了 WebSphere MQ EP 适配器 和公共基本事件格式,并选择名为 example1example2 的两个事件规范,那么会创建两个 XML 模式文件,即 example1.xsdexample2.xsd。 可以将这些模式文件导入到 WebSphere Business Monitor,以帮助定义入站事件。
    • 如果指定了 WebSphere MQ 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。 您可以将这些模式文件导入接受公共基本事件格式的任何使用者,以帮助定义入站事件。更新结束
    • 如果您指定 TS 队列 EP 适配器,并选择称为 example1example2 的两个事件规范,那么会创建两个 COBOL 副本,即 example1.cpyexample2.cpy。 您可以使用这些副本来处理自己的事件使用者程序中的数据。

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

  3. 适配器列表中选择 EP 适配器类型。 您可以指定以下 EP 适配器类型:
    TS 队列
    以某种 XML 格式更新开始(公共基本事件、公共基本事件 REST 或 WebSphere Business Events (WBE))或以非 XML (CFE) 格式向指定的 CICS TS更新结束队列发出事件。该 EP 适配器用于验证已捕获带有正确数据的正确事件,并向从 TS 队列进行读取的任何使用者发出事件。
    更新开始对于有保证的事件发出,同步事务事件需要可恢复的 TS 队列;同步非事务事件需要不可恢复的队列。 TS 队列是否可恢复取决于匹配 TSMODEL 的设置;TS 队列只有当存在匹配 TSMODEL 时才可恢复。当使用同步事务事件的 TS 队列适配器时,您不能向捕获事件的工作单元中的事件 TS 队列发出 DELETEQ TS 命令。更新结束
    事务启动
    向指定的 CICS 事务发出事件。 传递给事务的数据采用基于容器的事件格式。您可以指定要运行该事务的 CICS 系统。如果无需事件数据,那么可以使用现有事务。
    更新开始事务启动 EP 适配器不支持事件的保证发出。更新结束
    定制(用户写入)
    以您所需的任何格式发出事件。定制 EP 适配器是可写入的 CICS 程序,用于提供由 CICS 提供的 EP 适配器所不支持的事件格式化和路由的组合。定制 EP 适配器不得执行任何其他处理,例如,使用事件。
    更新开始对于有保证的事件发出,定制 EP 适配器必须符合事件的可恢复性需求。查阅您的定制 EP 适配器的文档以了解它是否支持事务性或非事务性同步事件。更新结束
    WebSphere Message Queue
    以 XML 格式(以供 WebSphere Business Events 使用)、“公共基本事件”格式(供 WebSphere Business Monitor 使用)或非 XML 格式向 WebSphere 消息队列发出事件。
    更新开始对于有保证的事件发出,如果结合使用 WebSphere MQ EP 适配器和持久的 WebSphere 消息队列,那么事件传递是有保证的。更新结束
    更新开始HTTP更新结束
    更新开始以 XML 格式,使用 HTTP POST 向符合 HTTP 1.1 规范的服务器发出事件,以供诸如 WebSphere Business EventsWebSphere Business Monitor(原称为 WebSphere Business Monitor)之类的产品使用。更新结束
    更新开始HTTP EP 适配器不支持事务事件的保证发出。更新结束
  4. 为所选的 EP 适配器类型指定选项:
    • 为 TS 队列 EP 适配器指定以下选项:
      • 指定 CICS 队列名称。您必须指定队列名称。
      • 如果目标队列为远程队列,请指定系统标识。
      • 如果需要,请选择使用辅助临时存储器
      • 更新开始指定事件的数据格式。从数据格式列表中选择以下值之一:
        CICS 序列化事件(二进制)
        事件数据采用非 XML 格式。
        WebSphere Business Events (XML)
        事件数据采用 XML 格式。
        公共基本事件 (XML)
        事件数据采用 XML 格式。
        公共基本事件 REST (XML)
        事件数据采用 XML 格式。
        更新结束
    • 为事务启动 EP 适配器指定以下选项:
      • 指定作为事件结果运行的 CICS 应用程序的事务标识。您必须指定事务标识。
      • 指定事务用户标识。由事务启动 EP 适配器启动的事务会使用该用户标识运行。
    • 更新开始为定制(用户写入)EP 适配器指定以下选项:
      • 指定以下某个选项:
        • 如果发出方式为异步,指定用户编写的、用于格式化、路由和发出事件的 CICS 应用程序的事务标识。您必须指定事务标识以由定制 EP 适配器进行异步发出。
        • 如果发出方式为同步,指定用户编写的、用于格式化、路由和发出事件的 CICS 应用程序的名称。 您必须指定程序标识以由定制 EP 适配器进行同步发出。
      • 将要传递的数据写入定制 EP 适配器。您的定制 EP 适配器会处理该数据。
      更新结束
    • 指定 WebSphere MQ EP 适配器的以下选项:
      • 指定 WebSphere MQ 队列的“队列名称”,由此事件绑定发出的事件将置于该队列上。您必须指定队列名称。
      • 指定消息是否持久。从持久列表中选择以下值之一。
        由 WebSphere MQ EP 适配器置于队列上的消息 为非持久性消息。
        由 WebSphere MQ EP 适配器置于队列上的消息 为持久性消息。
        队列缺省值
        置于队列上的消息会继承指定队列的缺省持久状态。
      • 指定消息优先级。可以选择队列缺省值,或者在优先级字段中为 WebSphere MQ 消息优先级输入 0 - 9 之间的值。
      • 指定过期时间。您可以选择永不过期,或者在过期时间字段中为 WebSphere MQ 消息过期输入一个值。该时间以十分之几秒表示。如果在这段时间内未从目标队列中除去消息,那么就可以丢弃该消息。
      • 指定事件的数据格式。从数据格式列表中选择以下值之一:
        CICS 序列化事件(二进制)
        事件数据采用非 XML 格式。
        WebSphere Business Events (XML)
        将消息以 WebSphere Business Events 所需的 XML 格式置于队列上。
        公共基本事件 (XML)
        将消息以 WebSphere Business Monitor 所需的公共基本事件格式置于队列上。
    更新开始
    • 为 HTTP EP 适配器指定以下选项:
      • 指定 URIMAP。表示与兼容 HTTP 1.1 的服务器连接的 URIMAP 资源。
      • 指定事件的数据格式。从数据格式列表中选择以下值之一。
        公共基本事件 REST (XML)
        根据 WebSphere Business Monitor 的需要,将事件以 XML 格式发送到兼容 HTTP 1.1 的服务器。
        WebSphere Business Events (XML)
        将事件以 WebSphere Business Events 所需的 XML 格式发送到兼容 HTTP 1.1 的服务器。
        公共基本事件 (XML)
        事件会以支持“公共事件基础结构”的任何产品使用的公共基本事件格式发送到兼容 HTTP 1.1 的服务器。
    更新结束
  5. 可选: 指定任何必需的高级分派器选项。 这些选项适用于高级用户,它们可以控制 EP 适配器在 CICS 系统中的运行方式。
    注: 通常,使 CICS 在分派器线程下运行 EP 适配器会更有效。但是,您可能需要将 EP 适配器作为单独的事务来运行;例如,需要使用具有 WebSphere MQ 队列写权限的特定用户标识来运行该适配器,或是希望使用 TRANCLASS 设置控制并发 EP 适配器任务的数量。
    1. 更新开始指定发出方式。 您可以指定 ASYNCSYNC 来指定发出事件的方式。请为有保证的事件发出指定同步发出方式。如果发出方式为同步,那么 WebSphere MQ EP 适配器会发出以下事件:
      • 使用 MQPMO_SYNCPOINT 选项的事务事件。可以在捕获事务的工作单元中恢复 WebSphere MQ 消息。
      • 使用 MQPMO_NO_SYNCPOINT 选项的非事务事件。

      如果发出方式是异步,那么 WebSphere MQ EP 适配器会使用 MQPMO_NO_SYNCPOINT 选项来发出事件。

      注:
      • 对于同步事件(有保证的事件发出),事件捕获应用程序需要对事件发出传输具有写权限。 对于异步事件,EP 适配器需要具有写权限。
      • 为 HTTP EP 适配器指定 SYNC NONTRANS 可将正在捕获的事务转换到一个 Web 应用程序,您可能需要相应地重新配置该应用程序。
      • 设置任何事务(可能通过 HTTP EP 适配器发出同步事件)的 TRANSACTION 定义的 DTIMOUT 属性。
      更新结束
    2. 指定分派优先级。 您可以指定普通优先级,控制事件分派器如何处理与该事件绑定关联的事件。根据事件是事务事件设置,高优先级事件一旦可用就可发出。根据事件是事务事件设置,普通优先级事件一旦可用就可发出,但是要在任何未完成的高优先级事件之后发出。
      注: 更新开始同步发出方式不适用该选项。更新结束
    3. 更新开始指定事务标识(不可用于 CICS 事务启动和定制 EP 适配器类型)。更新结束 EP 适配器程序使用该事务标识运行。

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

      注: 更新开始同步发出方式不适用该选项。更新结束
    4. 指定用户标识。 如果您指定用户标识,那么 EP 适配器事务会使用该用户标识运行。如果您选择使用上下文用户标识,那么 EP 适配器会使用捕获事件的用户标识运行。
      如果您指定用户标识,但是未指定事务标识,那么 EP 适配器会使用该 EP 适配器类型的缺省事务运行:
      • WebSphere MQ EP 适配器使用 CEPQ 事务。
      • 更新开始HTTP EP 适配器会使用 CEPH 事务。更新结束
      • TS 队列 EP 适配器会使用 CEPT 事务。
      注: 更新开始同步发出方式不适用该选项。更新结束
    5. 指定系统标识(只可用于事务 EP 适配器)。 EP 适配器事务会使用该系统标识在 CICS 系统上运行。
    6. 指定事件是否是事务事件。 如果希望 CICS 仅在与事件关联的业务工作单元 (UOW) 成功完成时才捕获事件,请选中事件是事务事件复选框。
      注: 更新开始慎重考虑是否应将不可恢复操作捕获的事务指定为事务性。 例如,如果从 WEB SEND 命令捕获了一个事务事件并且随后回退了工作单元,那么将回退该事件,但是 WEB SEND 命令可能已导致发出了 HTTP 消息。更新结束

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

结果

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