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

ELAXF=
BZUINCL=
# convert SET statements in INCLUDE to ${incl}_${symbol} envvars
. $FEL_HOME/bin/felSetToEnvvar ELAXF $ELAXF
. $FEL_HOME/bin/felSetToEnvvar BZUINCL $BZUINCL

FEL_HLQ=${ELAXF_FEL:-FEL}


## debug
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -DDISABLE_DBM_INTEGRATION=false"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.autoreconnect=0"
#_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.localhost=localhost"


##  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


## ZUnit unit test
#STEPLIB=$STEPLIB:$FEL_HLQ.SFELLOAD
#STEPLIB=$STEPLIB:SYS1.CSSLIB:SYS1.SIXMLOD1
#AZU_JES_PROCLIB=SYS1.PROCLIB


## 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.

ELAXF

The JES PROCLIB data set holding the ELAXF include member. The

SET
variable=value

statements within will be converted to environment variables. There is no default. Change to match your z/OS Explorer Extensions customization.

BZUINCL

The JES PROCLIB data set holding the BZUINCL include member. The SET variable=value statements within will be converted to environment variables. There is no default. Change to match your z/OS Dynamic Test Runner customization.

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 -DDISABLE_DBM_INTEGRATION=false"

Disable integration with Debug Manager, an optional started task of z/OS Debugger. The default is false, which implies that Debug Miner will attempt to connect at least once to Debug Manager. Uncomment and specify true to prevent any attempt to connect to Debug Manager.

_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.autoreconnect=0"

Automatic reconnect to Debug Manager, an optional started task of z/OS Debugger. The default is 0, which implies that, when a connection with the Debug Manager server is not established or lost, the Debug Miner will attempt every minute to reconnect to the Debug Manager. Uncomment and specify a different value to limit how often the Debug Miner will attempt to connect to the Debug Manager.

Table 1. Automatic reconnect to Debug Manager
debug.miner.autoreconnect	Reconnect behavior
-1	Do not reconnect
0 (default)	Attempt to reconnect every minute until successful
1-86400	Attempt to reconnect up to the specified amount of times. The maximum value, 86400, equals 24 hours.

_RSE_JAVAOPTS="$_RSE_JAVAOPTS -Ddebug.miner.localhost=localhost"

Alternative for the localhost TCP/IP definition. Debug Miner will attempt to connect to the Debug Manager, an optional started task of z/OS Debugger, using the localhost specification. This will fail if localhost does not resolve to the local loopback address (127.0.0.1 for IVPv4, ::1 for IPv6). Uncomment and specify the local loopback address when required.

_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.

STEPLIB

Access MVS™ data sets not in LINKLIST/LPA. The default is NONE.

You can bypass the need of having prerequisite libraries in LINKLIST/LPA by uncommenting and customizing one or more of the following STEPLIB directives. For more information about the usage of the libraries in the following list, see PARMLIB changes:


# ZUnit, xUnit support for Enterprise COBOL and PL/I
STEPLIB=$STEPLIB:$FEL_HLQ.SFELLOAD:SYS1.CSSLIB:SYS1.SIXMLOD1

Note:

Using STEPLIB in z/OS UNIX has a negative performance impact.
If one STEPLIB library is APF-authorized, then all the other STEPLIB libraries must be authorized. Libraries lose their APF authorization when they are mixed with non-authorized libraries in STEPLIB.
Libraries that are designed for LPA placement might require additional program control and APF authorizations if they are accessed through LINKLIST or STEPLIB.
Coding a STEPLIB DD statement in the server JCL does not set the requested STEPLIB concatenation.

AZU_JES_PROCLIB

Define where cataloged procedures are stored so ZUnit can analyze them when adding recording parameters to JCL using a cataloged procedure. The default is SYS1.PROCLIB. Uncomment and specify a colon (:) separated list of data sets.

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.