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.