从策略导出事件规范

如果策略规则操作是发出事件,那么可将此事件的事件规范导出为模式或副本以供在其他地方使用。

开始之前

您必须将 CICS® 策略的规则操作定义为发出事件。有关指示信息,请参阅在 CICS 束项目中创建和部署策略

关于此任务

导出的文件包含事件数据的格式,使用程序或数据处理引擎来处理所捕获的数据时,此格式非常有用。

所选 EP 适配器或者所选 EP 适配器集中的某个 EP 适配器指定的数据格式决定了导出的文件为模式还是副本:
  • 对于公共基本事件、公共基本事件 REST、Decision Server Insights Event 或 WebSphere® Business Event 之类的 XML 格式,导出文件是一个 XML 模式定义 .xsd 文件。 以下适配器可以发出 XML 字符格式的事件:
    • HTTP 适配器
    • TD 队列适配器
    • TS 队列适配器
    • IBM® MQ 队列适配器
  • 对于非 XML 格式(即 CICS 序列化事件格式),导出文件为 COBOL 副本 .cpy 文件。 以下适配器可以发出 CICS 序列化事件格式的事件:
    • TD 队列适配器
    • TS 队列适配器
    • IBM MQ 队列适配器
注: 您无法为事务启动适配器或定制适配器导出事件规范。

过程

  1. 在策略定义编辑器的规则选项卡上,浏览至“操作”部分。
    策略定义编辑器的“规则”选项卡上的“操作”选项卡
  2. 确保选择发出事件操作,并指定 EP 适配器或 EP 适配器集。
  3. 单击导出事件规范
  4. 在以下任何情况下,系统会提示您选择适配器或适配器集:
    • 在工作空间中,有多个 EP 适配器与指定的适配器或者指定的 EP 适配器集中的某个适配器同名。
      “选择 EP 适配器”窗口
    • 在工作空间中,有多个 EP 适配器集具有指定的适配器集名称。
      “选择 EP 适配器集”窗口
  5. 在“为规则导出事件规范”窗口中,确保在对应的字段中指定正确信息: “为规则导出事件规范”窗口
    导出
    要导出其事件规范的策略规则。
    目标目录
    要用于保存已导出的事件规范的本地目录。
    数据格式

    在您的 EP 适配器或者您的 EP 适配器集中的某个 EP 适配器中指定的数据格式。

    在由于 EP 适配器、EP 适配器集或者 EP 适配器集中的 EP 适配器不在工作空间中而导致 CICS Explorer® 无法确定数据格式时,会显示此字段。

    注: 确保此数据格式信息与 EP 适配器中指定的信息相匹配,否则在使用导出的文件进行数据处理时可能失败。
    版本

    将要发出事件的 CICS 区域(即,要在其中部署策略的区域)的版本。

    在将策略规则应用于 CICS TS 5.3 和更低版本时显示此字段。

  6. 单击确定
  7. 如果指定的目录中已存在同名的已导出事件规范,那么系统会提示您是覆盖现有文件还是取消导出。

结果

在指定的目录中为策略规则创建一个或多个文件。下表中的示例显示了为没有指定任何事件名称的其他事件创建的文件。

如果指定了事件名称,那么它将用作已导出文件名的前缀。例如,如果在第一个示例中指定了事件名称 event_name,那么会将输出文件命名为 event_name_dsie_CICS_54.xsd。有关定义事件名称的指示信息,请参阅在 CICS 束项目中创建和部署策略
表 1. 为不同事件导出的事件规范文件
EP 适配器或适配器集 策略规则 版本 数据格式 导出的事件规范
IBM MQ 队列适配器 文件打开状态系统规则 V54 Decision Server Insights Event (XML) 格式 名为 fileEnable_rule_dsie_CICS_54.xsd 的 XML 模式文件,您可以在 IBM Operational Decision Manager Insight Designer 工具中使用此模式文件来帮助定义事件。
TD 或 TS 队列适配器 存储请求任务规则 V51 - 53 公共基本事件 REST (XML) 格式 名为 cics_policy_event_payload_cbe_CICS_51-53.xsd 的 XML 模式文件,您可以将此文件导入到 IBM Business Monitor 来定义入站事件。
V54 名为 task_rules_payload_cbe_CICS_54.xsd 的 XML 模式文件,您可以将此文件导入到 IBM Business Monitor 来定义入站事件。
IBM MQ 队列适配器 文件打开状态系统规则 V54 CICS 序列化事件格式 名为 DFHMPFEO_CICS_54.cpy 的 COBOL 副本,您可以使用此副本在自己的事件使用者程序中处理数据。
具有以下项的 EP 适配器集:
  • TD 或 TS 队列适配器(CICS 序列化事件格式)
  • IBM MQ 队列适配器 (WebSphere Business Events (XML) 格式)
文件打开状态系统规则 V54

CICS 序列化事件格式 WebSphere Business Events (XML) 格式

名为 DFHMPFEO_CICS_54.cpyfileEnable_rule_wbe_CICS_54.xsd 的两个文件,您可以在程序和 IBM Operational Decision Manager 事件设计器工具中使用这两个文件。