使用 CICS® 事件绑定编辑器中的过滤选项卡可定义用于捕获事件的条件(称为谓词)。
如果您没有提供谓词,那么每当所选的捕获点在目标 CICS 系统中运行时,都会发出事件。
每个谓词均包含用于识别该谓词、运算符和值的信息。
您可以根据需要指定任意数量的谓词,以确定您希望该捕获点发出事件的情境。您可以指定的三种谓词是上下文、事件选项和应用程序数据。
注: CICS 模块名称可以更改;因此,请勿在捕获规范中包含其中含有 DFH* 模块名称的过滤器。
一些捕获点具有主要谓词。主要谓词是要为其选择等于运算符并提供一个值以避免因在捕获点添加更多捕获规范而影响性能的谓词。
上下文
捕获规范中的谓词用于过滤捕获点上下文。
每个捕获点都具有可为其指定谓词的上下文项。事务标识就是一个示例。所有可用的上下文谓词都显示在过滤选项卡中。
上下文谓词是可选的;但是,您通常可以指定事务标识或当前程序,以从特定应用程序发出事件。
“上下文”区域用于设置事件的过滤选项。
根据您在 CICS 事件绑定编辑器 中提供的其他信息,并非所有的字段都适用。可用的上下文谓词取决于捕获点。您可能想要指定的谓词包括:事务标识、当前程序和用户标识。
- 事务标识
- 所有捕获点的运算符选项:
- 当前程序
- 所有捕获点的运算符选项:
- 全部
- 等于
- 不等于
- 不开始自
- 开始自
- 小于
- 不小于
- 大于
- 不大于
- 用户标识
- 所有捕获点的运算符选项:
- 响应代码
- 运算符选项:
- “等于”运算符的值包括:
事件选项
捕获规范中的谓词用于过滤 CICS 命令的事件选项的值。
每个捕获点都可具有能够为其指定谓词的事件选项。某些命令没有事件选项。事件选项与特定 EXEC CICS 命令或系统事件的选项相对应。
例如,对于 SEND MAP 命令即为 MAP 名称。DB2 连接状态事件的示例是 FROM_CONNECTST 状态。针对该捕获点的所有可用固定数据值都显示在过滤选项卡中。CICS 可识别事件选项的格式。
- 名称
- 捕获规范的名称。
- 运算符
- 所有捕获点的运算符选项:
- 值
- 为谓词指定的值。
- 应用程序命令选项谓词限制因 CICS API 而异。例如,TRANSID 的长度为 4 个字符;CHANNEL 的长度为 16 个字符。CICS 事件绑定编辑器 会针对每种类型而进行动态调整,如果谓词值太长或太短,就会显示一条消息。
有关 CICS API 调用的事件选项的更多信息,请参阅《应用程序编程引用》。
有关系统事件的事件选项的更多信息,请参阅“信息源”选项卡。
应用程序数据
捕获规范中的谓词用于过滤 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 表示过滤整个数据区或容器。例如,在过滤容器的内容而不管其长度如何时,这很有用。
- 运算符
- 运算符选项:
- 全部
- 存在
- 等于
- 不等于
- 不存在
- 开始自
- 不开始自
- 小于
- 不小于
- 大于
- 不大于
- 值
- 为谓词指定的值。
- 长度取决于数据类型;例如,类型 character 的最大长度为 255 个字符,而类型 unsigned halfword 的最大长度为 5 个字符且其值范围是 0 到 65535。