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.