RMVRMTJRN (Remove Remote Journal)

RMVRMTJRN Command syntax diagram

 

Purpose

The Remove Remote Journal (RMVRMTJRN) command disassociates a remote journal on the specified target system from the specified journal on the source system. The journal on the source system may be either a local journal or another remote journal.

The remote journal, and any associated journal receivers, are not deleted from the target system by the command processing. No processing is performed on the target system for the command. The remote journal that remains on the target system may later be added back to the remote journal definition for the journal on the source system by using the Add Remote Journal (ADDRMTJRN) command or the Add Remote Journal (QjoAddRemoteJournal) API.

It is the responsibility of the user to delete the remote journal and any associated journal receivers from the target system, if so desired.

Once a remote journal association has been removed from a journal, all of the journal receivers that are currently in the journal's receiver directory on the source system will no longer be protected from deletion even if the journal entries have not yet been replicated to the remote journal.

 

Restrictions

The following restrictions apply:

• The command must be called from the source system for a local or remote journal.
• The remote journal on the specified target system cannot have a journal state of *ACTIVE.
• The specified relational database directory entry (RDB) must meet the following rules:

  • The communications protocol must be one of the remote journal function supported protocols.
  • The remote location name in the RDB cannot refer to the *LOCAL database.
  • The RDB cannot use an application requester driver program (*ARDPGM) to locate the target system.

 

Required Parameters

RDB

The name of the relational database directory entry that contains the remote location name of the target system.

relational-database-entry: Specify a maximum of 18 characters for the name of the relational database directory entry.

SRCJRN

The name of the journal on the source system from which the remote journal is being removed, and the library where it resides. The journal on the source system may be either a local journal or a remote journal.

The name of the source journal can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

source-journal-name: Specify the source journal from which the target journal is being removed.

 

Optional Parameters

TGTJRN

The name of the remote journal on the target system.

*SRCJRN: The target journal name is exactly the same as the source journal name.

library-name/target-journal-name: Specify the target journal that is being removed from the source journal.

Example for RMVRMTJRN

Example 1: Removing a remote journal whose name is the same as the source journal.

RMVRMTJRN   SRCJRN(RMTLIB/JOURNAL) RDB(CHICAGO) TGTJRN(*SRCJRN)

This command removes remote journal JOURNAL in library RMTLIB identified by relational database directory entry, CHICAGO, from the source journal JOURNAL in library RMTLIB.

Error messages for RMVRMTJRN

*ESCAPE Messages

CPF6981

Remote journal &1 in &2 not removed.

CPF6982

Relational database directory entry &1 not valid.

CPF6992

Remote journal &1 in &2 not removed.

CPF9801

Object &2 in library &3 not found.

CPF9802

Not authorized to object &2 in &3.

CPF9803

Cannot allocate object &2 in library &3.

CPF9810

Library &1 not found.

CPF9820

Not authorized to use library &1.

CPF9830

Cannot assign library &1.