查询策略
检索有关已安装的 POLICY 的信息,或者浏览区域中所有已安装的 POLICY 资源。
语法
警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。
通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。
条件: END , ILLOGIC , INVREQ , NOTAUTH 和 NOTFND
NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项,用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息,请参阅 CICS-值数据区 (CVDA)。
描述
INQUIRE POLICY 命令检索有关区域中一个或多个已安装的 POLICY 资源的信息。
浏览
您可以在 INQUIRE POLICY 命令上使用浏览选项 START, NEXT和 END来浏览区域中安装的所有 POLICY 资源。
请参阅 浏览资源定义 ,以获取有关浏览的常规信息,包括语法,异常条件和示例。
资源特征符
您可以使用此命令来检索资源签名字段。 您可以使用这些字段来管理资源,方法是捕获资源的定义,安装和上次更改时间的详细信息。 有关更多信息,请参阅 标识对资源的更改 (资源特征符)。 请参阅 资源签名字段值摘要 ,以获取有关资源签名字段内容的详细信息。
选项
- BUNDLE(数据区)
- 返回包含 POLICY 定义的捆绑软件的 8 字符名称。
- CHANGEAGENT (cvda)
- 返回用于标识上次对资源定义进行更改的代理程序的 CVDA 值。 可能的值如下所示:
- CREATESPI
- 上次由 EXEC CICS CREATE 命令更改资源定义。
- CSDAPI
- 上次由 CEDA 事务或 DFHEDAP 的可编程接口更改资源定义。
- CSDBATCH
- DFHCSDUP 作业上次更改资源定义。
- DREPAPI
- 资源定义上次由 CICSPlex ® SM BAS API 命令更改。
- CHANGEAGREL (data-area)
- 返回上次更改资源定义时运行的 CICS® 版本的 4 位数字:例如, 0 760 是 CICS TS for z/OS®, Version 6. 3 的标识符。
- CHANGETIME (data-area)
- 返回表示上次更改资源定义时的时间戳记的 ABSTIME 值。 有关 ABSTIME 值的格式的更多信息,请参阅 FORMATTIME。
- CHANGEUSRID (data-area)
- 返回运行更改代理程序的 8 字符用户标识。
- DEFINESOURCE (数据区域)
- 返回资源定义的 8 字符源。 DEFINESOURCE 值取决于 CHANGEAGENT 值。 有关更多信息,请参阅 资源签名字段值的摘要。
- DEFINETIME (数据区)
- 返回 ABSTIME 值,该值表示创建资源定义时的时间戳记。
- ENABLESTATUS (cvda)
- 返回指示 POLICY 资源状态的 CVDA 值。 可能的值如下所示:
- ENABLED
- POLICY 资源已启用以供使用。
- DISABLED
- POLICY 资源已禁用。
- INSTALLAGENT (cvda)
- 返回用于标识安装资源的代理程序的 CVDA 值。 可能的值如下所示:
- BUNDLE
- 资源是由捆绑软件部署安装的。
- INSTALLTIME (数据区)
- 返回表示安装资源时的时间戳记的 ABSTIME 值。
- INSTALLUSRID (数据区)
- 返回安装资源的 8 字符用户标识。
- POLICY (data-value)
- 指定要查询的 POLICY 的名称。 指定的名称长度必须为 1-64 个字符。 或者,当您浏览已安装的 POLICY 资源时,返回 64 个字符的 POLICY 名称。
- USERTAG (数据区)
- 返回 POLICY 的 usertag 的 8 字符值。
条件
- END
- RESP2 值:
- 2
- 没有更多此类型的资源定义。
- ILLOGIC
- RESP2 值:
- 1
- 当此资源类型的浏览已在进行时,您已发出 START 命令,或者当此资源类型的浏览未在进行时,您已发出 NEXT 或 END 命令。
- INVREQ
- RESP2 值:
- 4
- 发出 INQUIRE POLICY 命令以查询单个 POLICY ,但该命令未指定 POLICY 的名称。
- NOTAUTH
- RESP2 值:
- 100
- 未授权与发出任务关联的用户使用此命令。
- 101
- 未授权与发出任务关联的用户以此命令所需的方式访问策略。
- NOTFND
- RESP2 值:
- 3
- 找不到指定的 POLICY 资源。
