Environment Variables

The environment variables are used to customize the Z-set program for individual users, and maintain a self-contained project structure. The function extends as well to manage multi-architecture sites, thereby allowing the transparent use of the program over a diverse network. The currently used environment variables are summarized as:

Environment variables	Description
Z7LICENSE	Path to the license file overriding the default search.
Z7MACHINE	Defines architecture name for executables. Normally set up via the Z7_cshrc config file through autodetection.
Z7_MAX_NB_DOF	Number of DOFs above which disk storage is used (frontal matrix only).
Z7PATH	Path to the head Z-set’s directory structure.
Z7_TMP_DIR	Path for the temporary files if needed (frontal matrix only).
ZEBU_PATH	Defines user-plugins location
Z7VERSION	Z-set version.
Z7TEST	defines the tests directory (usually $Z7PATH/TESTS/)
Z7HANDBOOK_READER	defines the pdf reader for documentation visualization. By default, Zman command will choose the first one installed from the list acroread kpdf okular xpdf evince gv.
Z7HANDBOOK	Z-set handbooks directory (If this variable is not defined, Zman command will read from $Z7PATH/HANDBOOK)
ZMAKE_CONCURRENCY	specifies the number of jobs to run simultaneously during compilation/build.

• Z7PATH variable which indicates the location of the Z-set distribution. This variable allows easy switching to different distributions. It also is a cause of much difficulty with users if not configured correctly.

# csh syntax:
  setenv Z7PATH /usr/local/Zset/Z9.1.6
  source ${Z7PATH}/lib/Z7_cshrc
# bash syntax:
  export Z7PATH=/usr/local/Zset/Z9.1.6
  source $Z7PATH/lib/Z7_profile

• Z7LICENSE fully qualified path to a license file. Extremely useful when there are multiple versions, or for running Zebulon directly off a CD-ROM where one cannot put the license file in a read only lib directory. Set the variable to point to a full path to the license file. This overrides the default search in the global $Z7PATH/lib directory for files first named *.zlic followed by classic files named Zebulon.License.

Example

In the C-shell, these variables are set using the setenv command. The variables may be directly in the user’s .cshrc file, or in a separate file. For the latter case, one could add this line to the .cshrc file:

if (-f ~/lib/Z7_vars) source ~/lib/Z7_vars

and define Z-set aliases in a separate file, for example:

% cat ~/lib/Z7_vars
setenv Z7_TMP_DIR /home/disk/me/Z7
setenv Z7LICENSE ~/lib/mylic.zlic

setenv Z915_PATH /home/zebu/Z9.1.5
alias z915 "setenv Z7PATH $Z915_PATH; source $Z7PATH/lib/Z7_cshrc"

setenv Z916_PATH /home/zebu/Z9.1.6
alias  z916 "setenv Z7PATH $Z916_PATH; source $Z7PATH/lib/Z7_cshrc"

External solvers

Environment variables	Description
ABAQUS_ROOT	Override global setting for location of ABAQUS.
Z7_ANSYS_DIR	Path to specify an ANSYS distribution to work with. Detailed under the Zansys command discussion.
Z7_ANSYS_VER	Release version which needs to match the ANSYS directory, e.g., 232.
Z7_ANSYS_PROD	Sets the license to check out overriding the default multiphysics (e.g., ansys for mechanical).
SAMCEF_ROOT	Directory where the Samcef software is installed.
FORGE_ROOT	Directory where FORGE is installed.
ADVCSOLVDIR	Directory where the ADVENTURECluster solver is installed. This variable is normally defined during ADVENTURECluster installation procedure.
MORFEO_ROOT	Directory where Morfeo solver is installed.
LD_LIBRARY_PATH	Variable used on most Linux machines to locate shared libraries.