 |
 The default runtime option values IBM® supplies with Language Environment may not
suit the application programmers' needs at your site. A systems programmer
can modify the IBM-supplied defaults on a system-level or region-level
basis, which can save time by reducing the need to override the runtime
option defaults as often. An application programmer can further refine
these options based on individual program needs. When an application
runs, runtime options are merged in a specific order of precedence
to determine the actual values in effect. For more information about
setting runtime options on an application-level , see z/OS Language Environment Programming Guide and z/OS Language Environment Programming Guide for 64-bit Virtual Addressing Mode. 
System-level defaults can be established through
a member in the system parmlib called CEEPRMxx or with a SETCEE operator
command. Region-level defaults can be established with a CEEROPT
(AMODE 31) or CELQROPT (AMODE 64) load module created by invoking
the CEEXOPT macro. For more information about the runtime options,
default values, and syntax, see Language Environment runtime options.
You might not need to change most default values.
Table 1 summarizes the Language Environment runtime
options, defaults, and recommended settings for applications running
in CICS and non-CICS (for example,
batch or IMS™) environments. The
recommended setting for some runtime options can vary, depending upon
the language used to create the application or if multiple (Multi)
languages are used in the environment. When a recommendation varies,
the applicable settings for the languages are listed in the table.
Also, the table identifies the runtime options that are not applicable
(N/A) in either the CICS or
non-CICS environment; Language
Environment ignores these options if they are specified.
Table 1. Runtime
options, defaults, and recommendations for Language Environment | Option |
Non-CICS |
CICS |
|---|
| Default |
Recommended |
Default |
Recommended |
|---|
| ABPERC |
NONE |
NONE |
N/A |
N/A |
| ABTERMENC (see table note 1) |
ABEND |
ABEND |
ABEND |
ABEND |
| AIXBLD |
OFF |
OFF |
N/A |
N/A |
| ALL31 |
ON |
ON |
ON |
ON |
| ANYHEAP (see table notes 3 and 11) |
16K,8K,ANY,FREE |
16K,8K,ANY,FREE (C, COBOL, Multi,
PL/I) 48K,8K,ANY,FREE (Fortran)
|
4K,4080,ANY,FREE |
4K,4080,ANY,FREE |
| ARGPARSE (see table notes 4 and 12) |
ARGPARSE |
ARGPARSE |
N/A |
N/A |
| AUTOTASK |
NOAUTOTASK |
NOAUTOTASK |
N/A |
N/A |
| BELOWHEAP (see table note 11) |
8K,4K,FREE |
8K,4K,FREE |
4K,4080,FREE |
4K,4080,FREE |
| CBLOPTS (see table note 12) |
ON |
ON |
N/A |
N/A |
| CBLPSHPOP |
ON |
N/A |
ON |
ON |
| CBLQDA |
OFF |
OFF |
N/A |
N/A |
| CEEDUMP |
60,SYSOUT=*,
FREE=END,
SPIN=UNALLOC
|
60,SYSOUT=*,
FREE=END,
SPIN=UNALLOC
|
60,SYSOUT=*,
FREE=END,
SPIN=UNALLOC
|
60,SYSOUT=*,
FREE=END,
SPIN=UNALLOC
|
| CHECK |
ON |
ON |
ON |
ON |
| COUNTRY (see table note 5) |
US |
User-defined |
US |
User-defined |
| DEBUG |
OFF |
OFF |
OFF |
OFF |
| DEPTHCONDLMT |
10 |
0 |
10 |
0 |
| DYNDUMP |
*USERID,NODYNAMIC,
TDUMP
|
*USERID,NODYNAMIC,
TDUMP
|
*USERID,NODYNAMIC,
TDUMP
|
*USERID,NODYNAMIC,
TDUMP
|
| ENV (see table notes 4 and 12) |
No default |
User-defined |
No default |
User-defined |
| ENVAR |
'' |
'' |
'' |
'' |
| ERRCOUNT |
0 |
0 |
0 |
0 |
| ERRUNIT |
6 |
6 |
N/A |
N/A |
| EXECOPS (see table notes 4 and 12) |
EXECOPS |
EXECOPS |
N/A |
N/A |
| FILEHIST |
ON |
ON |
N/A |
N/A |
| FILETAG (see table note 12) |
NOAUTOCVT,
NOAUTOTAG
|
NOAUTOCVT,
NOAUTOTAG
|
N/A |
N/A |
| FLOW (see table note 4) |
NOFLOW |
FLOW |
N/A |
N/A |
| HEAP (see table notes 3 and 11) |
32K,32K,ANY,KEEP,
8K,4K
|
32K,32K,ANY,KEEP,
8K,4K
(C, COBOL, Multi, PL/I) 4K,4K,ANY,KEEP, 8K,4K (Fortran)
|
4K,4080,ANY,KEEP,
4K,4080
|
4K,4080,ANY,KEEP,
4K,4080
|
| HEAP64 |
1M,1M,KEEP,32K,32K,
KEEP,4K,4K,FREE
|
N/A |
N/A |
N/A |
| HEAPCHK (see table note 9) |
OFF,1,0,0,0,1024,0,
1024,0
|
OFF,1,0,0,0,1024,0,
1024,0
|
OFF,1,0,0,0,1024,0,
1024,0
|
OFF,1,0,0,0,1024,0,
1024,0
|
| HEAPPOOLS |
OFF,8,10,32,10,128,10,
256,10,1024,10,2048,10
|
User-defined |
OFF,8,10,32,10,128,10,
256,10,1024,10,2048,10
|
User-defined |
| HEAPPOOLS64 |
OFF,8,4000,32,2000,128,
700,256,350,1024,100,
2048,50,3072,50,4096,
50,8192,25,16384,10,
32768,5,65536,5
|
N/A |
N/A |
N/A |
| HEAPZONES (see table notes 4, 9 and 12) |
0,ABEND,0,ABEND |
0,ABEND,0,ABEND |
0,ABEND,0,ABEND |
0,ABEND,0,ABEND |
| INFOMSGFILTER |
OFF |
OFF |
OFF |
OFF |
| INQPCOPN |
ON |
ON |
N/A |
N/A |
| INTERRUPT |
OFF |
OFF |
N/A |
N/A |
| IOHEAP64 |
1M,1M,FREE,12K,8K,
FREE,4K,4K,FREE
|
N/A |
N/A |
N/A |
| LIBHEAP64 |
1M,1M,FREE,16K,8K,
FREE,8K,4K,FREE
|
N/A |
N/A |
N/A |
| LIBSTACK |
4K,4K,FREE |
4K,4K,FREE |
32,4080,FREE |
32,4080,FREE |
| MSGFILE |
SYSOUT,FBA,121,0,
NOENQ
|
ddname |
N/A |
N/A |
| MSGQ |
15 |
15 |
N/A |
N/A |
| NATLANG |
ENU |
ENU |
ENU |
ENU |
| OCSTATUS |
ON |
ON |
N/A |
N/A |
| PAGEFRAMESIZE (see table notes 4 and 12) |
4K,4K,4K |
4K,4K,4K |
N/A |
N/A |
| PAGEFRAMESIZE64 (see table notes 4 and 12) |
4K,4K,4K |
4K,4K,4K |
N/A |
N/A |
| PC |
OFF |
OFF |
N/A |
N/A |
| PLIST (see table notes 4 and 12) |
HOST |
HOST |
N/A |
N/A |
| PLITASKCOUNT |
20 |
20 |
N/A |
N/A |
| POSIX |
OFF |
OFF |
N/A |
N/A |
| PROFILE |
OFF,'' |
OFF,'' |
OFF,'' |
OFF,'' |
| PRTUNIT |
6 |
6 |
N/A |
N/A |
| PUNUNIT |
7 |
7 |
N/A |
N/A |
| RDRUNIT |
5 |
5 |
N/A |
N/A |
| RECPAD |
OFF |
OFF |
N/A |
N/A |
| REDIR(see table notes 4 and 12) |
REDIR |
REDIR |
N/A |
N/A |
| RPTOPTS |
OFF |
OFF |
OFF |
OFF |
| RPTSTG |
OFF |
OFF |
OFF |
OFF |
| RTEREUS |
OFF |
OFF |
N/A |
N/A |
| SIMVRD |
OFF |
OFF |
N/A |
N/A |
| STACK (see table note 11) |
128K,128K,ANY,KEEP,
512K,128K
|
128K,128K,ANY,KEEP,
512K,128K
(C, Fortran, Multi, PL/I) 64K,64K,ANY,KEEP (COBOL)
|
4K,4080,ANY,KEEP,
4K,4080
|
4K,4080,ANY,KEEP,
4K,4080
|
| STACK64 |
1M,1M,128M |
N/A |
N/A |
N/A |
| STORAGE |
NONE,NONE,NONE,0K |
NONE,NONE,NONE,0K |
NONE,NONE,NONE,0K |
NONE,NONE,NONE,0K |
| TERMTHDACT |
TRACE,,96 |
TRACE,,96 (C, Fortran, Multi, PL/I)
UATRACE,,96 (COBOL)
|
TRACE,CESE,96 |
TRACE,CICSDDS,96 (C, Fortran, Multi,
PL/I) UATRACE,CIDSDDS,96 (COBOL)
|
| TEST |
NOTEST(ALL,*,
PROMPT,INSPPREF)
|
NOTEST(ALL,*,
PROMPT,INSPPREF)
|
NOTEST(ALL,*,
PROMPT,INSPPREF)
|
NOTEST(ALL,*,
PROMPT,INSPPREF)
|
| THREADHEAP |
4K,4K,ANY,KEEP |
4K,4K,ANY,KEEP |
N/A |
N/A |
| THREADSTACK |
OFF,4K,4K,ANY,KEEP,
128K,128K
|
OFF,4K,4K,ANY,KEEP,
128K,128K
|
N/A |
N/A |
| THREADSTACK64 |
OFF,1M,1M,128M |
N/A |
N/A |
N/A |
| TRACE |
OFF,4K,DUMP,LE=0 |
OFF,4K,DUMP,LE=0 |
OFF,4K,DUMP,LE=0 |
OFF,4K,DUMP,LE=0 |
| TRAP |
ON,SPIE |
ON,SPIE |
ON,SPIE |
ON,SPIE |
| UPSI |
00000000 |
00000000 |
00000000 |
00000000 |
| USRHDLR (see table note 5) |
NOUSRHDLR |
User-defined |
NOUSRHDLR |
User-defined |
| VCTRSAVE |
OFF |
OFF |
N/A |
N/A |
| XPLINK (see table notes 4 and 12) |
OFF |
OFF |
N/A |
N/A |
Table notes: - When running with IMS,
this setting ensures that IMS transactions
are rolled back if errors occur in an application that is written
in another Language Environment-enabled
language; an abend causes IMS to
roll back any database updates. When running a batch job, this setting
ensures that a job step abends if errors occur in an application that
is written in another language.
- For PL/I, specify ALL31(OFF) for AMODE 24 programs.
For COBOL, specify ALL31(OFF) if the applications contain one of the
following:
- A VS COBOL II NORES
program (non-CICS program)
- An OS/VS COBOL program
(non-CICS program)
- An AMODE 24 program
If you use ALL31(OFF), you must also specify STACK(,,BELOW,,,);
AMODE 24 programs usually require stack storage below the 16M line.
- If your installation uses Fortran in a multi-language
environment, use the recommended setting for Fortran.
- You cannot specify this option as a system-level
(CEEPRMxx parmlib member or SETCEE command) or region-level default.
For more information about this option, see z/OS Language Environment Programming Reference.
- There is no standard recommended value for this option;
specify an appropriate value according to the needs of your installation.
- If your installation uses COBOL in a multi-language
environment, use the recommended option setting for COBOL.
- Specify any name for the message output file. For Fortran
applications, specify MSGFILE(FT06F001) to produce the same ddname
as in VS Fortran.
- For single-tasking PL/I applications, use the recommended Language Environment default.
However, for multitasking PL/I applications, the following setting
is recommended: THREADSTACK(4K,4K,BELOW,KEEP,,).
- Specify this option only when developing
and debugging applications.
- To get behavior that is similar to the VS COBOL II runtime
option WSCLEAR, use STORAGE(00,NONE,NONE,0K).
Do
not use STORAGE(NONE,NONE,00,0K). Although it initializes
variables for C and PL/I applications, serious performance degradation
can occur. C and PL/I programs should be changed to initialize their
own variables.
- Acquiring a storage increment often involves a new
storage obtain.
The increment size (4080 is recommended) should
be 16 bytes less than the exact size of one or more pages to account
for the 16-byte check zone that CICS applies
to all storage obtain requests. This keeps Language Environment from
obtaining an extra page of storage beyond the requested amount. This
is important in CICS environments
where storage below the line is especially constrained. The initial
size in a CICS environment
is part of a larger storage obtain that includes other storage required
for Language Environment during
initialization. Therefore, you can specify the initial size as exactly
one or more pages, for example, 4K, 8K, and so on, without concern
for acquiring an extra page.
- You cannot specify this option with the
CEEBXITA assembler user exit interface.
|
z/OS Language Environment Customization
Copyright IBM Corporation 1990, 2014