Sysout Control Parameters

JCL syntax rules forbid the use of certain DD subparameters when the SUBSYS option is used. For example, the following JCL statement results in a JCL syntax error:

//PRINT DD SUBSYS=(CDAM,'XXX'),OUTLIM=100000

To overcome this problem, the user can pass the following sysout control parameters directly to the CDAM:

Note: These parameters are CDAM parameters only. They are not JCL parameters.

• BURST
• CHARS
• COPIES
• DEST

  Note: DEST can only contain a node; it cannot contain a user ID.

• FCB
• FLASH
• FORMS
• MODIFY
• OPTCD
• OUTLIM
• OUTPUT
• SYSOUT
• TRC
• UCS
• PAGEDEF
• FORMDEF

The syntax of the parameters is identical to the JCL syntax as described in the relevant operating system publications. CDAM checks for the correct syntax. For example:

//PRINT DD SUBSYS=(CDAM,'OUTLIM=100000,SYSOUT=(class,extwtr,form)')

The OUTLIM parameter sets a limit on the number of records that can be written to a CDAM. If the limit is reached, a job will abend with code S722. Default value of OUTLIM parameter can be set by optional wish WD0699.

The following sysout control parameters do not behave like standard JCL statements:

OUTPUT=name

This parameter designates the name (1 through 8 characters) of a JCL OUTPUT statement in the Printers Control monitor. It can be specified in the PRINT/CDAM PARMS field of a report decollating mission usually used for decollating AFP output. This OUTPUT statement must be defined in the JCL of the Printers Control monitor. It usually contains the parameters FORMDEF and PAGEDEF (used for AFP output). Control-V does not check whether or not the OUTPUT statement exists in the Printers Control monitor. It is the user’s responsibility to provide a valid OUTPUT statement name.

Note: AFP (Advanced Function Printing) refers to IBM’s laser printing technology. For a full description of AFP printing considerations see the INCONTROL for z/OS Administrator Guide.

PAGEDEF=name

Note: The PAGEDEF parameter is ignored when printing on a non-AFP printer.

This parameter designates the name (1 through 6 characters) of a page definition to be used for printing the output. The page definitions must reside in PAGEDEF libraries specified to Control-V. For information about specifying libraries, refer to the Control-D chapter of the INCONTROL for z/OS Installation Guide.

Do not specify the PAGEDEF parameter together with the OUTPUT parameter. If you do so, the OUTPUT parameter overrides the PAGEDEF parameter.

FORMDEF=name

Note: The FORMDEF parameter is ignored when printing on a non-AFP printer.

This parameter designates the name (1 – 6 characters) of a form definition to be used for printing the output. The FORMDEF parameter must reside in a FORMDEF libraries specified to Control-V. For information about specifying the libraries, refer to the Control\--D chapter of the INCONTROL for z/OS Installation Guide.

Do not specify the FORMDEF parameter with the OUTPUT parameter. If you do so, the OUTPUT parameter overrides the FORMDEF parameter.

COPIES=nn

The sysout control parameter COPIES can be used to specify the number of copies to print if both the JOB DEFAULTS COPIES parameter and the JOB DEFAULTS MAX COPIES parameter of the report decollating mission are both set to 99.

TRC=

Setting parameter TRC (Table Reference Character) to YES produces the same result as including the expression OPTCD=J in the JCL.