What Is An Environment?

This section describes what a runtime environment is.

What is an Environment?

An environment is a set of runtime environment variables in a text file. Each variable points to a path searched by the software when you start a session.

Note that the default installation path (on Windows) can be:

C:\Program Files\Dassault Systemes\B211\intel_a 
C:\Program Files\Dassault Systemes\B211\win_b64

All product lines share the same environment management mechanism.

For example, on Windows, the CATDocView environment variable is set by default, for 32-bit Windows XP, to:

C:\Program Files\Dassault Systemes\B211\intel_a\doc

meaning that the online documentation files are installed in the folder:

C:\Program Files\Dassault Systemes\B211\intel_a\doc

When you want to access the online documentation, the software will look for the files in this location. The term environment also includes its graphical representation, in other words how it is represented to the user on the user's desktop.

On Windows, for example, the environment is created in a text file located by default in:

C:\Documents and Settings\All Users\Application Data\DassaultSystemes\CATEnv

and the environment file name is MyProduct.V6R2012.B211.txt. For example: CATIA.V6R2012.B211.

Note: the environment file name does not necessarily contain a "." (dot).You can also specify during the installation procedure the location of environment files.

What are Global and User Environments?

Global environments can only be created, edited or deleted by a Windows administrator.

For example, the default environment created at installation is a global environment: "global" means that it is visible to and can be used by all users on the computer on which it has been set up.

A user environment is visible to and can be used and manipulated (customized or deleted) only by the user who created it.

How are Environments Managed?

Environments are managed:


  • by the installation procedure, which creates a default global environment
  • using the catiaenv command to run the Environment Editor, a GUI-based tool which creates, edits, copies and deletes environments
  • using the setcatenv command: this command creates and edits user and global environments (if you are administrator or root, you can edit the default global environment)
  • using the delcatenv command: this command deletes environments
  • using the lscatenv command (to list the names of environments)
  • using the chcatenv command (to edit one or more environment variables)
  • using the readcatenv command (to read the variables of an environment).

Please use the official tools provided to manage environments. Do not attempt to edit the environment file using a text editor.

What Does Customizing an Environment Mean?

Customizing your runtime environment means providing different values for the runtime variables in your default environment, or setting up new environments.

For example, you may install the online documentation at a location different from the default location. If this is the case, you need to specify where the documentation files are located by modifying the value for the CATDocView variable. This is an example of what we mean by customizing your runtime environment.

When customizing runtime environments, you can:


  • create new environments
  • edit existing environments
  • copy existing environments
  • delete environments

but you cannot rename existing variables.You can ONLY create, modify and delete LOCAL environments: the creation, modification and deletion of REMOTE environments is not supported. This means that if you customize a local environment, and the same environment exists on other computers, you have to edit the environments on all of those computers if you want the environments to be identical.

List of Official Runtime Variables

The runtime environment variables for all product lines are listed in the table below:

Variable Name Description
CATInstallPath Installation path
CATDLLPath DLL search path (internal use only); on Windows, DLLs are loaded from the directories referenced by the variables CATDLLPath and PATH (Windows mechanism).
CATICPath Search path for product identification (internal use)
CATCommandPath Command search path
CATDictionaryPath Library dictionary search path
CATDocView Online documentation search path
CATReffilesPath Reference file search path
CATFontPath Font search path
CATGalaxyPath Search path for User Galaxy online information files
CATGraphicPath Graphic and icon search path
CATMsgCatalogPath Application message file search path
CATFeatureCatalogPath .OSM file search path
CATDefaultCollectionStandard Default standard collection path
CATKnowledgePath Knowledge search path indicating the location where Knowledge resources have to be searched for while using an application. It can point to a concatenation of directories containing the knowledge Structure.
CATStartupPath Sample file search path
CATW3ResourcesPath W3 resource search path
CATReconcilePath Reconciliation path
CATReferenceSettingPath Default reference setting search path; also used to store settings locked by the administrator
CATUserSettingPath Permanent user setting search path
CATCollectionStandard Standard collection path
CATTemp Temporary user setting search path
CATIndexStoragePath Index storage search path
CATErrorLog Error log search path: points to the default files error.log, SessionInfo and AbendTrace files. The syntax is, for example, on Windows:

CATErrorLog=%CATTemp%\error.log      

The error log file will be:

%CATTemp%\error.log

You can deactivate the creation of error.log, SessionInfo and AbendTrace files by setting CATErrorLog to the special value OFF (UPPERCASE only) like this:
CATErrorLog=OFF
CATReport Conversion trace report location
CATDisciplinePath  
USER_HOME Points to home directory of generic user for server-type environments
JAVA_HOME Java runtime path specified at installation
CLASSPATH Classpath
CLASSPATH_JDBC JDBC classpath for ENOVIA V6 Server
PATH Executable code search path
LIBPATH Library search path
DB2INSTANCE DB2 environment variable (for server-type environments only)
TNS_ADMIN TNS environment variable (for server-type environments only)
ORACLE_HOME ORACLE environment variable (for server-type environments only)
ORA_NLS33 ORACLE environment variable (for server-type environments only)
PLM_DeactivateLocalSave Set this variable to TRUE to deactivate the local save capability
DSYSettingDir Activates settings in database mode
DSYBootstrapDir Declares the bootstrap directory in settings in database mode