CEEDUMP

Derivation: Common Execution Environment DUMP

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

The default value for non-CICS applications is CEEDUMP(60,SYSOUT=*,FREE=END,SPIN=UNALLOC).

The default value for CICS® applications is CEEDUMP(60,SYSOUT=*,FREE=END,SPIN=UNALLOC).

The default value for AMODE 64 is CEEDUMP(60,SYSOUT=*,FREE=END,SPIN=UNALLOC).


Syntax

>>-CEEDump--(--+----------+--,---------------------------------->
               '-page_len-'      

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

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

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 should contain 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, but the second parameter should always be omitted:.

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 specified fails, SYSOUT=* is set and message CEE3785I is issued.

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 will have one of the following JCL DD attributes:

END: The FREE=END DD attribute requests that the system unallocates 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 unallocates 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 will have one of the following attributes:

UNALLOC: The SPIN=UNALLOC attribute indicates the system should 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 attribute indicates the system should 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.

z/OS UNIX considerations

The SYSOUT=, FREE= and SPIN= suboptions do not have any effect on a CEEDUMP report taken in a z/OS UNIX file system.

CICS consideration

The SYSOUT=, FREE= and SPIN= suboptions do not have any effect on a 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, FREE, SPIN or form-name 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® Customization.
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).

CICS considerations

CEED(,SYSOUT=X,FREE=CLOSE)
This dynamically allocates a CEEDUMP with SYSOUT class X and the FREE=CLOSE DD attribute. The other implicit suboptions are page_len and SPIN, which default to whatever values are currently set in the CEEDUMP runtime option.
CEEDUMP(40)
The CEEDUMP report contains a page length of 40 lines. The other implicit suboptions are SYSOUT=, FREE=, and SPIN=, which default to whatever values are currently set in the CEEDUMP runtime option.