Previous Topic

Next Topic

Book Contents

Book Index

Preparing the Skeleton

To use a printing mission in batch mode, a skeleton member must be prepared in the Control‑D SKL library. The skeleton member can be either a job skeleton or a started task skeleton. For more information, see sample member PRTSKL in the Control‑D SKL library.

The skeleton member can contain parameters that are interpreted by the Control‑D monitor. The following table describes these parameters:

Table 137 Skeleton Member Parameters

Parameter

Description

%COM#%

Number of the COM file record assigned to this mission.

%MISSION%

Mission name.

%CATEGORY%

Mission category.

%GROUP%

Mission group.

%OWNER%

Mission owner ID.

%PRTY%

Mission priority.

%DEST%

Mission destination first specification.

%UDEST%

Mission destination second specification

When Control‑D finishes preparing the member for submission, control is passed to User Exit CTDX009. This exit can modify the contents of the submitted job (by adding, deleting or modifying the JCL). The exit can return the return codes described in the following table:

Table 138 Return Codes for Exit CTDX009

Return Code

Description

0

Submit the job.

4

Do not submit the job. User Exit CTDX009 can request Control‑M to submit the job. Job submission can be done through CTMAJO routines to ensure correct handling of the print job under Control‑M.

8

Do not submit the job. Terminate the mission with NOTOK status.

Synchronization between the printing mission and the Control‑D monitor is achieved by creating a special control subtask for each printing mission in the Control‑D address space. (The same method is used to synchronize the Control‑D and Printers Control monitors.) This control subtask is synchronized with the corresponding print task through the ENQ mechanism. The QNAME for this ENQ is taken from Control‑D installation parameter PRTSTC in member CTDPARM in the IOA PARM library.

To run a batch printing mission on a CPU other than the CPU in which the Control‑D monitor runs, this QNAME must be shared through GRS, MIM, or other enqueue manager products.

If parameter PRTMON# is set to 0 in member CTDPARM, no Printers Control monitors are started. In this case, parameter BATCH in the printing mission must be set to Y (Yes).

For additional considerations on running printing missions in batch mode, see One-Outgroup Method (JES2 Only).

Printing mission abend or timeout does not cause termination of Control‑D monitors. In such cases, the printing mission terminates with a status of NOTOK.

Parent Topic

Printing Mission Workflow