CEEPRMxx parmlib member
Description
Use the CEEPRMxx parmlib member to set system-level default runtime options 
or
keywords
.
Syntax
- CEECOPT
- The options group that is used to specify runtime options for CICS® environments.
- CEEDOPT
- The options group that is used to specify runtime options for non-CICS environments excluding AMODE 64 environments.
- CELQDOPT
- The options group that is used to specify runtime options for AMODE 64 environments.
- CEEROPT
- Indicates whether to use region-level runtime options in a non-CICS or non-LRR environment.
- COMPAT
- Attempt a load and use of CEEROPT only in CICS or LRR environments. This is the default behavior.
- ALL
- Attempt a load and use of CEEROPT in all AMODE 31 and AMODE 24 environments.
- CEENXSTG
- The keyword that indicates whether non-executable memory is enabled.
- OFF
- Non-executable memory is not enabled.
- ON
- Non-executable memory is enabled. It is the default.
- runtimeopt
- The name of the runtime option to change.
- subopts
- The suboption values for the specified runtime option to change.
- OVR
- Specifies that the option can be overridden. This is the default setting.
- NONOVR
- Specifies that the option cannot be overridden, which can be used to enforce runtime options
critical to the Language Environment®
operating environment. CAUTION:Runtime options are intended to allow programs, both yours and programs that are supplied by software vendors, to configure how they want to run with Language Environment. Marking runtime options as NONOVR might cripple the capabilities of these programs, prevent them from being tuned properly, inhibit their ability to perform First Failure Data Capture, and prevent them from running. With very few exceptions, IBM strongly discourages customers from marking any runtime option as NONOVR.
After a runtime option is specified as nonoverrideable with the NONOVR attribute, it cannot be overridden later. This includes later specification in the same parmlib member or a SETCEE command. To remove the nonoverrideable setting, use the SETCEE CLEAR operator command, or the SET CEE command with a parmlib member that does not mark the runtime option as nonoverrideable.
The runtime options AIXBLD, DEBUG, FILEHIST, INQPCOPN, OCSTATUS, PC, RTEREUS, and SIMVRD require an ON or OFF suboption to be specified if the OVR or NONOVR attribute is used. For example, AIXBLD=((),OVR) results in an error and the option is ignored.
Usage notes
- The options for each group are saved independently to allow CEEDOPT to specify NATLANG(ENU) while CEECOPT can specify NATLANG(JPN).
- Enter values in uppercase, lowercase, or mixed case. The system converts the input to uppercase, except for values that are enclosed in single quotation marks, which are processed without changing the case.
- Commas are required between suboptions and before an OVR or NONOVR attribute.
- Commas are allowed between options.
- Use blanks or commas as delimiters. Multiple blanks are interpreted as a single blank. Blanks
are allowed between parameters and values. Restriction: Blanks are not allowed within the required
=((or((delimiter for runtime options that specify an OVR or NONOVR attribute. - More than one option can be specified on a line. An option can be continued on multiple lines.
- Comments can appear in columns 1-71 and must begin with
"/*"and end with"*/". - Nested comments are not supported.
- When CEEROPT(ALL) is in effect, an attempt is made to load a CEEROPT module during Language Environment initialization. When no CEEROPT can be found, there is potential performance overhead, especially for applications or transaction servers that repeatedly initialize Language Environment.
- You can specify a group or keyword more than once in a single member.
- A runtime option can be repeated within a parmlib member, group, or can appear in multiple
members when more than one member is specified. Runtime options are processed in the order in which
they appear. The suboptions are saved for each occurrence. When suboptions are repeated, the last
occurrence is used. The last occurrence of the runtime option is identified as the runtime options
source in the runtime options report. Restriction: Only the last occurrence of the ENVAR runtime option is saved. If multiple members are used, and ENVAR appears in the same runtime options group in more than one member, the last one found is saved.
- When the runtime options are merged during the initialization of a Language Environment application, errors might be reported if any system-level or region-level defaults were marked nonoverridable (NONOVR). These messages are displayed for every application. Under CICS, the messages are displayed for the first transaction only.
- If RPTOPTS(ON) is in effect at run time, the Language Environment runtime options report is displayed,
and the
Last Where Setcolumn will identify any options that were set by a CEEPRMxx parmlib member. For a sample of the runtime options report, see z/OS Language Environment Debugging Guide.
Note: CICS TS 3.1 and later supports XPLINK programs in a CICS environment. The options that are specified in the CEEDOPT
group are used for these programs.
Examples
The following example shows the IBM-supplied sample of the CEEPRM00 parmlib member that is provided in the CEE.SCEESAMP data set. All valid groups, options, suboptions with their default values, and keywords are coded in the sample within comment characters. You must remove the comment characters from the groups, options, or keywords that you want to use.
/*********************************************************************/
/* CEEPRM00 - Sample Language Environment parmlib member for */
/* runtime options and keywords. */
/* */
/* LICENSED MATERIALS - PROPERTY OF IBM */
/* */
/* 5650-ZOS */
/* */
/* COPYRIGHT IBM CORP. 2005, 2012 */
/* */
/* ALL RIGHTS RESERVED */
/* */
/* US GOVERNMENT USERS RESTRICTED RIGHTS - USE, */
/* DUPLICATION OR DISCLOSURE RESTRICTED BY GSA ADP */
/* SCHEDULE CONTRACT WITH IBM CORP. */
/* */
/* STATUS = HLE7790 */
/* */
/* */
/* This sample parmlib member contains the IBM-supplied default */
/* runtime options that are valid at the system level. The defaults */
/* can be overridden using the options groups CEEDOPT, CEECOPT, and */
/* CELQDOPT. */
/* */
/* This sample also contains the default values for the CEEROPT, */
/* CELQROPT, and CEENXSTG keywords. */
/* */
/* */
/* Syntax for options: */
/* */
/* group_name( option_1, option_2, */
/* option_3, option_4 ) */
/* */
/* Where: */
/* group_name is CEEDOPT, CEECOPT or CELQDOPT. */
/* option_x is any option valid at the system level. */
/* */
/* */
/* Syntax for keywords: */
/* */
/* CEEROPT( value ) - Where value is ALL or COMPAT */
/* CELQROPT( value ) - Where value is ALL or NONE */
/* CEENXSTG( value ) - Where value is ON or OFF */
/* */
/* */
/* All valid options and keywords are listed but commented out. */
/* To include an option you must edit this file (or a copy) and */
/* remove the comment delimiters around the options to be used. */
/* It is not necessary to uncomment all options. */
/* */
/* */
/* Notes: */
/* */
/* * Comments and blank lines are allowed for readability. */
/* */
/* * Individual options must be separated by a comma or a blank */
/* */
/* * There can be more than one option on a line. */
/* */
/* * Mixed case is allowed. */
/* */
/* * Individual options can be specified as overrideable (OVR) or */
/* nonoverrideable (NONOVR). */
/* */
/* */
/*********************************************************************/
/*********************************************************************/
/* 31 bit non-CICS option group */
/*********************************************************************/
/*CEEDOPT( */
/* ABPERC=((NONE),OVR), */
/* ABTERMENC=((ABEND),OVR), */
/* AIXBLD=((OFF),OVR), */
/* ALL31=((ON),OVR), */
/* ANYHEAP=((16K,8K,ANYWHERE,FREE),OVR), */
/* BELOWHEAP=((8K,4K,FREE),OVR), */
/* CBLOPTS=((ON),OVR), */
/* CBLPSHPOP=((ON),OVR), */
/* CBLQDA=((OFF),OVR), */
/* CEEDUMP=((60,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR), */
/* CHECK=((ON),OVR), */
/* COUNTRY=((US),OVR), */
/* DEBUG=((OFF),OVR), */
/* DEPTHCONDLMT=((10),OVR), */
/* DYNDUMP=((*USERID,NODYNAMIC,TDUMP),OVR), */
/* ENVAR=((''),OVR), */
/* ERRCOUNT=((0),OVR), */
/* ERRUNIT=((6),OVR), */
/* FILEHIST=((ON),OVR), */
/* FILETAG=((NOAUTOCVT,NOAUTOTAG),OVR), */
/* HEAP=((32K,32K,ANYWHERE,KEEP,8K,4K),OVR) */
/* HEAPCHK=((OFF,1,0,0,0,1024,0,1024,0),OVR) */
/* HEAPPOOLS=((OFF,8,10,32,10,128,10,256,10,1024,10,2048, */
/* 10,0,10,0,10,0,10,0,10,0,10,0,10),OVR) */
/* INFOMSGFILTER=((OFF,,,,),OVR) */
/* INQPCOPN=((ON),OVR), */
/* INTERRUPT=((OFF),OVR), */
/* LIBSTACK=((4K,4K,FREE),OVR), */
/* MSGFILE=((SYSOUT,FBA,121,0,NOENQ),OVR), */
/* MSGQ=((15),OVR), */
/* NATLANG=((ENU),OVR), */
/* NOAUTOTASK=(OVR), */
/* NOTEST=((ALL,*,PROMPT,INSPPREF),OVR), */
/* NOUSRHDLR=((),OVR), */
/* OCSTATUS=((ON),OVR), */
/* PC=((OFF),OVR), */
/* PLITASKCOUNT=((20),OVR), */
/* POSIX=((OFF),OVR), */
/* PROFILE=((OFF,''),OVR), */
/* PRTUNIT=((6),OVR), */
/* PUNUNIT=((7),OVR), */
/* RDRUNIT=((5),OVR), */
/* RECPAD=((OFF),OVR), */
/* RPTOPTS=((OFF),OVR), */
/* RPTSTG=((OFF),OVR), */
/* RTEREUS=((OFF),OVR), */
/* SIMVRD=((OFF),OVR), */
/* STACK=((128K,128K,ANYWHERE,KEEP,512K,128K),OVR), */
/* STORAGE=((NONE,NONE,NONE,0K),OVR), */
/* TERMTHDACT=((TRACE,,96),OVR), */
/* THREADHEAP=((4K,4K,ANYWHERE,KEEP),OVR), */
/* THREADSTACK=((OFF,4K,4K,ANYWHERE,KEEP,128K,128K),OVR), */
/* TRACE=((OFF,4K,DUMP,LE=0),OVR), */
/* TRAP=((ON,SPIE),OVR), */
/* UPSI=((00000000),OVR), */
/* VCTRSAVE=((OFF),OVR), */
/* XUFLOW=((AUTO),OVR) */
/* ) */
/*********************************************************************/
/* 31 bit CICS option group */
/* The following options are ignored in CICS: */
/* - ABPERC - OCSTATUS */
/* - AIXBLD - PC */
/* - AUTOTASK - PLITASKCOUNT */
/* - CBLOPTS - POSIX */
/* - CBLQDA - PRTUNIT */
/* - DYNDUMP - PUNUNIT */
/* - ERRUNIT - RDRUNIT */
/* - FILEHIST - RECPAD */
/* - FILETAG - RTEREUS */
/* - INQPCOPN - SIMVRD */
/* - INTERRUPT - THREADHEAP */
/* - MSGFILE - THREADSTACK */
/* - MSGQ - VCTRSAVE */
/* */
/*********************************************************************/
/*CEECOPT( */
/* ABTERMENC=((ABEND),OVR), */
/* ALL31=((ON),OVR), */
/* ANYHEAP=((4K,4080,ANYWHERE,FREE),OVR), */
/* BELOWHEAP=((4K,4080,FREE),OVR), */
/* CBLPSHPOP=((ON),OVR), */
/* CEEDUMP=((60,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR), */
/* CHECK=((ON),OVR), */
/* COUNTRY=((US),OVR), */
/* DEBUG=((OFF),OVR), */
/* DEPTHCONDLMT=((10),OVR), */
/* ENVAR=((''),OVR), */
/* ERRCOUNT=((0),OVR), */
/* HEAP=((4K,4080,ANYWHERE,KEEP,4K,4080),OVR), */
/* HEAPCHK=((OFF,1,0,0,0,1024,0,1024,0),OVR), */
/* HEAPPOOLS=((OFF,8,10,32,10,128,10,256,10,1024,10,2048, */
/* 10,0,10,0,10,0,10,0,10,0,10,0,10),OVR), */
/* INFOMSGFILTER=((OFF,,,,),OVR), */
/* LIBSTACK=((32,4080,FREE),OVR), */
/* NATLANG=((ENU),OVR), */
/* NOTEST=((ALL,*,PROMPT,INSPPREF),OVR), */
/* NOUSRHDLR=((),OVR), */
/* PROFILE=((OFF,''),OVR), */
/* RPTOPTS=((OFF),OVR), */
/* RPTSTG=((OFF),OVR), */
/* STACK=((4K,4080,ANYWHERE,KEEP,4K,4080),OVR), */
/* STORAGE=((NONE,NONE,NONE,0K),OVR), */
/* TERMTHDACT=((TRACE,CESE,96),OVR), */
/* TRACE=((OFF,4K,DUMP,LE=0),OVR), */
/* TRAP=((ON,SPIE),OVR), */
/* UPSI=((00000000),OVR), */
/* XUFLOW=((AUTO),OVR) */
/* ) */
/*********************************************************************/
/* 64 bit options group */
/*********************************************************************/
/*CELQDOPT( */
/* CEEDUMP=((60,SYSOUT=*,FREE=END,SPIN=UNALLOC),OVR), */
/* DYNDUMP=((*USERID,NODYNAMIC,TDUMP),OVR), */
/* ENVAR=((''),OVR), */
/* FILETAG=((NOAUTOCVT,NOAUTOTAG),OVR), */
/* HEAPCHK=((OFF,1,0,0,0,1024,0,1024,0),OVR), */
/* HEAPPOOLS=((OFF,8,10,32,10,128,10,256,10,1024,10,2048, */
/* 10,0,10,0,10,0,10,0,10,0,10,0,10),OVR), */
/* 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),OVR) */
/* HEAP64=((1M,1M,KEEP,32K,32K,KEEP,4K,4K,FREE), */
/* INFOMSGFILTER=((OFF,,,,),OVR), */
/* IOHEAP64=((1M,1M,FREE,12K,8K,FREE,4K,4K,FREE),OVR), */
/* LIBHEAP64=((1M,1M,FREE,16K,8K,FREE,8K,4K,FREE),OVR), */
/* NATLANG=((ENU),OVR), */
/* NOTEST=((ALL,*,PROMPT,INSPPREF),OVR), */
/* POSIX=((OFF),OVR), */
/* PROFILE=((OFF,''),OVR), */
/* RPTOPTS=((OFF),OVR), */
/* RPTSTG=((OFF),OVR), */
/* STACK64=((1M,1M,128M),OVR), */
/* STORAGE=((NONE,NONE,NONE,),OVR), */
/* THREADSTACK64=((OFF,1M,1M,128M),OVR), */
/* TERMTHDACT=((TRACE,,96),OVR), */
/* TRACE=((OFF,,DUMP,LE=0),OVR), */
/* TRAP=((ON,SPIE),OVR) */
/* ) */
/*********************************************************************/
/* Keywords */
/*********************************************************************/
/*CEEROPT( COMPAT ) */
/*CELQROPT( NONE ) */
/*CEENXSTG( ON ) */