[z/OS]

RECOVER CFSTRUCT (recover CF application structure) on z/OS

Use the MQSC command RECOVER CFSTRUCT to initiate recovery of CF application structures and associated shared message data sets. This command is valid only when the queue manager is a member of a queue sharing group.

Using MQSC commands

For information on how you use MQSC commands, see Performing local administration tasks using MQSC commands.

You can issue this command from sources CR. For an explanation of the source symbols, see Sources from which you can issue MQSC commands on z/OS®.

Synonym: REC CFSTRUCT

RECOVER CFSTRUCT

Read syntax diagramSkip visual syntax diagram RECOVER CFSTRUCT ( ,structure-name ) CMDSCOPE(' ')CMDSCOPE(qmname)TYPE(NORMAL)TYPE(PURGE)

Usage notes for RECOVER CFSTRUCT

  • The command fails if neither the specified application structure nor its associated shared message data sets are flagged as being in a FAILED state.
  • If a data set is marked as FAILED but the corresponding structure is not, then the RECOVER CFSTRUCT command changes the structure state to FAILED, deleting the contents to perform recovery. This action deletes all nonpersistent messages stored in the structure and makes the structure unavailable until recovery is complete.
  • For a structure with associated shared message data sets, the RECOVER CFSTRUCT command recovers the structure plus the offloaded message data for any data sets which are either already marked as FAILED or found to be empty or invalid when opened by recovery processing. Any data sets which are marked as ACTIVE and have valid headers are assumed not to require recovery.
  • When recovery processing completes normally, all associated shared message data sets for the recovered structures (including data sets which did not need recovery) are marked as RECOVERED, indicating that the space map needs to be rebuilt.
  • Following recovery, space map rebuild processing is performed for each affected data set, to map the space occupied by the recovered message data (ignoring any existing messages which were nonpersistent or backed out). When the space map has been rebuilt for each data set, it is marked as ACTIVE again.
  • The command fails if any one of the specified structure names is not defined in the CFRM policy data set.
  • The recovery process is both I/O and processor intensive, and can only run on a single z/OS image. It should therefore be run on the most powerful or least busy system in the queue sharing group.
  • The most likely failure is the loss of a complete CF and hence the simultaneous loss of all the application structures therein. If backup date and times are similar for each failed application structure, it is more efficient to recover them in a single RECOVER CFSTRUCT command.
  • This command fails if any of the specified CF structures is defined with either a CFLEVEL of less than 3, or with RECOVER set to NO.
  • To use TYPE(NORMAL), you must have taken a backup of the CF structures, using the BACKUP CFSTRUCT command.
  • If backups of the requested CF structures have not been taken recently, using TYPE(NORMAL) may take a considerable amount of time.
  • If a backup of the CF structure, or a required archive log, is not available, you can recover to an empty CF structure using TYPE(PURGE).
  • The command RECOVER CFSTRUCT(CSQSYSAPPL) TYPE(PURGE) is prohibited. This is to prevent the accidental loss of queue manager internal objects.

Keyword and parameter descriptions for RECOVER CFSTRUCT

CFSTRUCT( structure-names ... )
Specify list of names of up to 63 structure names for which the coupling facility application structures are to be recovered, along with any associated shared message data sets which also need recovery. If resources for more than one structure need to be recovered, it is more efficient to recover them at the same time.
CMDSCOPE
This parameter specifies how the command runs when the queue manager is a member of a queue sharing group.
' '
The command runs on the queue manager on which it was entered. This is the default value.
qmgr-name
The command runs on the queue manager you specify, providing the queue manager is active within the queue sharing group.

You can specify a queue manager name, other than the queue manager on which the command was entered, only if you are using a queue sharing group environment and if the command server is enabled.

TYPE
Specifies which variant of the RECOVER command is to be issued. Values are:
NORMAL
Perform true recovery by restoring data from a backup taken using the BACKUP CFSTRUCT command and reapplying logged changes since that time. Any nonpersistent messages are discarded.

This is the default.

PURGE
Reset the structure and associated shared message data sets to an empty state. This can be used to restore a working state when no backup is available, but results in the loss of all affected messages.