Start of change

Swap journal receiver operations with remote journals

To swap journal receivers on a remote journal, perform a swap journal receiver operation on the source system to attach a new receiver to a local journal. When this happens, the remote journal function automatically attaches a new receiver to the remote journals that are currently being maintained synchronously or asynchronously.

If the journal sequence numbers were reset as part of the swap journal receiver operation performed for the local journal, the remote journal function will also reset the journal sequence number for each remote journal. This keeps the journal sequence numbers synchronized between the local journal and the remote journal. For remote journals that are being synchronously maintained, a coordinated swap journal receiver operation is performed for the local journal on the source system and the remote journals on the target systems. For asynchronously maintained remote journals, the new receiver is attached when the target system receives the journal entry with journal code 'J' and entry type 'PR' (previous receiver).

If the swap journal receiver operation fails on the target system, the remote journal function ends for that remote journal, and processing continues on the source system. The system sends a message to the journal message queue that indicates that the remote journal function failed. When applicable, the system sends remote journal failure type messages to the related journal message queues on both the affected source and target systems. See Work with remote journal error messages for more information.

You cannot initiate a swap journal receiver operation to attach a new receiver directly for a remote journal. New journal receivers are always attached to the remote journal by the remote journal function as new receivers are attached to the local journal. However, you can perform a change journal operation on a remote journal to change several other attributes for the remote journal such as the journal message queue or delete receivers value.

A swap journal receiver operation to attach a new receiver to a local journal that has an associated remote journal in the catch-up phase can be performed. This is regardless of whether the remote journal is currently being caught-up from a detached or the currently attached receiver on the local system. The catch-up phase of processing will not transition into synchronous or asynchronous delivery mode until the end of the currently attached receiver for the local journal is reached.

Related concepts
Journal receiver management with remote journals
Work with remote journal error messages
Related tasks
Swap journal receivers
End of change