Inquire CF Structure (Response) on z/OS

The response to the Inquire CF Structure (MQCMD_INQUIRE_CF_STRUC) command consists of the response header followed by the CFStrucName structure and the requested combination of attribute parameter structures.

If a generic CF application structure name was specified, one such message is generated for each CF application structure found.

    Always returned:
    CFStrucName

    Returned if requested:
    AlterationDate, AlterationTime, CFConlos, CFLevel, CFStrucDesc, DSBLOCK, DSBUFS, DSEXPAND, DSGROUP, OFFLD1SZ, OFFLD12SZ, OFFLD3SZ, OFFLD1TH, OFFLD2TH, OFFLD3TH, Offload, RCVDATE, RCVTIME, Recauto, Recovery


Response data

    AlterationDate (MQCFST)
    Alteration date (parameter identifier: MQCA_ALTERATION_DATE).

    The date on which the definition was last altered, in the form yyyy-mm-dd.

    The maximum length of the string is MQ_DATE_LENGTH.

    AlterationTime (MQCFST)
    Alteration time (parameter identifier: MQCA_ALTERATION_TIME).

    The time at which the definition was last altered, in the form hh.mm.ss.

    The maximum length of the string is MQ_TIME_LENGTH.

    CFConlos (MQCFIN)
    The CFConlos property (parameter identifier: MQIA_CF_CFCONLOS).

    Specifies the action to be taken when a queue manager loses connectivity to the CF structure. The value can be any of the following values:

      MQCFCONLOS_TERMINATE
      The queue manager will terminate when connectivity to the structure is lost.

      MQCFCONLOS_TOLERATE
      The queue manager will tolerate loss of connectivity to the structure without terminating.

      MQCFCONLOS_ASQMGR
      The action taken is based on the setting of the CFCONLOS queue manager attribute

    This parameter is only valid from CFLEVEL(5).

    CFLevel (MQCFIN)
    The functional capability level for this CF application structure (parameter identifier: MQIA_CF_LEVEL). Specifies the functional capability level for the CF application structure. The value can be any of the following values:

      1
      A CF structure that can be "auto-created" by a queue manager at command level 520.

      2
      A CF structure at command level 520 that can only be created or deleted by a queue manager at command level 530 or greater. This level is the default CFLevel for queue managers at command level 530 or greater.

      3

      A CF structure at command level 530. This CFLevel is required if we want to use persistent messages on shared queues, or for message grouping, or both.

      4

      A CF structure at command level 600. This CFLevel can be used for persistent messages or for messages longer than 64 512 bytes.

      5

      A CF structure at command level 710. This CFLevel supports shared message data sets (SMDS) and Db2 for offloading messages.

      Structures are required to be at CFLEVEL(5) to support toleration of loss of connectivity.

    CFStrucDesc (MQCFST)
    The description of the CF structure (parameter identifier: MQCA_CF_STRUC_DESC).

    The maximum length is MQ_CF_STRUC_DESC_LENGTH.

    CFStrucName (MQCFST)
    CF Structure name (parameter identifier: MQCA_CF_STRUC_NAME).

    The maximum length is MQ_CF_STRUC_NAME_LENGTH.

    DSBLOCK (MQCFIN)
    The CF DSBLOCK property (parameter identifier: MQIACF_CF_SMDS_BLOCK_SIZE).

    The returned value is one of the following constants: MQDSB_8K, MQDSB_16K, MQDSB_32K, MQDSB_64K, MQDSB_128K, MQDSB_256K, MQDSB_512K, MQDSB_1024K, MQDSB_1M.

    DSBUFS (MQCFIN)
    The CF DSBUFS property (parameter identifier: MQIA_CF_SMDS_BUFFERS).

    The returned value is in the range 0 - 9999.

    The value is the number of buffers to be allocated in each queue manager for accessing shared message data sets. The size of each buffer is equal to the logical block size.

    DSEXPAND (MQCFIN)
    The CF DSEXPAND property (parameter identifier: MQIACF_CF_SMDS_EXPAND).

      MQDSE_YES
      The data set can be expanded.

      MQDSE_NO
      The data set cannot be expanded.

      MQDSE_DEFAULT
      Only returned on Inquire CF Struct when not explicitly set

    DSGROUP (MQCFST)
    The CF DSGROUP property (parameter identifier: MQCACF_CF_SMDS_GENERIC_NAME).

    The returned value is a string containing a generic data set name used for the group of shared message data sets associated with this CF structure.

    OFFLD1SZ (MQCFST)
    The CF OFFLD1SZ property (parameter identifier: MQCACF_CF_OFFLOAD_SIZE1).

    The returned value is a string in the range 0K - 64K.

    Returned if the MQIACF_ALL or MQIA_CF_OFFLOAD parameters are specified.

    The maximum length is 3.

    OFFLD2SZ (MQCFST)
    The CF OFFLD2SZ property (parameter identifier: MQCACF_CF_OFFLOAD_SIZE2).

    The returned value is a string in the range 0K - 64K.

    Returned if the MQIACF_ALL or MQIA_CF_OFFLOAD parameters are specified.

    The maximum length is 3.

    OFFLD3SZ (MQCFST)
    The CF OFFLD3SZ property (parameter identifier: MQCACF_CF_OFFLOAD_SIZE3).

    The returned value is a string in the range 0K - 64K.

    Returned if the MQIACF_ALL or MQIA_CF_OFFLOAD parameters are specified.

    The maximum length is 3.

    OFFLD1TH (MQCFIN)
    The CF OFFLD1TH property (parameter identifier: MQIA_CF_OFFLOAD_THRESHOLD1).

    The returned value is in the range 0 - 100.

    Returned if the MQIACF_ALL or MQIA_CF_OFFLOAD parameters are specified.

    OFFLD2TH (MQCFIN)
    The CF OFFLD2TH property (parameter identifier: MQIA_CF_OFFLOAD_THRESHOLD2).

    The returned value is in the range 0 - 100.

    Returned if the MQIACF_ALL or MQIA_CF_OFFLOAD parameters are specified.

    OFFLD3TH (MQCFIN)
    The CF OFFLD3TH property (parameter identifier: MQIA_CF_OFFLOAD_THRESHOLD3).

    The returned value is in the range 0 - 100.

    Returned if the MQIACF_ALL or MQIA_CF_OFFLOAD parameters are specified.

    Offload (MQCFIN)
    The CF OFFLOAD property (parameter identifier: MQIA_CF_OFFLOAD). The returned values can be:

      MQCFOFFLD_DB2
      Large shared messages can be stored in Db2.

      MQCFOFFLD_SMDS
      Large shared messages can be stored in z/OS shared message data sets.

      MQCFOFFLD_NONE
      Used when the property Offload has not been explicitly set.

    RCVDATE (MQCFST)
    The recovery start date (parameter identifier: MQCACF_RECOVERY_DATE).

    If recovery is currently enabled for the data set, this indicates the date when it was activated, in the form yyyy-mm-dd. If recovery is not enabled, this is displayed as RCVDATE().

    RCVTIME (MQCFST)
    The recovery start time (parameter identifier: MQCACF_RECOVERY_TIME).

    If recovery is currently enabled for the data set, this indicates the time when it was activated, in the form hh.mm.ss. If recovery is not enabled, this is displayed as RCVTIME().

    Recauto (MQCFIN)
    Recauto (parameter identifier: MQIA_CF_RECAUTO). Indicates whether automatic recovery action is taken when a queue manager detects that the 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 that the structure is allocated in. The value can be:

      MQRECAUTO_YES
      The structure and associated shared message data sets which also need recovery will be automatically recovered.

      MQRECAUTO_NO
      The structure will not be automatically recovered.

    Recovery (MQCFIN)
    Recovery (parameter identifier: MQIA_CF_RECOVER). Specifies whether CF recovery is supported for the application structure. The value can be:

      MQCFR_YES
      Recovery is supported.

      MQCFR_NO
      Recovery is not supported.

Parent topic: Definitions of the Programmable Command Formats