[Contents] [Prev] [Next]

Appendix G

System Administrator Guide

C-MOLD Environment Variables

Environment Variable Descriptions

The following environment variables are used by C-MOLD. In Windows 95 and NT versions, they are set in the C:\cmold98x\cmdefs.bat file. For UNIX versions, they are set in /usr/local/cmold98x/cmdef.csh or /usr/local/cmold98x.sh files, depending on whether you use the csh or sh shell. Normally, the automated installation procedure takes care of setting these variables for you. For reference, the variables and their purposes are listed here. For reading variety, DOS syntax is shown here, but the explanations apply equally to the UNIX version.

CMOLD_HOME=C:\cmold98x

This variable specifies the absolute path location where you installed C-MOLD. Many of the following environment variables are based on the value of CMOLD_HOME.

CMOLD_DAT=%CMOLD_HOME%\dat

This variable specifies the directory containing the C-MOLD default configuration data.

CMOLD_EXE=%CMOLD_HOME%\bin

This variable specifies the directory containing all C-MOLD executable files.

CMOLD_DB=%CMOLD_HOME%\db

This variable specifies the directory containing the C-MOLD database and should not be changed.

CMOLD_KEY=%CMOLD_HOME%\keyfile

This variable specifies the location and the file name of C-MOLD's keyfile.

XBMLANGPATH=%CMOLD_HOME%\small\bitmaps\%%B

This variable specifies the location where X11 searches for bitmap files.

UIDPATH=%CMOLD_HOME%\small\uid\%%U%%S

This variable specifies the location where Motif searches for .uid (Interactive Description) files.

XENVIRONMENT=%CMOLD_HOME%\small\app-defa\cmold.res

This variable specifies the location of the application default files.

Setting Up C-MOLD Environment Variable Definitions

The automated install script will perform this step for you if you use it. If you're installing C-MOLD manually, though, certain environment variables must be defined correctly in order to finish the manual installation and to run C-MOLD.

Failure to include the environment variable definitions in the user's shell initialization file will cause problems in executing C-MOLD, especially with batch analyses.

Follow the instructions for the case below that matches your situation. See above for a complete reference of the environment variables used by C-MOLD.

If you installed C-MOLD in the recommended /usr/local directory, and your incremental release was C-MOLD 98.x, then issue the following command:

If you use the C shell:
$ source /usr/local/cmold98x/cmdefs.csh
If you use the Korn shell or Bourne shell:
$ . /usr/local/cmold98x/cmdefs.sh (note the period that starts the line)

Similarly, we recommend that you edit the default shell's initialization file for each C-MOLD user, as follows:

C shell users should place the following commands in their .cshrc file:
$ if ( -r /usr/local/cmold98x/cmdefs.csh ) then$ source /usr/local/cmold98x/cmdefs.csh$ endif
Korn shell and Bourne shell users should place the following commands in their .profile file:
$ if [ -r /usr/local/cmold98x/cmdefs.sh ]$ then$ . /usr/local/cmold98x/cmdefs.sh$ fi

Note: If you have installed to a different directory, then substitute that directory for /usr/local in the examples shown above. Failure to perform this environment set-up is the number one reason for run-time failures in C-MOLD.

Troubleshooting C-MOLD Environment Variable Definitions

Since so much depends on the correct setting of C-MOLD environment variable definitions, it's a good idea to check these settings. If you find inconsistencies, please refer to the instructions in "Setting Up C-MOLD Environment Variable Definitions" to set up the environment correctly.

If you installed C-MOLD in the recommended /usr/local directory, and your incremental release was C-MOLD 98.x, then issue the following UNIX command. You should get a response that looks something like the one below (the four path variables might differ. Sun users might see additional variables as well).

$ env | grep "/usr/local/cmold98x"
PATH=/usr/local/cmold98x/bin:.:/usr/bin:/bin:/usr/bin/X11 CMOLD_HOME=/usr/local/cmold98x CMOLD_EXE=/usr/local/cmold98x/bin CMOLD_DAT=/usr/local/cmold98x/dat CMOLD_DB=/usr/local/cmold98x/db CMOLD_KEY=/usr/local/cmold98x/keyfile XUSERFILESEARCHPATH=/usr/local/cmold98x/app-defaults/%N XBMLANGPATH=/usr/local/cmold98x/bitmaps/%B%S UIDPATH=/usr/local/cmold98x/uid/%U%S:/usr/lib/X11/uid/%U%S

[Contents] [Prev] [Next]

Copyright © 1997-1998 Advanced CAE Technology, Inc. All rights reserved.