Changing the remote journal environment - assure_mimix - 10.0

Use the following checklist to guide you through the process of changing an existing remote journal configuration. For example, this procedure is appropriate for changing a journal receiver library for the target journal in a remote journaling (RJ) environment or for any other changes that affect the target journal. These steps can be used for synchronous or asynchronous remote journals.

Important! Changing the RJ environment must be done in the correct sequence. Failure to follow the proper sequence can introduce errors in replication and journal management. Also, before making changes, review the naming convention requirements for a remote journaling environment. Some changes may require changing additional journal definitions. See Journal definition naming conventions.

Perform these tasks from the MIMIX management system unless these instructions indicate otherwise.

1. Verify that no other data groups use the RJ link using topic Identifying data groups that use an RJ link.

2. Use topic “Ending a data group in a controlled manner” in the Assure MIMIX Operations book to prepare for and perform a controlled end of the data group and end the RJ link. Specify the following on the ENDDG command:

   • *ALL for the Process prompt

   • *CNTRLD for the End process prompt

   • *YES for the End remote journaling prompt.

3. Verify that the remote journal link is not in use on both systems. Use topic “Displaying status of a remote journal link” in the Assure MIMIX Operations book. The remote journal link should have a state value of *INACTIVE before you continue.

4. Remove the connection to the remote journal as follows:

   1. Access the journal definitions for the data group whose environment you want to change. From the Work with Data Groups display, type a 45 (Journal definitions) next to the data group that you want and press Enter.

   2. Type a 12 (Work with RJ links) next to either journal definition you want and press Enter. You can select either the source or target journal definition.

      Note: The target journal definition will end with @R.
   3. From the Work with RJ Links display, choose the link based on the name in the Target Jrn Def column. Type a 15 (Remove RJ connection) next to the link with the target journal definition you want and press Enter.
   4. A confirmation display appears. To continue removing the connections for the selected links, press Enter.

5. From the Work with RJ Links display, do the following to delete the target system objects associated with the RJ link:

   Note: The target journal definition will end with @R.
   1. Type a 24 (Delete target jrn environment) next to the link that you want and press Enter.
   2. A confirmation display appears. To continue deleting the journal, its associated message queue, and the journal receiver, press Enter.

6. Make the changes you need for the target journal.

   For example to change the target (remote) journal definition to a new receiver library, do the following:

   1. Press F12 to return to the Work with Journal Definitions display.

   2. Type option 2 (Change) next to the journal definition for the target system you want and press Enter.

7. From the Work with Journal Definitions display, type a 14 (Build) next to the target journal definition and press Enter.

   Note: The target journal definition will end with @R.

8. Return to the Work with Data Groups display. Then do the following:

   1. Type an 8 (Display status) next to the data group you want and press Enter.

   2. Locate the name of the receiver in the Last Read field for the Database process.

9. Do the following to start the RJ link:

   1. From the Work with Data Groups display, type a 44 (RJ links) next to the data group you want and press Enter.

   2. Locate the link you want based on the name in the Target Jrn Def column. Type a 9 (Start) next to the link with the target journal definition and press F4 (Prompt).

   3. The Start Remote Journal Link (STRRJLNK) appears. Specify the receiver name from Step 8b as the value for the Starting journal receiver (STRRCV) and press Enter.

10. Start the data group using default values Refer to topic “Starting selected data group processes” in the Assure MIMIX Operations book.