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.

Note: For your changes to take effect, the z/OS Explorer RSED started task must be restarted.
Figure 1. zee.env: environment configuration file
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 specify true.
_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 specify true.
#_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 by CGI_ISPCONF in rse.env. Uncomment and change to use the DD definitions in the specified file, which must follow the syntax rules specified for ISPF.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 in rse.env. Uncomment and change to use the specified STEPLIB definition.