MUPIP SET is the primary utility used to establish and activate journaling (using the /JOURNAL qualifier) and replication (using the /REPLICATION qualifier).
This section provides a description of the MUPIP SET command with specific reference to the journaling related qualifiers, /JOURNAL and /REPLICATION.
When GDE creates a Global Directory, it stores there either the explicitly specified journaling information, or the GDE default value (detailed under each journal-option-subsection) for any unspecified characteristics.
MUPIP CREATE copies existing journaling information from the Global Directory to the database file, establishing journaling characteristics for all GDE supported journal-options.
![[Note]](images/note.png)
|
Note |
|---|---|
|
The journaling information in the Global Directory is applied to a database file only when it is created. Thereafter use MUPIP or possibly DSE to change journaling characteristics in database files. |
DSE DUMP /FILEHEADER displays the current values for all established journaling characteristics.
MUPIP SET /JOURNAL or /REPLICATION changes some database characteristics, such as whether journaling or replication is active for a specific file or region(s). MUPIP SET operates on either regions or files.
The format for the SET command is:
SE[T] /qualifier... file-spec or region-list
The file-specification or region-list identifies the target of the SET. Region-names separated by commas (,) make up a region-list. Region-names may include the DCL wildcards percent (%) and asterisk (*). For a summary table of MUPIP commands and qualifiers including MUPIP SET, refer to the "MUPIP" chapter.
The MUPIP SET command to establish journaling or replication characteristics must include one of the following qualifiers:
-
/F[ILE]
-
/R[EGION]
Together with one or more of the qualifiers:
-
/[NO]JOURNAL[=journal-option-list]
-
/REPLICATION=<replication-option>