RECOVER CFSTRUCT

---

Use RECOVER CFSTRUCT to initiate recovery of CF application structures. This command is valid only on full function WebSphere MQ for z/OS when the queue manager is a member of a queue-sharing group.

Synonym: REC CFSTRUCT

RECOVER CFSTRUCT
 
                     .-,------------------.
                     V                    |
>>-RECOVER CFSTRUCT(-----structure-name---+-)------------------->
 
   .-CMDSCOPE(' ')----.  .-TYPE(NORMAL)-.
>--+------------------+--+--------------+----------------------><
   '-CMDSCOPE(qmname)-'  '-TYPE(PURGE)--'
 
 

 

Keyword and parameter descriptions

CFSTRUCT(structure-names ...)

A list of names of up to 256 CF application structures to be recovered.

See BACKUP CFSTRUCT for the rules for CF application structure names.

CMDSCOPE

This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.

CMDSCOPE cannot be used for commands issued from the first initialization input data set CSQINP1.

' '

The command is executed on the queue manager on which it was entered. This is the default value.

qmgr-name

The command is executed 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 a true recovery on the CF structures. This is the default.

PURGE

Recover to empty CF structures. Any messages in the CF structures are lost.

 

Usage notes

1. The command fails if TYPE(NORMAL) is specified and the application structure has not been flagged as in a FAILED state.

2. The command fails if any one of the specified structure names is not defined in the CFRM policy data set.

3. The recover process is both I/O and CPU 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.

4. 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.

5. 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.

 

WebSphere is a trademark of the IBM Corporation in the United States, other countries, or both.

 

IBM is a trademark of the IBM Corporation in the United States, other countries, or both.