INQUIRE CAPDATAPRED
检索有关为捕获规范定义的应用程序数据谓词的信息。
语法
警告系统命令功能强大，可提供有关系统状态的信息，并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态（在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS），激活命令安全检查。
条件: END ， ILLOGIC ， INVREQ ， NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项，用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息，请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息，请参阅 DEVICE 选项的 CVDA 值。
此命令是线程安全的。
描述
INQUIRE CAPDATAPRED 命令返回为捕获规范定义的每个应用程序数据谓词的详细信息。 INQUIRE CAPDATAPRED 命令只能在浏览方式下使用。
浏览
您可以使用 INQUIRE CAPDATAPRED 命令上的浏览选项 (START ， NEXT 和 END) 来浏览捕获规范的所有应用程序数据谓词。
请参阅 浏览资源定义 ，以获取有关浏览的常规信息，包括语法，异常条件和示例。
选项
- CONTAINER(数据区)
- 指定一个 16 个字符的数据区，以在 LOCATION 选项的值等于 CHANNEL 或 FROMCHANNEL 时接收包含数据的容器的名称; 否则，此选项包含空白。 少于 16 个字符的值将用空格填充。
- FIELDLENGTH(数据区)
- 返回一个全字二进制字段，其中包含此谓词要测试的数据的长度 (以字节计)。 LOCATION 选项的值标识数据源。
- FIELDOFFSET(数据区)
- 返回一个全字二进制字段，该字段包含数据源中的偏移量 (由 LOCATION 选项的值指示) ，其中包含要由此谓词测试的数据。
- FILENAME(数据区)
- 指定 32 个字符的数据区，以接收包含定义此谓词的导入语言结构的文件名的前 32 个字符。 如果未使用导入的语言结构，那么此选项将包含所有空白。 小于 32 个字符的值用空格填充。 作为此选项的结果返回的数据将以本地编码字符集标识 (CCSID) 进行编码。
- FILTERVALUE(数据区)
- 指定 255 个字符的数据区，以用于接收“应用程序数据”谓词的值。 非字符谓词将转换为其字符表示。 小于 255 个字符的值将用空格填充。 作为此选项的结果返回的数据将以本地编码字符集标识 (CCSID) 进行编码。
- LOCATION(数据区)
- 指定 32 个字符的数据区以接收要测试的数据的位置。 对于 CICS® 事件绑定编辑器，当您为应用程序事件添加或编辑应用程序数据谓词时，此值与 应用程序数据 谓词对话框的 "变量位置和格式" 部分中 "位置" 字段的值相同。 小于 32 个字符的值用空格填充。
- 操作员 （CVDA）
- 返回用于定义与 FILTERVALUE 选项的值一起用于对谓词求值的运算符的 CVDA。 可能的 CVDA 值如下所示:
- DOESNOTEQUAL
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值不等于 FILTERVALUE 选项的值时，谓词求值为 true。
- DOESNOTEXIST
- 当为 LOCATION 选项指定的数据源不存在时，谓词求值为 true。
- DOESNOTSTART
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值未以 FILTERVALUE 选项的值开头时，谓词求值为 true。
- EQUALS
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值等于 FILTERVALUE 选项的值时，谓词求值为 true。
- EXISTS
- 当为 LOCATION 选项指定的数据源存在时，谓词求值为 true。
- GREATERTHAN
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值大于 FILTERVALUE 选项的值时，谓词求值为 true。
- ISNOTGREATER
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值等于或小于 FILTERVALUE 选项的值时，谓词求值为 true。
- ISNOTLESS
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值等于或大于 FILTERVALUE 选项的值时，谓词求值为 true。
- LESSTHAN
- 当由 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值小于 FILTERVALUE 选项的值时，谓词求值为 true。
- STARTSWITH
- 当 LOCATION， FIELDOFFSET和 FIELDLENGTH 值定义的数据项的值以 FILTERVALUE 选项的值开头时，谓词求值为 true。
- STRUCTNAME(数据区)
- 指定 32 个字符的数据区，以接收用于定义此谓词的导入语言结构的名称的前 32 个字符。 当未使用导入的语言结构时，此字段包含所有空白。 小于 32 个字符的值用空格填充。 作为此选项的结果返回的数据将以本地编码字符集标识 (CCSID) 进行编码。
- VARIABLENAME(数据区)
- 指定 32 个字符的数据区，以接收用于定义此谓词的导入语言结构中变量名称的前 32 个字符。 当未使用导入的语言结构时，此字段包含所有空白。 小于 32 个字符的值用空格填充。 作为此选项的结果返回的数据将以本地编码字符集标识 (CCSID) 进行编码。
条件
- END
- RESP2 值：
- 2
- 没有更多此类型的资源定义。
- 8
- 已删除事件绑定，因此浏览已提前终止。
- ILLOGIC
- RESP2 值：
- 1
- 当浏览此资源类型时，您已发出 START 命令，或者当浏览此资源类型时，您已发出 NEXT 或 END 命令。
- INVREQ
- 4
- 尚未对 START CAPDATAPRED 浏览指定 EVENTBINDING 名称。
- 5
- 没有为 START CAPDATAPRED 浏览指定 CAPTURESPEC 名称。
- NOTAUTH
- RESP2 值：
- 100
- 未授权与发出任务关联的用户使用此命令。
- 101
- 与发出任务关联的用户无权读取事件绑定。
- NOTFND
- RESP2 值：
- 2
- 找不到指定的捕获规范。
- 3
- 找不到指定的事件绑定。