Activating the replication of journal entries to a remote journal

 

In order to activate the replication of journal entries to a given remote journal, the following must be true:

• The remote journal that you wish to activate must not have a journal state of *ACTIVE. For instance, this might seem to be a reasonable request if you wanted to simply change the delivery mode from synchronous to asynchronous. However, the remote journal must be inactive before you can activate it.

• The remote journal that you wish to activate must not be actively replicating journal entries to other remote journals, as in a cascade configuration. You must inactivate the remote journals that are immediately downstream before activating the remote journal.

You need to provide the following input in order to activate the replication of journal entries to a remote journal on a target system:

• The journal name and library on the source system from which journal entries will be replicated.

• The remote journal name and library on the target system to which journal entries will be replicated.

• A relational database directory entry, which identifies the target system and other necessary communications information.

• The delivery mode to be used. Specify either synchronous or asynchronous delivery mode.

• The journal receiver from which to start journal entry replication which defines the starting point for journal entry replication.

• If an asynchronous delivery mode was specified, then the sending task priority may also be specified. If a value is not specified, the system selects a default priority, which is higher than what the user can specify for this value. Setting this value too large may cause a greater journal entry latency or lag.

To activate the remote journal, proceed as follows:

1. In the iSeries™ Navigator window, expand the system you want to use.

2. Expand Databases.

3. Expand the database that contains the journal.

4. Expand Schemas.

5. Click the schema that contains the journal that has the associated remote journal that you want to activate.

6. Right-click the journal, and select Properties.

7. On the Journal Properties dialog, click Remote Journals.

8. On the Remote Journals dialog, select the remote journal in the list of remote journals, and then click Activate to activate the selected remote journal.

You can also activate the replication of journal entries from a journal on a source system to a remote journal on a target system by using one of the following methods:

• The Change Journal State (QjoChangeJournalState) API

• The Change Remote Journal (CHGRMTJRN) command

Both the QjoChangeJournalState API and the CHGRMTJRN command must be issued from the source system.

The activation of the remote journal can be a long running process. This may occur if there are a large number of journal receivers and entries that initially must be caught-up in the remote journal.

Catch-up phase for remote journals has more detailed information about the catch-up phase.

• Catch-up phase for remote journals
  Catch-up refers to the process of replicating journal entries that existed in the journal receivers of the source journal before the remote journal was activated.

 

Parent topic:

Activating and inactivating remote journals

Related concepts
Synchronous and asynchronous delivery mode for remote journals Where the replication of journal entries start Remote journal considerations when restarting the server

Related tasks
Adding remote journals Details: Recovery for remote journaling scenario

Related reference
Change Journal State (QjoChangeJournalState) API Change Remote Journal (CHGRMTJRN) command

Related information
Scenario: Data replication environment for remote journals