Retrieving journal entries from a remote journal during the catch-up phase
During the catch-up phase, journal entries that have been replicated to the target system can be retrieved from the remote journal.
You can activate and inactivate the remote journal function while concurrently running the following commands to view journal entries on the target system:
- Display Journal (DSPJRN)
- Retrieve Journal Entry (RTVJRNE)
- Receive Journal Entry (RCVJRNE)
- Retrieve Journal Entries (QjoRetrieveJournalEntries) API
When the remote journal is in the process of being caught-up from the attached journal receiver on the source system, two things can happen with respect to objects and their names in the journal entries.
- If journaling is started for any objects on the source system, the object name that is given on the target system in the start journal entry may be *UNKNOWN.
- If any move or rename operations take place, the last object name that was known before the catch-up phase started is what will be given. The actual new name may not be available until the catch-up phase is complete.
If you are using the DSPJRN or RTVJRNE command, additional informational messages will indicate that this situation occurred. If you are using the RCVJRNE command, additional information is provided on the exit program interface to help distinguish these situations as well. If you are using the QjoRetrieveJournalEntries API, additional information is provided in the returned data to help distinguish these situations. When necessary, the system attempts to minimize the possibility of showing these inconsistencies by temporarily delaying the processing performed by these commands.
Once the catch-up phase is completed, these inconsistencies will be resolved, and complete information will again be available.
Parent topic:
Getting information about remote journal entriesRelated concepts
Exit program to receive journal entries Activating and inactivating remote journals Receiving journal entries in an exit program