INQUIRE FEATUREKEY

Retrieves the value of a feature toggle.

INQUIRE FEATUREKEY

Conditions: NOTAUTH, NOTFND

Description

The INQUIRE FEATUREKEY command returns the value of the feature toggle with the specified name. Feature toggles are used to enable and set configuration options for toggle-enabled features. You can use INQUIRE FEATUREKEY to inquire enablement and configuration settings for any toggle-enabled feature. Toggle-enabled features are listed in Toggle-enabled features, support by release.

Browsing

You can browse through all the feature toggles that are specified for your region by using the browse options on INQUIRE FEATUREKEY commands: START, NEXT, and END. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

FEATUREKEY(data-value): Specifies the 1- to 255-character name of the feature toggle.
VALUE(data-area): Returns the 1- to 255-character value of the specified feature toggle.

Conditions

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.

NOTFND

RESP2 values:

1: The feature toggle with the specified name does not exist.

Example

For example, the enablement of the BMS 3270 Intrusion Detection Service is controlled by the feature toggle, com.ibm.cics.bms.ids={true|false}. To inquire whether this feature is toggled on for use in the CICS® region, issue the following command:

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

To inquire the configuration options that have been set for this feature, issue the following commands:


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