zee.env, the environment configuration file
The z/OS® Explorer RSE server processes (RSE
daemon, RSE thread pool, and RSE server) use the definitions in zee.env
to learn
about
z/OS Explorer Extensions
environment variables.
zee.env
is located in /etc/zexpl/
, unless you specified a
different location when you customized and submitted the FEL.SFELSAMP(FELSETUP)
job. For more details, see Customization setup. You can edit the file with the
TSO OEDIT command.
See the following sample zee.env
file, which can be customized to match your
system environment. Default values are provided for all variables that are not explicitly specified.
The syntax of the file follows standard z/OS
UNIX shell syntax rules. For example, comments start with a
number sign (#) when using a US code page, and spaces around the equal sign (=) are not
supported.
FEL_HLQ=${ELAXF_FEL:-FEL}
## C/C++
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dinclude.c=/etc/zexpl/include.conf"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dinclude.cpp=/etc/zexpl/include.conf"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DCPP_CLEANUP_INTERVAL=60000"
## remote index search
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DRIS_BUFFER=8"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_REMOTE_INDEX_SEARCH=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDEFAULT_REMOTE_ZOS_FILE_SEARCH=true"
## system
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_DELETE_IN_SUBPROJECT=true"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dsclm.check.enable=true"
## ISPF EDIT macro
#FEL_EDIT_MACRO_DSN=$FEL_HLQ.SFELSAMP
#FEL_EDIT_MACRO=FELEDTMC
## EWM (RTC) user build
#FEL_UBLD_DD=$CGI_ISPCONF/ISPF.conf
#FEL_UBLD_STEPLIB=$STEPLIB
The following definitions are optional. If omitted, default values are used.
- FEL_HLQ
- The high-level qualifier used to install
z/OS Explorer Extensions. The default is
FEL
. Uncomment and change to match the location of your z/OS Explorer Extensions data sets. - _RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dinclude.c=/etc/zexpl/include.conf"
- This variable points to a fully qualified z/OS UNIX file containing a list of forced includes for content assist on C code. A forced include consists of a file or directory, data set, or data set member which is parsed when a content assist operation is performed, regardless of whether that file or member was included in the source code using a pre-processor directive. To specify the name of the configuration file, uncomment and customize.
- _RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dinclude.cpp=/etc/zexpl/include.conf"
- This variable points to a fully qualified z/OS UNIX file containing a list of forced includes for content assist on C++ code. A forced include consists of a file or directory, data set, or data set member which is parsed when a content assist operation is performed, regardless of whether that file or member was included in the source code using a pre-processor directive. To specify the name of the configuration file, uncomment and customize.
- _RSE_JAVAOPTS="$_RSE_JAVAOPTS -DCPP_CLEANUP_INTERVAL=60000"
- Cleanup interval for unused C/C++ header files in milliseconds. The default is
60000
, which means 1 minute. To change the cleanup interval, Uncomment and customize. Specifying a value of 0 prevents caching of C/C++ header files, thereby reducing performance of remote content assist in the editor. - _RSE_JAVAOPTS="$_RSE_JAVAOPTS -DRIS_BUFFER=8"
- Buffer size, in megabytes, used during remote index creation. The default is
8
MB. To change the buffer size, uncomment and customize. Valid values are whole numbers between 1 and 2000 (both inclusive). A bigger buffer speeds up index creation, but uses a bigger portion of the thread pool's Java™ heap. The buffer is automatically flushed to the index if it is full before index creation ends. - _RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_REMOTE_INDEX_SEARCH=true"
- Disable the Remote Index Search menu item on the client. The default is
false
. To prevent users from creating remote indexes for host system data sets, uncomment and specifytrue
. - _RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDEFAULT_REMOTE_ZOS_FILE_SEARCH=true"
- Make Remote z/OS File Search (using ISRSUPC) or Remote
z/OS Search (using Java) the default panel on the client when starting a remote search. The default is false,
which results in the "Remote z/OS Search" panel being the
default for the client. Uncomment and specify true to make Remote z/OS File Search the default panel on the client. Note: This option requires the client to be v14.2.2 or later.
- _RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_DELETE_IN_SUBPROJECT=true"
- Disable the Delete menu item in the pop-up menu of z/OS
subprojects. The default is
false
. To prevent users from using the Delete menu item in the pop-up menu of z/OS subprojects, uncomment and specifytrue
. - #_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Dsclm.check.enable=true"
- Enable a check to see if a data set or member is under SCLM control. The default is false. Uncomment and specify true to prevent users from altering SCLM-managed data outside of SCLM.
- FEL_EDIT_MACRO_DSN
- Specifies the name of the data set that holds the REXX exec used for ISPF EDIT Macro support. When using defaults, FEL_EDIT_MACRO_DSN is set to FEL.SFELSAMP. Uncomment and change to match the location of a customized REXX exec, who's name is referenced in variable FEL_EDIT_MACRO.
- FEL_EDIT_MACRO
- Specifies the name of the REXX exec used for ISPF EDIT Macro support. The default is FELEDTMC. Uncomment and change to match the name of a customized REXX exec, who's location is referenced in variable FEL_EDIT_MACRO_DSN.
- FEL_UBLD_DD
- Specifies the DD statements that will be used when generating JCL for IBM®
Engineering Workflow
Management (formerly known as IBM
Rational® Team Concert®) user builds from a Developer for z/OS client that
invoke TSO or ISPF commands. By default, Developer for z/OS uses the
definitions in
ISPF.conf
, which is referenced byCGI_ISPCONF
inrse.env
. Uncomment and change to use the DD definitions in the specified file, which must follow the syntax rules specified forISPF.conf
in IBM Explorer for z/OS Host Configuration Guide. - FEL_UBLD_STEPLIB
- Specifies the STEPLIB statement that will be used when generating JCL for IBM
Engineering Workflow
Management (formerly known as IBM
Rational Team Concert) user builds from a Developer for z/OS client that
invoke TSO or ISPF commands. By default, Developer for z/OS uses the
STEPLIB
definition inrse.env
. Uncomment and change to use the specifiedSTEPLIB
definition.