Rules for saving and restoring journal receivers

The restore relationships for journal receivers associated with remote journals are described in this topic.

The following figure illustrates the restore relationships for journal receivers that are associated with remote journals, based on the remote journal type.


Restore relationships for journal receivers and remote journals.

Image description

There are several unique rules which govern where the journal receivers that are associated with a remote journal can be restored. The rules also discuss the placement of the journal receivers in the receiver directory chain of a local or remote journal. These rules are influenced by the remote journal type of the journal to which the journal receiver was attached. These rules are also influenced by the library redirection that was in effect when that receiver was attached. See Types of remote journals.

Note: You can always save receivers from a journal, and then restore the receivers to another local journal of the same name. However, they will be placed in their own separate receiver chain.

The following items describe the rules that the system uses when restoring journal receivers:

  1. The system first attempts to find an appropriate remote journal. When searching for a remote journal, the system follows the following rules:
    1. If the saved receiver was originally associated with a local or *TYPE1 remote journal, then the system searches for a *TYPE1 remote journal.
      1. If a *TYPE1 remote journal was defined at the time this receiver was attached, then use the journal and receiver library redirection that was in effect and saved with the receiver. If no *TYPE1 remote journal was defined at the time this receiver was attached, then the original journal library and receiver library names will be used when searching for the *TYPE1 remote journal.
      2. If a *TYPE1 remote journal is found, and the current receiver library redirection for the found *TYPE1 remote journal matches the library name where the receiver is being restored, the journal receiver will be associated with the found *TYPE1 remote journal.
    2. If the receiver was originally associated with a *TYPE2 remote journal, then the system searches for a *TYPE2 remote journal. When searching for the *TYPE2 remote journal, a journal with the same name as the name that was saved with the receiver will be used.
      1. The journal receiver will be associated with a found *TYPE2 remote journal if the following conditions are met:
        • A *TYPE2 remote journal is found with the correct name in the correct library.
        • The found journal is in the exact same remote journal network as that of the saved receiver.
        • The receiver is being restored to the same named system or same named ASP group as the name of the system or ASP group at the time the receiver was saved.
  2. If a remote journal was not found, then the system searches for a local journal. When searching for a local journal, the original journal and journal library names are used.

    The journal receiver will be associated with a found local journal if the following conditions are met:

    • A local journal is found by the correct name in the correct library.
    • The original journal receiver library name for the found journal matches the library name where the receiver is being restored.
  3. If a local journal cannot be found, the restore operation will be allowed to proceed. The journal receiver will not be associated with any journal, if the receiver is being restored to the original or redirected receiver library.
  4. Still honoring the previous receiver restore rules, the following must also be true if the receiver is being restored over an existing receiver:
    1. If the receiver is not being associated with any journal (as previously determined from the prior receiver restored rules), then following items apply:
      1. The receiver creation time stamps must match.
      2. If the saved receiver was ever associated with a journal, then it must have been previously associated with a journal of the same type as that of the existing receiver.
      3. If the saved receiver was ever associated with a remote journal network, then it must have been previously associated with the same remote journal network as that of the existing receiver.
      4. The saved receiver must have at least as many entries as the existing receiver.
    2. If the receiver is being associated with a local journal, then the following items apply:
      1. If the saved receiver was originally associated with a local journal, then the receiver creation time stamps must match.
      2. If the saved receiver was not originally associated with a local journal, then the saved receiver must have been originally associated with the same remote journal network as that of the existing receiver.
      3. The saved receiver must have at least as many entries as the existing receiver.
    3. If the receiver is being associated with a *TYPE1 remote journal, then the following items apply:
      1. The receiver creation time stamps must match, and the saved receiver must have been originally associated with a local or *TYPE1 remote journal.
    4. If the receiver is being associated with a *TYPE2 remote journal, then the following items apply:
      1. The receiver creation time stamps must match, and the saved receiver must have been originally associated with the same *TYPE2 remote journal.

When receivers are saved from or restored to a target system and associated with a remote journal, no journal entries are deposited to indicate that the save or restore occurred. However, the object save and restored date and time stamps are updated accordingly.

Related concepts
Types of remote journals
Considerations for restoring objects saved with SAVSTG

Save and restore considerations

Considerations for remote journal receivers
Do not save the receiver while it is attached to the remote journal. If it is a long running save it can inhibit a change journal operation that was initiated by the source and the remote journaling environment can time out and fail.
Nonreplicated journal receiver protection considerations
The protection provided, which prevents journal receivers that are not fully replicated to all associated remote journals from being deleted, is removed when the journal receiver is restored.
Unconfirmed journal entries save considerations
When a journal receiver that is associated with a remote journal is saved, only those journal entries which have been confirmed are saved to the media. Therefore, no unconfirmed journal entries, nor any journal entries that would not survive any IPL journal recovery processing, will be saved.
Journal receivers saved with STG(*FREE) considerations
Even if a journal receiver has not been fully sent to all known remote journals, such a journal receiver can be saved with STG(*FREE). However, a diagnostic message is left in the job log indicating the freeing of the journal receiver storage without the journal receiver first being fully replicated to all downstream remote journals. This is in contrast to the default action taken when attempting to delete a receiver that has not been fully replicated to all downstream remote journals.