添加捕获规范

您可以向事件规范添加捕获规范,以在 CICS® 中创建捕获点。

关于此任务

CICS 事件绑定编辑器会指导您创建一个或多个捕获规范。这些规范可识别以下项:

例如,您可以指定任何 READQ TS(临时存储器 READ)命令为潜在事件。 然后,通过添加想要截取命令的可用类型的谓词,限定提出事件的条件。

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

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

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

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

事件选项

捕获规范中的谓词用于过滤 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 不能识别这些区域的格式,但应用程序可识别。您可能具有源语言描述,可以将其导入以描述该格式。
注: 系统事件没有使用应用程序数据。

基本事件绑定信息由业务经理在事件绑定的高级别定义期间输入,它包括事件规范。 此事件绑定信息确定了进一步处理已知的必需数据,但是未给出该数据位置的详细信息。 您可以指定信息源来提供这些详细信息。

更新开始 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 会根据需要填充或截断值。

结果

您已创建了捕获规范。您还可以通过单击捕获点选项卡中的除去捕获规范,然后单击进行确认,从而除去捕获规范。