|
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
z/OS® UNIX considerations The
SYSOUT=, FREE= and SPIN= suboptions do not affect the CEEDUMP report
taken in a z/OS UNIX file
system.
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).
z/OS UNIX considerations - CEEDUMP=((60,SYSOUT=(C),FREE=END,SPIN=UNALLOC),OVR)
The example
changes the default CEEDUMP settings so that the dynamically allocated
CEEDUMP output will be sent to sysout class 'C'.
- CEEDUMP=((0,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR)
The example
changes the default CEEDUMP CEEDOPT settings so that the CEEDUMP pagelen is
0. This suppresses all page breaks in all the CEEDUMP reports.
|