Inquire CF Structure

The Inquire CF Structure (MQCMD_INQUIRE_CF_STRUC) command returns information about the attributes of one or more CF application structures.

HP Integrity NonStop Server	IBM® i	UNIX and Linux®	Windows	z/OS®

Note: This command is supported only on z/OS when the queue manager is a member of a queue-sharing group.

Required parameters

CFStrucName (MQCFST)

CF Structure name (parameter identifier: MQCA_CF_STRUC_NAME).

Specifies the name of the CF application structure about which information is to be returned.

Generic CF structure names are supported. A generic name is a character string followed by an asterisk (*), for example ABC*, and it selects all CF application structures having names that start with the selected character string. An asterisk on its own matches all possible names.

The maximum length is MQ_CF_STRUC_NAME_LENGTH.

Optional parameters

CFStrucAttrs (MQCFIL)

CF application structure attributes (parameter identifier: MQIACF_CF_STRUC_ATTRS).

The attribute list might specify the following value on its own - default value used if the parameter is not specified:

MQIACF_ALL: All attributes.

or a combination of the following:

MQCA_ALTERATION_DATE: The date on which the definition was last altered.
MQCA_ALTERATION_TIME: The time at which the definition was last altered.
MQIA_CF_CFCONLOS: The action to be taken when the queue manager loses connectivity to the CF application structure.
MQIA_CF_LEVEL: Functional capability level for the CF application structure.
MQIA_CF_OFFLOAD: The shared message data set OFFLOAD property for the CF application structure.
MQIA_CF_RECOVER: Whether CF recovery for the application structure is supported.
MQIA_CF_RECAUTO: Whether automatic recovery action is taken when a structure is failed or when a queue manager loses connectivity to the structure and no systems in the SysPlex have connectivity to the Coupling Facility the structure is located in.
MQIACF_CF_SMDS_BLOCK_SIZE: The shared message data set DSGROUP property for the CF application structure.
MQIA_CF_SMDS_BUFFERS: The shared message data set DSGROUP property for the CF application structure.
MQIACF_CF_SMDS_EXPAND: The shared message data set DSEXPAND property for the CF application structure.
MQCACF_CF_SMDS_GENERIC_NAME: The shared message data set DSBUFS property for the CF application structure.
MQCA_CF_STRUC_DESC: Description of CF application structure.
MQCA_CF_STRUC_NAME: Name of CF application structure.

IntegerFilterCommand (MQCFIF): Integer filter command descriptor. The parameter identifier must be any integer type parameter allowed in CFStrucAttrs except MQIACF_ALL. Use this parameter to restrict the output from the command by specifying a filter condition. See MQCFIF - PCF integer filter parameter for information about using this filter condition.
If you specify an integer filter, you cannot also specify a string filter using the StringFilterCommand parameter.

StringFilterCommand (MQCFSF): String filter command descriptor. The parameter identifier must be any string type parameter allowed in CFStrucAttrs except MQCA_CF_STRUC_NAME. Use this parameter to restrict the output from the command by specifying a filter condition. See MQCFSF - PCF string filter parameter for information about using this filter condition.
If you specify a string filter, you cannot also specify an integer filter using the IntegerFilterCommand parameter.