CL Command Reference - CHGRMTJRN
CL Command List > CHGRMTJRN Reference
Description:
The Change Remote Journal (CHGRMTJRN) command is used to change the journal state for remote journals.
This command is used on the source system for a remote journal that is associated with a source-system journal, to change the state of the remote journal from *ACTIVE to *INACTIVE or from *INACTIVE to *ACTIVE. A journal state of *ACTIVE for a remote journal indicates that journal entries can be received from the associated journal on the source system. A journal state of *INACTIVE for a remote journal indicates that the journal is not ready to receive journal entries from a source journal. This command also allows additional attributes that are associated with the journal state to be set.
The Change Journal (CHGJRN) command can be used to modify the other journal attributes of remote journals, such as the journal message queue, deleting receivers, and text.
Restrictions:
. A user profile must exist on the target system by the same name as the user profile that is running this command on the source system. This restriction is irrespective of the selected communications protocol.
. Synchronous delivery mode is not supported when a remote journal is specified for the source system journal name parameter.
. The journal state of the remote journal to be activated cannot already be *ACTIVE.
. The journal state of the remote journal to be inactivated cannot already be *INACTIVE.
. If the remote journal state is *CTLINACT, then the remote journal cannot be inactivated by specifying a INACTOPT(*CNTRLD).
. The remote journal to be activated cannot already be replicating journal entries to other remote journals.
. A journal receiver that was one of a pair of dual receivers cannot be replicated.
. A journal receiver that was never attached to a journal after Version 4 Release 2 Modification 0 has been installed cannot be replicated because all of the required information is not contained within the receiver.
. The specified relational database directory entry (RDB) must meet the following rules:
¨C The communications protocol must be one of the remote journal function supported protocols.
¨C The remote location name in the RDB cannot refer to the *LOCAL database.
¨C The RDB cannot use an application requester driver program (*ARDPGM) to locate the target system.
Examples:
Example 1: Activating a Remote Journal to be Maintained Asynchronously
CHGRMTJRN RDB(CHICAGO)
SRCJRN(LCLLIB/JOURNAL1) TGTJRN(RMTLIB/JOURNAL1)
JRNSTATE(*ACTIVE) DELIVERY(*ASYNC)
SNDTSKPTY(*SYSDFT)
This command activates remote journal JOURNAL1 in library RMTLIB so that journal entries will be replicated from source journal JOURNAL1 in library LCLLIB to remote journal JOURNAL1 in library RMTLIB. The replication will occur asynchronously, and the system will set the priority of the sending task.
Example 2: Inactivating a Remote Journal
CHGRMTJRN RDB(CHICAGO) SRCJRN(LCLLIB/JOURNAL1)
TGTJRN(RMTLIB/JOURNAL1)
JRNSTATE(*INACTIVE) INACTOPT(*IMMED)
This command inactivates remote journal JOURNAL1 in library RMTLIB so that journal entries will no longer be replicated from source journal JOURNAL1 in library LCLLIB to remote journal JOURNAL1 in library RMTLIB. The inactivation will occur immediately.