z/OS Language Environment Customization
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


CEEPRMxx parmlib member

z/OS Language Environment Customization
SA38-0685-00

Use the CEEPRMxx parmlib member to set system-level default runtime options.

Syntax

Read syntax diagramSkip visual syntax diagram
   .-------------------------------------.   
   V                                     |   
>>---+-CEECOPT(-| Runtime options |-)--+-+---------------------><
     +-CEEDOPT(-| Runtime options |-)--+     
     +-CELQDOPT(-| Runtime options |-)-+     
     +-CEEROPT(-+-COMPAT-+-)-----------+     
     |          '-ALL----'             |     
     '-CELQROPT(-+-NONE-+-)------------'     
                 '-ALL--'                    

Runtime options

   .-+---+-----------------------------------------.   
   | '-,-'                                         |   
   V                                               |   
|----+-runtimeopt-+---+-((subopts),-+-OVR----+-)-+-+------------|
     |            '-=-'             '-NONOVR-'   |     
     |  (1)                                      |     
     '-----runtimeopt(subopts)-------------------'     

Notes:
  1. Specifying runtime options without the OVR or NONOVR attribute. Runtime options specified using this format can be overridden.
CEECOPT
The options group used to specify runtime options for CICS® environments.
CEEDOPT
The options group used to specify runtime options for non-CICS environments excluding AMODE 64 environments.
CELQDOPT
The options group used to specify runtime options for AMODE 64 environments.
CEEROPT
Indicates whether region-level runtime options should be used 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.
CELQROPT
Indicates whether region-level runtime options should be used in an AMODE 64 environment.
NONE
Do not attempt a load or use of CELQROPT in AMODE 64 environments. This is the default behavior.
ALL
Attempt a load and use of CELQROPT in all AMODE 64 environments.
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.
Once a runtime option is specified as nonoverrideable with the NONOVR attribute, it cannot later be overridden. 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.
Note: The runtime options AIXBLD, DEBUG, FILEHIST, INQPCOPN, OCSTATUS, PC, RTEREUS and SIMVRD require an ON or OFF suboption to be specified when using the OVR or NONOVR attribute. 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 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 runtime, the Language Environment runtime options report is displayed, and the Last Where Set column 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 higher supports XPLINK programs in a CICS environment. The options specified in the CEEDOPT group are used for these programs.

Examples

The following example shows the IBM-supplied sample of the CEEPRM00 parmlib member 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.                                      */
/*                                                                   */
/* 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 and  */
/* CELQROPT 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               */
/*                                                                   */
/*                                                                   */
/* 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 )                                 

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014