INQUIRE FEATUREKEY

检索功能部件切换的值。

语法

警告系统命令功能强大,可提供有关系统状态的信息,并允许对系统进行更改。 系统命令只能由授权应用程序和用户使用。

通过指定 XCMD 系统初始化参数并确保事务的命令安全检查处于激活状态(在 TRANSACTION 资源定义中指定 CMDSEC(YES) 或在 CMDSEC 系统初始化参数中指定 ALWAYS),激活命令安全检查。

INQUIRE FEATUREKEY

读取语法图跳过可视语法图 INQUIRE FEATUREKEY( data-value) VALUE( data-area) FILEPATH( data-area)

条件: NOTAUTH 和 NOTFND

NOHANDLE, RESP, 和 RESP2 是可以添加到所有 EXEC CICS 命令中的常用选项,用于处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项. 有关使用 CVDA 的更多信息,请参阅 CICS-值数据区 (CVDA)

描述

INQUIRE FEATUREKEY 命令返回具有指定名称的功能切换的值。 功能开关用于启用和设置支持开关的功能的配置选项。 您可以使用 INQUIRE FEATUREKEY 来查询任何已启用切换功能的启用状态和配置设置。 功能部件切换中列出了支持切换的功能部件。 遵循功能部件列表中的链接来查找有关特定已启用切换的功能部件的信息。

浏览

您可以使用 INQUIRE FEATUREKEY 命令 (START , NEXT 和 END) 上的浏览选项来浏览为您所在区域指定的所有功能开关。 请参阅 浏览资源定义 ,以获取有关浏览的常规信息,包括语法,异常条件和示例。

选项

FEATUREKEY (data-value)
指定功能切换的 1 到 255 个字符的名称。
VALUE (data-area)
返回指定功能切换的 1 到 255 个字符的值。
FILEPATH (数据区)
返回一个 255 个字符的数据区,其中包含用于定义在 CICS® 区域中生效的功能切换设置的功能切换配置文件的路径。

条件

NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。
NOTFND
RESP2 值:
1
具有指定名称的功能切换不存在。
5
未定义功能切换。

示例

例如, BMS 3270 入侵检测服务的启用由功能切换控件 com.ibm.cics.bms.ids={true|false}控制。 要查询是否开启此功能以在 CICS 区域中使用,请发出以下命令:
EXEC CICS INQUIRE FEATUREKEY('com.ibm.cics.bms.ids')
要查询为此功能部件设置的配置选项,请发出以下命令:

EXEC CICS INQUIRE FEATUREKEY('com.ibm.cics.bms.ids.action')
EXEC CICS INQUIRE FEATUREKEY('com.ibm.cics.bms.ids.vtamignore')