使用 CICS® 事件绑定编辑器中的过滤选项卡,可定义用于捕获事件的条件(称为谓词)。
如果您不提供谓词,那么每当您选择的捕获点在目标 CICS 系统中运行时,都会发出事件。
每个谓词均包含用于识别该谓词、运算符和值的信息。
您可以根据需要指定任意个谓词,以确定希望该捕获点发出事件的情况。您可指定以下三种类型的谓词:上下文、事件选项和应用程序数据。
某些捕获点具有一个主谓词。主谓词用于以下情况:当您选择等于作为运算符设置并提供一个值以避免因为在捕获点添加更多捕获规范而影响性能时。
注: CICS 模块名称可以更改;因此,请不要在捕获规范中包括含有 DFH* 模块名称的过滤器。CICS 事件绑定编辑器为当前程序过滤器上的大部分 DFH* 模块名称编码时,会验证用户输入。用户只能对 DFH£*、DFH0*、DFHW2FI、DFHW2TS、DFHMQBP0 或 DFHECID 编码。此外,可针对 LINK PROGRAM 应用程序事件对 DFHMIRR 和 DFHMIRS 编码。
上下文
捕获规范中的这些谓词用于过滤捕获点上下文。
每个捕获点都具有可为其指定谓词的上下文项。事务标识就是一个示例。所有可用的上下文谓词都显示在过滤选项卡中。
上下文谓词是可选的;但是,您通常可以指定事务标识或当前程序,以从特定应用程序发出事件。
“上下文”区域用于设置事件的过滤选项。
根据您在 CICS 事件绑定编辑器中提供的其他信息,并非所有的字段都适用;可用的上下文谓词取决于捕获点。您可能想要指定的谓词有:事务标识、当前程序和用户标识。
- 事务标识
- 适用于所有捕获点的运算符选项:
- 当前程序
- 适用于所有捕获点的运算符选项:
- 全部
- 等于
- 不等于
- 不开始自
- 开始自
- 小于
- 不小于
- 大于
- 不大于
- 用户标识
- 适用于所有捕获点的运算符选项:
- 响应代码
- 运算符选项:
- “等于”运算符的值包括:
事件选项
捕获规范中的谓词用于过滤 CICS 命令或系统事件的事件选项值。
每个捕获点都可以具有可为其指定谓词的事件选项。某些命令没有事件选项。事件选项与特定 EXEC CICS 命令或系统事件的选项相对应。例如,对于 SEND MAP 命令即为 MAP 名称。DB2 连接状态事件的一个示例是 FROM_CONNECTST 状态。可用于捕获点的所有固定数据值都显示在过滤选项卡中。CICS 可识别事件选项的格式。
- 名称
- 捕获规范的名称。
- 运算符
- 适用于所有捕获点的运算符选项:
- 值
- 为谓词指定的值。
- 应用程序命令选项谓词的限制随 CICS API 而变化。例如,TRANSID 为 4 个字符;CHANNEL 为 16 个字符。CICS 事件绑定编辑器会针对每种类型进行动态调整,并且在谓词值过长或过短时会显示一条消息。
有关 CICS API 调用的事件选项的更多信息,请参阅 CICS TS 5.1 信息中心中的应用程序事件。
有关系统事件的事件选项的更多信息,请参阅 CICS TS 5.1 信息中心中的系统事件和 CICS TS 5.1 信息中心中的“信息源”选项卡。
应用程序数据
捕获规范中的这些谓词用于过滤 CICS 命令中指定的应用程序数据。
注: 如果为捕获规范定义了 DELETEQ TD 或 DELETEQ TS 捕获点,那么无法添加应用程序数据。
应用程序捕获点可以具有可为其指定谓词的可变长度数据值。应用程序数据与特定 EXEC CICS 命令的选项一致。例如,对于 SEND MAP 命令即为 FROM 字段。针对该捕获点的 EXEC CICS 命令的所有可用可变数据值都显示在过滤选项卡中。
应用程序数据谓词由 CICS 按照指定的顺序进行处理;即,先处理第一个谓词,然后处理第二个谓词,以此类推。
应用程序数据用于存储区域,例如在 CICS 命令上作为选项传递的 COMMAREA 或容器。CICS 无法识别这些区域的格式,但应用程序可识别。您可能具有源语言描述,可以将其导入以描述该格式。
注: 系统事件不使用应用程序数据。
- 位置
- “位置”字段的值取决于 CICS API 调用。
- 示例:
- 对于命令 EXEC CICS WRITE FILE(EXMPCAT),“位置”字段的选项包括 FROM 和 RIDFLD。
- 对于命令 EXEC CICS INVOKE SERVICE(name),“位置”字段的选项包括 CHANNEL 和 SCOPE。
- 容器
- 指定 CICS 通道容器。仅当应用程序数据指定了通道时,才能选择容器字段。在所有其他情况下,该字段处于禁用状态。
- 偏移量
- 指定相对于数据开始处的距离。
偏移量为 0 表示字段的开头。
- 长度
- 字段的长度,单位为字节。长度为 0 表示对整个数据区或容器进行过滤。例如,当过滤容器的内容而不考虑其长度时,该值十分有用。
- 运算符
- 运算符选项:
- 全部
- 存在
- 等于
- 不等于
- 不存在
- 开始自
- 不开始自
- 小于
- 不小于
- 大于
- 不大于
- 值
- 为谓词指定的值。
- 长度取决于数据类型;例如,字符类型的最大长度为 255 个字符,而无符号半字类型的最大长度为 5 个字符且值范围为 0 到 65535。