INQUIRE TAG

Retrieve information about region tags in a CICS® region.

Syntax

INQUIRE TAG

Read syntax diagramSkip visual syntax diagramINQUIRE TAGSTARTNEXTEND

Conditions: END, ILLOGIC, NOTAUTH

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The INQUIRE TAG command offers a browse interface to iterate over each tag type and tag that is applied to the currently running CICS system.

The command returns the result in the format of name:value for example:

cicsts-RegionUsage:Production

Browsing

See Browsing resource definitions.

Options

TAG(data-value)
Specifies a 161-character storage area into which the tag is returned. Data values are shown as the tag type, then a colon, then the tag entry collated.

Conditions

END
RESP2 values:
3
No more resource definitions of this type are available.
ILLOGIC
RESP2 values:
1
You issued a START command when a browse of this resource type is already in progress. Alternatively, you issued a NEXT or an END command when a browse of this resource type is not in progress.
NOTAUTH
RESP2 values:
100
The user who is associated with the issuing task is not authorized to use this command.