Derivation: Common Execution Environment DUMP

The CEEDUMP runtime option is used to specify options to control the processing of the Language Environment dump report CEEDUMP.

Non-CICS default

CEEDUMP=((60,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR)

CICS® default

CEEDUMP=((60,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR)

AMODE 64 default

CEEDUMP=((60,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR)

Syntax

>>-CEEDump--=--(--(--page_len--,-------------------------------->

>--SYSOUT=--+-*------------------------------------+--,--------->
            +-class--------------------------------+      
            +-(class)------------------------------+      
            '-(--+-------+--,--,--+-----------+--)-'      
                 '-class-'        '-form-name-'           

   .-FREE=END---.     .-SPIN=UNALLOC-.        .-OVR----.      
>--+-FREE=CLOSE-+--,--+-SPIN=NO------+--)--,--+-NONOVR-+--)----><

page_len

Specifies the number of lines that a CEEDUMP report contains on each page. The number specified by page_len must be 0 or a whole number greater than 9. A value of 0 indicates that the dump report contains no page breaks. The default is 60.

The maximum length of page_len is limited to 9 digits.

SYSOUT=

Specifies SYSOUT attributes for a dynamically allocated CEEDUMP DD. SYSOUT has three possible parameters, of which two can be specified.

class

Specifies a value that is one character in length. Valid values are A through Z, 0 through 9, and *. A SYSOUT class must not be specified inside quotation marks.

• If class is not specified, it defaults to * for the dynamically allocated CEEDUMP.
• If dynamic allocation for the specified SYSOUT class fails, SYSOUT=* is set and message CEE3785I is issued.

writer-name

This parameter is not supported and must be omitted.

form-name

Provides a name assigned to an output form for dynamically allocated CEEDUMP DD. form-name is made up of 1-4 alphanumeric or national ($,#,@) characters according to JCL rules. If you want to allow separation of CEEDUMP output from other SYSOUT output for the same class in the JES spool, specify a form in addition to a class for a dynamically allocated CEEDUMP.

FREE=

Specifies that dynamically allocated CEEDUMPs have one of the following JCL DD attributes:

END

The FREE=END DD attribute requests that the system unallocate the data set at the end of the last step that references the data set. This is the default value for this suboption.

CLOSE

The FREE=CLOSE DD attribute requests that the system unallocate the data set when it is closed. Code the FREE=CLOSE suboption along with SYSOUT=class to make CEEDUMP a spinning data set.

SPIN=

Specifies that dynamically allocated CEEDUMPs have one of the following JCL DD attributes:

UNALLOC

The SPIN=UNALLOC DD attribute indicates that the system needs to make the SYSOUT data set available for processing immediately when it is unallocated. This is the default value for this suboption.

NO

The SPIN=NO DD attribute indicates that the system needs to make the SYSOUT data set available for processing as a part of the output at the end of the job, regardless of when the data set is unallocated.

OVR

Specifies that the option can be overridden.

NONOVR

Specifies that the option cannot be overridden.

CICS considerations

The SYSOUT=, FREE=, and SPIN= suboptions do not affect the CEEDUMP report taken under CICS

Usage notes

• If a CEEDUMP DD card is explicitly coded in a job step, Language Environment ignores any SYSOUT class, form-name, FREE, or SPIN specified in the CEEDUMP runtime.
• The SYSOUT=class suboption is overridden by _CEE_DMPTARG when this environment variable is used at the same time to indicate the SYSOUT class.
• The page_len suboption is overridden by the CEE3DMP PAGESIZE option. For more information about CEE3DMP, see z/OS Language Environment Programming Reference.
• Language Environment® supports the use of a CEEDUMP DDNAME dynamically allocated with the XTIOT, UCB nocapture, or DSAB-above-the-line options specified in the SVC99 parameters (S99TIOEX, S99ACUCB, S99DSABA flags).