CHGJRNDM - Change journal receivers

Use this command to generate new journal receivers for a specified journal on the source server. You can also use this command to delete processed and obsolete journal receivers.

A processed receiver is one where all of the journal entries in the receiver have been completely applied to all associated subscribers. An obsolete receiver is one that is no longer used by CDC Replication. You should schedule this command to run daily, and if dealing with high data volumes, several times daily. This ensures that journal receivers do not grow too large and add unnecessary performance overhead. This command can only be applied to journals that are managed by CDC Replication, such as the product default journal (DMCJRN). If a physical file was being journaled prior to CDC Replication installation, the existing journal (as opposed to the default journal DMCJRN) is used for that file.

When CDC Replication has been set up and installed to replicate from a remote journal, you must issue this command from the source server where the remote journal resides. If you decide to delete a journal receiver, then CDC Replication deletes both the local journal receivers on the Data Origin Server and the remote journal receivers on the Source Server. See CHGJRNDM - Change remote journal receivers.

Note: Changing and deleting receivers could affect High Availability (HA) products that depend on them. Before you use these options, ensure that there are no other dependencies on the journals the command will be applied to.

Applies To—Source

Parameters

Table 1. Supported keywords
Keywords	Description	Choices	Notes
JOURNAL	Journal name	`Qualified object name`	Required
	Qualifier 1: Journal name	`Name`, *ALL
	Qualifier 2: Library	`Name`
CHGRCV	Change receiver	YES, NO	Optional
DLTRCV	Delete receivers	DFT, NO, *YES	Optional

Journal name (JOURNAL)

The name of the journal for which journal receivers are generated

This is a required parameter.

Qualifier 1: Journal name

Name: Specifies the name of the journal for which journal receivers are generated.
*ALL: Specifies all journals in the library that are used by CDC Replication.; This is the default setting.

Qualifier 2: Library

Name: The name of the library where the journal resides.

Change receiver (CHGRCV)

Indicates whether or not journal receivers are changed for the specified journals.

*NO: Indicates that journal receivers are not changed for the specified journals. You need to change the journal receivers manually.
*YES: Indicates that journal receivers are changed for the specified journals.; This is the default setting.

Delete receivers (DLTRCV)

Specifies whether or not you want to delete processed or obsolete journal receivers associated with the journal.

*NO: Specifies that you do not want to delete processed or obsolete journal receivers associated with the journal. These receivers remain until you delete or archive them.
*YES: Specifies that you want to delete processed and obsolete receivers associated with the journals.
*DFT: Specifies that you want to delete processed and obsolete receivers associated with the CDC Replication default journal. This setting applies only when JOURNAL is set to the current CDC Replication default journal, which is specified in the CHGDMSVAL command.; This is the default setting.

Result

Relevant messages are produced to the job log.

Examples

CHGJRNDM JOURNAL(LIB1/*ALL)

Journal receivers associated with all journals in library LIB1 that are used by CDC Replication are changed. Processed and obsolete journal receivers for the CDC Replication default journal are not deleted. The default setting for the DLTRCV parameter is only applicable when the current default CDC Replication journal is specified for JOURNAL.

CHGJRNDM JOURNAL(LIB1/DMCJRN)
CHGRCV(*YES) DLTRCV(*DFT)

Journal receivers associated with the CDC Replication default journal DMCJRN in library LIB1 are changed. Processed and obsolete journal receivers for DMCJRN are deleted.

CHGJRNDM JOURNAL(LIB1/DMCJRN)
CHGRCV(*NO) DLTRCV(*NO)

Journal receivers associated with the CDC Replication default journal DMCJRN in library LIB1 are not changed. Processed and obsolete journal receivers for DMCJRN are not deleted.