CL Command Reference - DLTJRNRCV

CL Command List > DLTJRNRCV Reference

Description:

The Delete Journal Receiver (DLTJRNRCV) command deletes the specified journal receivers from the system, which frees the storage space allocated to the journal receivers. Exit point QIBM_QJO_DLT_JRNRCV is provided for the DLTJRNRCV command.

Restrictions:

. The journal receiver must not be attached to a journal at the time the command is issued.

. If an attempt is made to delete a journal receiver that is attached to a remote journal, and that remote journal is not actively receiving journal entries or replicating journal entries, and DLTOPT(*IGNINQMSG) is not specified, an inquiry message (CPA705E) is sent to the requesting workstation. If the request is made from a batch job, the message is sent to the system operator. This inquiry message can be automatically replied to. For more information, refer to the INQMSGRPY parameter of the Create Job Description (CRTJOBD) command.

. The journal receiver must not be in the middle of a chain of online receivers unless it is damaged or if its dual receiver is damaged. (The receivers must be deleted in the same order in which they were detached, to prevent gaps from occurring in the range of receivers).

. If an attempt is made to delete a journal receiver that has not been saved and DLTOPT(*IGNINQMSG) is not specified, an inquiry message (CPA7025) is sent to the requesting work station. If the request is made from a batch job, the message is sent to the system operator. This inquiry message can be replied to automatically. For more information, refer to the INQMSGRPY parameter on the Create Job Description (CRTJOBD) command.

. The user must have *ALLOBJ and *SECADM authority in order to specify the *IGNEXITPGM special value.

. This command is conditionally threadsafe if exit programs are registered for exit point QIBM_QJO_DLT_JRNRCV as follows:
¨C If no exit programs are registered or DLTOPT(*IGNEXITPGM) is specified, the command is threadsafe.
¨C If all exit programs are threadsafe and registered to run in a multithreaded job, the command is threadsafe.
¨C If any exit program is registered to not run in a multithreaded job and is being attempted to run in a multithreaded job, the command will fail and the journal receiver will not be deleted. Use the MLTTHDACN parameter on the ADDEXITPGM command to specify whether an exit program can run in a multithreaded job. See the ADDEXITPGM command for more information.



Examples:

DLTJRNRCV JRNRCV(MYLIB/JRNRCLA)

This command deletes the journal receiver JRNRCLA in library MYLIB from the system.