Recover CF Structure on z/OS

The Recover CF Structure (MQCMD_RECOVER_CF_STRUC) command initiates recovery of CF application structures.

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


Required parameters

    CFStrucName (MQCFST)
    CF application structure name (parameter identifier: MQCA_CF_STRUC_NAME).

    The maximum length of the string is MQ_CF_STRUC_NAME_LENGTH.


Optional parameters

    CommandScope (MQCFST)
    Command scope (parameter identifier: MQCACF_COMMAND_SCOPE). Specifies how the command is executed when the queue manager is a member of a queue sharing group. We can specify one of the following:

    • blank (or omit the parameter altogether). The command is executed on the queue manager on which it was entered.
    • a queue manager name. The command is executed on the queue manager you specify, providing it is active within the queue sharing group. If you specify a queue manager name other than the queue manager on which it was entered, we must be using a queue sharing group environment, and the command server must be enabled.

    The maximum length is MQ_Q_MGR_NAME_LENGTH.

    Purge (MQCFIN)
    Recover to empty CF structure (parameter identifier: MQIACF_PURGE). Specifies whether the CF application structure is emptied. The value can be any of the following values:

      MQPO_YES
      Recover to empty CF structure. Any messages in the CF structure are lost.

      MQPO_NO
      Performs a true recovery of the CF structure. MQPO_NO is the default value.

Parent topic: Definitions of the Programmable Command Formats