BACKUP CFSTRUCT

 

Use BACKUP CFSTRUCT to initiate a CF application structure backup.

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: None 

BACKUP CFSTRUCT
 
                                    .-CMDSCOPE(' ')-------.
>>-BACKUP CFSTRUCT(structure-name)--+---------------------+----->
                                    '-CMDSCOPE(qmgr-name)-'
 
>--+------------------+----------------------------------------><
   '-EXCLINT(integer)-'

 

Keyword and parameter descriptions

structure-name
The name of the Coupling Facility application structure to be backed up.

The name:

  • Cannot have more than 12 characters.

  • Must start with an uppercase letter (A through Z).

  • Can include only the characters A through Z and 0 through 9.

The name of the queue-sharing group to which the queue manager is connected is prefixed to the name you supply. The name of the queue-sharing group is always four characters, padded with @ symbols if necessary. For example, if you use a queue-sharing group named NY03, and you supply the name PRODUCT7, the resultant Coupling Facility structure name is NY03PRODUCT7.

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 the command server is enabled.

EXCLINT(integer)
Specifies a value in seconds that defines the length of time immediately before the current time where the backup starts. The backup excludes backing-up the last n seconds activity. For example, if EXCLINT(30) is specified, the backup does not include the last 30 seconds worth of activity for this application-structure.

The value must be in the range 30 through 600. The default value is 30.

 

Usage notes

  1. You can concurrently run separate backups for different application structures on different queue managers within the queue-sharing group. You can also concurrently run separate backups for different application structures on the same queue manager.

  2. This command fails if the specified CF structure is defined with either a CFLEVEL less than 3, or with RECOVER set to NO.

  3. The command fails if a specified application structure is currently in the process of being backed up by another queue manager within the queue-sharing group.

 

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.