ACFFQRY

用途

ACFFQRY 命令提供了从自动化过程访问 SA z/OS 自动化控制文件的快速，可操作的方法。

另请参阅 IBM Z System Automation 操作员命令中的相关命令 ACF。

以下语法图显示如何使用 ACFFQRY 命令来查询自动化控制文件。

条目

这是要用于搜索自动化控制文件的 entry 值。输入值可以采用以下格式:

*: 除非指定了 TAME ，否则条目值为通配符或以通配符结尾。
条目: 输入特定条目值。如果要指定类型值，那么必须输入特定条目值。
对于应用程序组 (APG) 的消息数据， entry 必须以 0 作为前缀。对于监视器资源 (MTRs) 的消息数据， 条目 必须以 1 作为前缀。

类型

这是要用于搜索自动化控制文件的类型值。仅当输入特定条目值时，才能指定类型值。类型值可以采用以下格式:

TAME

自动化控制文件数据库中的条目和类型名称中的通配符将与搜索中指定的条目和类型进行匹配。 TAME 允许您搜索的通配符 在数据库中 。例如，使用常量查询字符串 (例如 AAA 123 ) ，您可以在自动化控制文件中的多个条目 (例如 AAA 12*) 上进行匹配。

这意味着，如果在自动化控制文件中设置了用户条目和类型，并且在最后一个字符上设置了星号，那么他们将对候选项进行标记。对于在自动化过程中维护和使用通用数据而不是特定数据的情况，这可能特别有用。

野

查询字符串中的星号 (*) 字符将被视为文字。

数据

将返回与条目/类型对相关的 keyword=value 数据。

仅当指定了特定条目值时，才能指定类型值。

如果在 PIPE 中调用它，但也可以在 TRAP/WAIT/MSGREAD 中调用它，那么效率最高。

无。

来自 ACFFQRY 的输出采用相关多行消息的形式，消息的每一行上都有一个或两个列表项和数据元素。没有周围的消息标识或详细信息。

多行消息的第一行始终是文字 ACFFQRY:，后跟来自 ACFFQRY 的返回码。如果存在输出，那么它将从第 2 行开始。这意味着必须从元素 2 处理在词干中返回的输出。

如果返回 keyword=data ，那么条目和类型将在其前面。例程可以通过存在等号 (=) 来区分输入/类型输出与数据输出。例如：

If Pos('=',data.n) = 0 then Do
/* data line is an ENTRY TYPE    */
End
Else Do
/* data line is an KEYWORD=VALUE */
End

表 1 显示各种参数组合的结果。 - 表示选项与生成的输出无关。 DATA 列中的星号指示返回 keyword=value 数据。

表 1. 来自 ACFFQRY 的输出
ACFFQRY 条目	类型	TAME	野	数据	结果
		-	-		所有条目的列表
en * 或 *		False	False		以 en开头的条目列表。
en * 或 *		是	False		以 en 或 taming en * 开头的所有条目的列表。
条目		是	-	-	标记条目的条目列表
条目		False	-	-	条目的类型列表
条目	蒂 *	False	False	*	以 ty 开头的条目的类型列表
条目	蒂 *	是	False	*	以 ty 或 taming ty 开头的条目类型列表 *
条目	蒂 *	False	是	*	输入条目和类型为 ty * 的所有数据
条目	蒂 *	是	是	*	条目标记的所有类型的列表 *
条目	类型	False	-	-	输入项和类型类型的所有数据
条目	类型	是	-	*	条目标记类型的所有类型的列表

这些返回码显示在返回的数据的第一行上，位于文字 ACFFQRY:之后。