Inquire CF Structure on z/OS

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

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, we 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, we cannot also specify an integer filter using the IntegerFilterCommand parameter.

Parent topic: Definitions of the Programmable Command Formats