MUPIP BACKUP Qualifiers

MUPIP BACKUP supports the following two qualifiers for establishing journaling characteristics on the backup as well as the active databases.

/BKUPDBJNL="DISABLE | OFF"

The purpose of the optional /BKUPDBJNL qualifier is to define the journaling characteristics of the BACKUP database. This qualifier must be used if the backup database is to be opened at the same time in the same environment as the original database. This is because two database files cannot share a single journal file.

A value of DISABLE indicates journaling is disabled in the backup database. A value of OFF indicates journaling is turned off in the backup database. Only one of the qualifiers DISABLE or OFF can be specified at any given point in time.

[Note] Note

By default, the journaling characteristics of the current database are preserved in the backup database. This produces a database that is ready for use (inserted in place of the current database file), with the existing journal files.

/[NO]NEWJNLFILES[=[NO]PREVLINK]

/NEWJNLFILES causes a transaction-consistent set of new journal files to be created, for database files in the backup. All established journaling characteristics apply to the new journal files. This qualifier is effective only for an ONLINE backup (the default), when the database has journaling enabled. The /NEWJNLFILES qualifier can take on the following two values:

  • PREVLINK (the default value), to indicate that there should be back linking of the newly created journals with the current journals.

  • NOPREVLINK, to indicate that there is no back linking between the newly created journals and current journals.

Specification of the /NEWJNLFILES qualifier causes new journal files to be created as if a MUPIP SET /JOURNAL=(ON, xxxx) command was specified. Where xxxx is BEFORE_IMAGES or NOBEFORE_IMAGES based on the current database characteristics.

The /NONEWJNLFILES qualifier causes processing to continue using the current journal files and does not accept an argument assignment. The default is /NEWJNLFILES.