添加捕获规范

将捕获规范添加到事件规范以在 CICS® 中创建捕获点。

关于此任务

事件绑定编辑器将会指导您完成创建一个或多个捕获规范的过程。这些规范用于标识以下项:

  • 程序中被视为事件的任何点
  • 认为事件有效的条件
  • 要在捕获点捕获的数据如何映射到事件输出数据结构

例如,您可以指定任何 READQ TS(临时存储器 READ)命令为潜在事件。然后限定条件,当满足这些条件时,对于想要解释的命令添加可用类型的谓词时便会引发事件。所有谓词都必须为 true 才能引发事件。

您可以定义三种类型的谓词:
上下文

捕获规范中的这些谓词用于过滤捕获点上下文。

每个捕获点都具有可为其指定谓词的上下文项。事务标识就是一个示例。所有可用的上下文谓词都显示在过滤选项卡中。 上下文谓词是可选的;但是,您通常可以指定事务标识或当前程序,以从特定应用程序发出事件。

“上下文”区域用于设置事件的过滤选项。 根据您在 事件绑定编辑器中提供的其他信息,并非所有的字段都适用;可用的上下文谓词取决于捕获点。您可能想要指定的谓词包括:事务标识、当前程序和用户标识。

事件选项

捕获规范中的谓词用于过滤 CICS 命令或系统事件的事件选项值。

每个捕获点都可具有能够为其指定谓词的事件选项。某些命令没有事件选项。事件选项与特定 EXEC CICS 命令或系统事件的选项相对应。例如,对于 SEND MAP 命令即为 MAP 名称。DB2® 连接状态事件的示例是 FROM_CONNECTST 状态。可用于捕获点的所有固定数据值都显示在过滤选项卡中。CICS 可识别事件选项的格式。

应用程序数据

捕获规范中的这些谓词用于过滤 CICS 命令中指定的应用程序数据。

注: 如果为捕获规范定义了 DELETEQ TD 或 DELETEQ TS 捕获点,那么无法添加应用程序数据。

应用程序捕获点可具有能够为其指定谓词的可变长度数据值。应用程序数据与特定 EXEC CICS 命令的选项相对应。例如,对于 SEND MAP 命令即为 FROM 字段。针对该捕获点的 EXEC CICS 命令的所有可用可变数据值都显示在过滤选项卡中。

应用程序数据谓词由 CICS 按照指定的顺序进行处理;即,先处理第一个谓词,然后处理第二个谓词,以此类推。

应用程序数据用于存储区域,例如在 CICS 命令上作为选项传递的 COMMAREA 或容器。CICS 无法识别这些区域的格式,但应用程序可识别。您可能具有源语言描述,可以将其导入以描述该格式。
注: 系统事件不使用应用程序数据。

在事件绑定高级定义期间由业务经理输入的基本事件绑定信息包含事件规范。此事件绑定信息标识了已确定为将来处理所必需的数据,但未给出数据位置的详细信息。 您可以指定信息源来提供这些详细信息。

事件绑定编辑器信息源选项卡中呈现一个为满足业务规范所需的信息表,从而为您提供相关帮助。 此表显示事件规范中的业务信息。 对于此表中的每个项,您必须定义此捕获规范的信息源。

过程

  1. 规范选项卡中,单击事件规范。 此时右窗格将呈现突出显示的事件规范的详细信息。
  2. 单击添加捕获规范 此时将显示“添加捕获规范”窗口。
  3. 输入新捕获规范的名称。 可接受的字符是 A-Z、a-z、0-9 和 _。 不允许前置和嵌入的空白字符。该字符串不得以 0-9、_ 或字符串“xml”(无论小写、大写还是混合大小写;例如,“Xml”或“xMl”)开头。
  4. 可选: 输入新捕获规范的描述。
  5. 单击确定 此时便创建了新捕获规范。右编辑器窗格中会打开三个选项卡:捕获点过滤信息源。使用每个选项卡提供用于描述新捕获规范的信息。
  6. 单击捕获点选项卡。 执行以下步骤来添加捕获点信息:
    1. 对于要添加的捕获点选择 EXEC CICS 命令,或从捕获点列表中选择程序启动 程序启动是与 CICS 程序启动关联的捕获点。
    2. 单击先捕获后捕获 您可以将捕获点指定在某些 EXEC CICS 命令之前或之后。对于其中的一小部分 EXEC CICS 命令,此选项处于禁用状态。
  7. 单击过滤选项卡。 如果您要添加捕获谓词信息,请执行以下步骤:
    1. 可选: 为捕获规范定义应用程序上下文。 此时将显示对所选捕获点可用的应用程序上下文谓词。 选择运算符选项并提供值以指定谓词。运算符全部指定不过滤关联的谓词。请以大写形式输入事务标识当前程序用户标识的值。
    2. 可选: 为捕获规范定义应用程序选项。 此时将显示对所选捕获点可用的应用程序选项。 选择运算符选项并提供值以指定谓词。运算符全部指定不过滤关联的谓词。

      可用作主谓词的应用程序选项带有星号 (*) 标记。您必须选择等于作为运算符,并指定主谓词值以保持 CICS 性能。 例如,对于 PUT CONTAINER 捕获点,为可用应用程序选项 CONTAINER* 指定值。

    3. 可选: 为捕获规范定义应用程序数据。 要添加应用程序数据谓词,请单击添加。此时将显示“应用程序数据谓词”窗口。

      选择运算符选项并输入谓词值。运算符全部指定不过滤关联的谓词。

      定义要与此谓词一起测试的变量。您可以单击从导入的语言结构中选择并遵循从导入的源代码中选择变量中的指示信息进行操作,或者选择位置类型选项,然后使用面板中的活动字段进一步定义变量。 仅对所选类型为必需的那些字段处于活动状态。例如,如果选择字符类型,那么仅偏移量长度代码页字段为活动状态。

  8. 单击信息源选项卡。 对表中的每个信息源执行以下步骤以将信息源映射到可用数据项。 如果事件中没有要捕获的业务数据,该表可能不包含信息源。

    如果数据并非必需,那么无需捕获数据。

    1. 双击信息源,或者选择信息源并单击编辑 此时将显示“事件信息源”窗口。
    2. 上下文数据值可变长度数据中选择可用数据项。 如果选择可变长度数据项,那么可以单击从导入的语言结构中选择并遵循从导入的源代码中选择变量中的指示信息进行操作,或者选择位置类型选项,然后使用面板中的活动字段进一步定义变量。 仅对所选类型为必需的那些字段处于活动状态。例如,如果选择字符类型,那么仅偏移量长度代码页字段为活动状态。

      信息源不必与发出的业务信息项具有相同长度。CICS 会根据情况填补或截断值。

结果

您已创建捕获规范。您还可以移除捕获规范,方法是单击捕获点选项卡中的移除捕获规范,然后单击以确认删除。