添加捕获规范

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

关于此任务

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

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

您可以定义三种类型的谓词:
应用程序上下文
每个捕获点都具有可为其指定谓词的上下文项。事务标识就是一个示例。所有可用的应用程序上下文谓词都显示在过滤选项卡中。 应用程序上下文谓词是可选的;但是,您通常可以指定事务标识或当前程序,以从特定应用程序发出事件。
应用程序命令选项
针对捕获点指定的每条 EXEC CICS 命令都可以具有应用程序命令选项,您可以为其指定谓词。某些命令无应用程序命令选项。应用程序命令选项与特定 EXEC CICS 命令的选项一致。 例如,对于 SEND MAP 命令即为 MAP 名称。针对该捕获点的 EXEC CICS 命令的所有可用固定数据值都显示在过滤选项卡中。

CICS 可识别应用程序命令选项的格式。

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

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

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

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

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

结果

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