Building the journaling environment - assure_mimix - 10.0

Assure MIMIX Administrator Reference

Product type
Software
Portfolio
Integrate
Product family
Assure
Product
Assure MIMIX™ Software
Version
10.0
Language
English
Product name
Assure MIMIX
Title
Assure MIMIX Administrator Reference
Copyright
2023
First publish date
1999
ft:lastEdition
2024-05-07
ft:lastPublication
2024-05-07T13:36:02.962500

Before replication for a data group can occur, the journal environment for all journal definitions used by that data group must be created on each system. A journaling environment includes the following objects: library, journal, journal receiver, and threshold message queue on the system specified in the journal definition. The Build Journal Environment (BLDJRNENV) command is used to build the journal environment objects for a journal definition. When the BLDJRNENV command is run, if the objects do not exist, they are created based on what is specified in the journal definition. If the journal exists, the Source for values (JRNVAL) parameter of the BLDJRNENV command is used to determine the source for the values of these objects. The journal receiver prefix and library, message queue and library, and threshold parameters are updated from the source specified in the JRNVAL parameter.

Specifying *JRNENV for the JRNVAL parameter changes the values of the objects in the journal definition to match the values in the existing journal environment objects. Specifying *JRNDFN for the JRNVAL parameter changes the values of the journal environment objects to match the values of the objects in the journal definition. In a remote journal environment, the values specified in the journal definition (*JRNDFN) are only applicable to the source journal.

If the data group definition specifies to journal on the target system, the journal environment must be built on each system that will be a target system for replication of that data group. If you do not build either source or target journal environments, the first time the data group starts MIMIX will automatically build the journal environments for you.

Note: When building a journal environment for replication, ensure the journal receiver prefix in the specified library is not already used. If the journal receiver prefix in the specified library is already used, you must change it to an unused value. When building a journal environment for the purpose of exporting status to another application, the Status for extraction policy must be enabled in order to build the journaling environment for extraction.

For switchable data groups not specified to journal on the target system, it is recommended to build the source journaling environments for both directions of replication so the environments exist for data group replication after switching.

All previous steps in your configuration checklist must be complete before you use this procedure.

To build the journaling environment, do the following:

Note: If you are journaling on the target system, perform this procedure for both the source and target systems.
  1. From the MIMIX Main Menu, select 11 (Configuration menu) and press Enter.

  2. From the MIMIX Configuration Menu, select one of the following and press Enter:

    • Select 8 (Work with remote journal links) to build the journaling environments for remote journaling.

    • Select 3 (Work with journal definitions) to build all other journaling environments.

  3. From the Work with display, type 14 (Build) next to the journal definition you want to build and press Enter.

    Option 14 calls the Build Journal Environment (BLDJRNENV) command. For environments using remote journaling, the command is called twice (first for the source journal definition and then for the target journal definition). A status message is issued indicating that the journal environment was created for each system.

  4. To verify that the source journals have been created for a data group, do the following from each system in the data group:

    1. Enter the command WRKDGDFN
    2. From the Work with DG Definitions display, type 12 (Journal definitions) next the data group and press Enter.

    3. The Work with Journal Definitions display is subsetted to the journal definitions for the data group. Type 17 (Work with jrn attributes) next to the definition that is the source for the local system.