Tailor the Execution JCL

Starting Your Product › How to Configure Without CA MSM › Tailor the Execution JCL

Tailor the Execution JCL

This step is for all CA Dispatch installations.

The CAI Common procedure library (CADSPROC) contains all of the procedures relevant to CA Dispatch and CADDSPL. These procedures were placed there during the SMP APPLY processing. You can review these procedures; however, the execution JCL provides all the necessary overrides.

You will find the execution JCL in your CAI Common JCL library (CADSJCL). The member names that begin with DSEX are executed once the product is installed. The member names that begin with DSIN are used for installation of the product. The installation members may contain inline procedures, and the execution JCL members execute procedures in the CAI.CADSPROC library.

Optionally, you may copy members beginning with CADS (in CADSPROC) into a PROCLIB of your choice, or the CADSPROC library can be added to the system PROCLIB concatenations.

The CA Dispatch members that you need to modify at this time are:

JCL Type	CAIJCL Name	Description
EXECUTION JCL	DSEXJNL1	Offload journal files (this is extremely important)
	DSEXDISP	CA Dispatch batch startup JCL
	DSEXXTAR	Start the external Archive subtask 1
	DSEXXTR2	Start the external Archive subtask 2

JCL Type	CAIJCL Name	Description
	DSEXXTR3	Start the external Archive subtask 3
	DSEXXTEX	Start the external Extract subtask
BACKUP/ RESTORE JCL	DSEXBR01	Back up CA Dispatch to tape
	DSEXBR04	Restore CA Dispatch from tape
PERIODICAL SERVICES JCL (batch maintenance)	DSEXPSAR	Archive Periodic Services - delete Archive reports and MSGCLASS that have met their retentions, scratch tape volumes that no longer have active reports. Must run with Dispatch up, subtasks up or down.
	DSEXPSVW	Online Viewing Periodic Services – delete OLV reports and MSGCLASS that have met their retentions. Must run with Dispatch up, subtasks up or down.
	DSEXPSST	Status Periodic Services – delete Status records when they have exceeded their retentions. Must run with Dispatch up, subtasks down.
	DSEXTMIG	Archive Periodic Services - delete Archive reports and MSGCLASS that have met their retentions, scratch tape volumes that no longer have active reports. Must run with Dispatch down.
	DSEXVIEW	Online Viewing Periodic Services – delete OLV reports and MSGCLASS that have met their retentions. Must run with Dispatch down.
	DSEXPURG	Status Periodic Services – delete Status records when they have exceeded their retentions. Must run with Dispatch down.

If you want to run CA Dispatch as a started task, modify CADSPROC member CADSDISP accordingly.

CADDSPL PROCLIB Name	Description
CADDSPLx	CADDSPLx initialization and startup JCL The trailing task suffix "x" identifies a unique CADDSPL environment. This proc is started as an STC started task.The following naming convention must be adhered to for the start-up proc and spawned tasks: CADDSPLx and CADZSPLx Warning: If you attempt to submit CADDSPLx as a batch job the CADZSPLx and CADZSAPx jobs will not be automatically spawned and a CADD300E error message may be issued at start-up.
CADZSPLx	CADDSPL Main proc The trailing task suffix "x" identifies a unique CADDSPL environment.
CADZSAPx	CADDSPL SAPI proc The trailing task suffix "x" identifies a unique CADDSPL environment. Do not submit this job! This job is automatically started by CADZSPLx as needed. This proc is automatically submitted when the first SAPI task is started. It is stopped when the last SAPI task has shut down..

Important! Do not submit this job! This job is started automatically by CADDSPLx.

Copy, and optionally rename, the CADDSPLx, CADZSPLx, and CADZSAPx procedures to a valid system procedure library.

You must define one set of these three procedures for each CADDSPL environment you want to execute. The trailing one-character task suffix "x", identifies a unique CADDSPL environment.