SETCEE command

Use the SETCEE command to change individual runtime options or keywords.

Syntax


>>-SETCEE--+-CEECOPT,-| Runtime options |--+-------------------><
           +-CEEDOPT,-| Runtime options |--+   
           +-CELQDOPT,-| Runtime options |-+   
           +-CEEROPT,-+-COMPAT-+-----------+   
           |          '-ALL----'           |   
           +-CELQROPT,-+-NONE-+------------+   
           |           '-ALL--'            |   
           '-CLEAR-------------------------'   

Runtime options

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

Notes:

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.

CLEAR

Clear all the system-level default runtime options and keywords that were set using the SETCEE or SET CEE commands.

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

Any group, keyword, or runtime option that can be specified in a CEEPRMxx parmlib member is valid.
A maximum of 126 characters is allowed for each command. There is no continuation.
You can use one SETCEE command to modify multiple runtime options within a single group.
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 options, suboptions and before an OVR or NONOVR attribute.
Blanks are not allowed within the required =(( or (( delimiter for runtime options that specify an OVR or NONOVR attribute.
To synchronize the setting of multiple runtime options or keywords, use the SET CEE command to process additional parmlib members. For more information, see SET CEE command.
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.
Changing the system-level default runtime options with the SETCEE command does not affect any currently initialized environments on the system. When applications go through Language Environment initialization, the new runtime option values are used for that application.
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.
When the SETCEE command completes, Language Environment produces message CEE3743I stating that the SETCEE command completed successfully.

Examples

The following example shows variations of using the SETCEE command to set individual runtime options:

SETCEE CEEDOPT,POSIX=((ON),OVR)
SETCEE CEECOPT,DEBUG=((OFF),NONOVR)
SETCEE CELQDOPT,HEAP64(1M),IOHEAP64(1M,1M)

The following example shows how to attempt a load and use CEEROPT in all AMODE 31 and AMODE 24 environments:

SETCEE CEEROPT,ALL

The following example shows how to clear all system-level default runtime options and keywords:

SETCEE CLEAR