[z/OS]

BACKUP CFSTRUCT

Use the MQSC command BACKUP CFSTRUCT to initiate a CF application structure backup.

Using MQSC commands

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

For an explanation of the symbols in the z/OS® column, see Using commands on z/OS.

IBM® i UNIX and Linux® Windows z/OS
      CR
Synonym: None

BACKUP CFSTRUCT

Read syntax diagramSkip visual syntax diagram BACKUP CFSTRUCT ( structure-name ) CMDSCOPE(' ')CMDSCOPE(qmgr-name)EXCLINT(integer)

Usage notes for BACKUP CFSTRUCT

  1. This command is valid only on z/OS when the queue manager is a member of a queue-sharing group.
  2. Only persistent shared queue messages are backed up. Non-persistent messages are not backed up and cannot be recovered
  3. 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.
  4. This command fails if the specified CF structure is defined with either a CFLEVEL less than 3, or with RECOVER set to NO.
  5. 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.

Keyword and parameter descriptions for BACKUP CFSTRUCT

structure-name
The name of the coupling facility (CF) application structure to be backed up. An asterisk (*) on its own specifies all recoverable CF structures. A trailing asterisk (*) matches all recoverable structure names with the specified stem followed by zero or more characters. The value (CSQ*) matches all recoverable CF structures with the specified stem (CSQ) followed by zero or more characters.
CMDSCOPE
This parameter specifies how the command is executed when the queue manager is a member of a queue-sharing group.
' '
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 that defines a number of seconds that are used as an exclusion time. The backup excludes backing-up activity during this exclusion time. The exclusion time starts immediately before the back up starts. For example, if EXCLINT(30) is specified, the backup does not include the last 30 seconds worth of activity for this application-structure before back up started.

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