BACKUP CFSTRUCT on z/OS

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


Use MQSC commands

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

We can issue this command from sources CR. For an explanation of the source symbols, see Use commands on z/OSĀ®.

Synonym: None

BACKUP CFSTRUCT

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. We can concurrently run separate backups for different application structures on different queue managers within the queue sharing group. We 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 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.

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