Optional Variables

This topic lists the optional environment variables for defining the ENOVIA Live Collaboration environment.

The following variables are not required to be set in order for ENOVIA Live Collaboration to function. When the variable is not explicitly set in the environment, ENOVIA Live Collaboration uses the default values. If required, these values should be added to the [matrix] section of the .ini file (or for UNIX, the startup script).

Variable Description
USER Can be used with another optional variable, MX_HOME_VAULT, to let you set a default context for ENOVIA Live Collaboration for Windows. USER is the default user name and MX_HOME_VAULT is your default vault. If you are using Windows, when an ENOVIA Studio Modeling Platform application is opened, the context window comes up with the user name as it appears in SYSTEM.INI, unless the USER variable is set here.
HOME Is your default home directory
FINDLIMIT Sets the default limit field in ENOVIA Live Collaboration Find window. Defaults to 0 or no limit. Does not affect MQL queries. The results of some queries will load faster in the details view if a limit is specified. Setting FINDLIMIT allows you to establish a default value to optimize performance in case no limit is set in the query. When limits are set in the query, this value is ignored, and the new value does not change this setting. To optimize performance, but still find all objects that meet the criteria, you may want to make this value very large, for example, FINDLIMIT=1000000.
MQLWINDOWDISPLAY When TRUE, displays an MQL window when running eMatrixMQL that may be used to diagnose and debug these programs and applications. The default is FALSE, which means that the MQL session appears as a button on the Windows task bar for eMatrixMQL, matrix -wizard, matrix -c, and openedit, but cannot be opened.
MX_ANNOTATION_TYPE Sets the non-English word used for Annotations. A business object type of the name specified here must be defined in order for the Annotation function to operate properly when used in a non-English setting. The default is Annotation.
MX_ATTACHMENT_TYPE Sets the non-English word used for Attachments. A business object type of the name specified here must be defined in order for the Attachment function to operate properly when used in a non-English setting. The default is Attachment.
MX_REPORT_TYPE Sets the non-English word used for Reports. A business object type of the name specified here must be defined in order for the Report function to operate properly when used in a non-English setting. The default is Report.
MX_ABORT_DANGLING_TRANSACTION, When TRUE, tells a top-level program to abort any uncommitted transactions upon exiting, as long as the transaction was not already open when the program was started. This prevents transactions from being left hanging, with its table locks intact, until the ENOVIA Live Collaboration Server or ENOVIA Studio Modeling Platform application is shut down and restarted. On the ENOVIA Live Collaboration Server, this is set to TRUE by the default installations.
MX_ACCESS_LOG Access logging may be enabled by setting this variable to TRUE. Access logging provides auditing of all access right grants and denials. UNIX systems make use of the UNIX syslog(3) interface to log, write, or forward messages to designated files or users; on Windows systems, the Application Event Log is used. The default is FALSE, meaning logging of access is off. Refer to the MQL Guide for more information on access logging.
MX_BACKGROUND_OPEN Allows background processes to be launched (for example, Open for Edit or View) while still allowing the ENOVIA Studio Modeling Platform to operate. The default is true, but may be disabled by setting this value to FALSE. You may wish to set this to FALSE while debugging Open for Edit or View programs.
MX_CHARSET Can be set to enable multiple double-byte languages through the same ENOVIA Live Collaboration instance on a server machine with an English O/S. When needed, set to UTF-8. At this time, if you want to run two or more languages other than English concurrently you need to run an on an English O/S. (Other language O/S’s can run English and that language.) For applications that display Japanese characters with a WebLogic server, set this to either MS932 for Windows applications or csWindows31j for UNIX applications.
MX_JAVA_DEBUG When TRUE, allows the thick client to attach to a JPDA-enabled Java IDE, such as NetBeans or Eclipse. When true, this sets JAVAC_FLAGS=G, which will compile Java classes with debug information. When true, the libjdwp.so file needs to be in the path specified in the library path variable for the specific platform, as given below: 
Solaris - LD_LIBRARY_PATH
AIX - LIBPATH
Windows - PATH
For example, on Solaris: 
LD_LIBRARY_PATH=/usr/lib/lwp;/usr/java/lib/sparc
.
MX_JAVAC_FLAGS Allows the passing of extra flags to the Java compiler. For example, when set to “G”, Java classes are compiled with debug information.
MX_JAVA_OPTIONS Sets Java options for desktop use of JPOs. For example: 
MX_JAVA_OPTIONS="-Xss512k [-Xmso768k (IBM JDK on AIX)]
-Xmx256m -Xms256m -XX:NewSize=128m -XX:MaxNewSize=128m
-XX:MaxPermSize=128m -XX:SurvivorRatio=3"
When the ENOVIA Live Collaboration Server is installed, recommended Java options are set by default. Refer to JVM Options in the Live Collaboration - Server Troubleshooting and Diagnostics Guide for more information.
MX_JIT_TRIGGER_MACROS Should be set to TRUE if you want environment variables looked up dynamically (Just In Time) as needed in triggers. The default is FALSE, which means that macros are static, defined before any trigger program is executed, and the same values are passed into all trigger types (check override action). Refer to the "Appendix: Macros" in the Studio Modeling - Configuration Guide for more information.
MX_NESTED_TRIGGER_MACROS Set to TRUE to enable programs to save their local RPE settings (that is, trigger macros) when they start, and restore them when they exit. The default is FALSE in order to leave user-defined RPE variable definitions alone, and thereby minimizing the impact on legacy programs. MX_NESTED_TRIGGER_MACROS is intended to be used in concert with the environment variable MX_JIT_TRIGGER_MACRO; for optimum performance of trigger programs, both values must be set to true. The ENOVIA Live Collaboration trigger manager relies on the true setting to dramatically improve application performance.
MX_DECIMAL_SYMBOL Used to set the user’s preference for displaying the decimal symbol. For example, with the database configured with a “.” decimal character and the user’s MX_DECIMAL_SYMBOL set to “,”, ENOVIA Live Collaboration always displays numbers to that user with a comma and always write them to the database with a period, regardless of how the user enters the number. The same is true for the reverse; if the database is set to a comma and the user’s preference is set to a period, numbers are displayed with a period but saved with a comma. The default value is a period (.).

For more information, refer to Localized Decimal Character Settings. The setup for supporting the viewing of multiple languages and cultural symbol conventions is also discussed in Configuring Oracle for Non-English Languages.
MX_TCL_ANSI_NUMERIC May be set to true on desktop systems only when ENOVIA Live Collaboration should override the LC_NUMERIC setting during execution of Tcl programs to establish a period (.) as the decimal setting. This causes operating system utilities to return floating point values in a form that is suitable for performing arithmetic using the Tcl “expr” procedure. Values obtained from MQL commands continue to be returned using the character defined as MX_DECIMAL_SYMBOL. If FALSE, (the default) the setting for LC_NUMERIC is used and Tcl calls to the operating system will return floating point values according to this setting. This setting is designed for use in a thick client tcl environment only. Do not use this setting in the ENOVIA Live Collaboration Server environment, as it changes the process locale across all threads.

For more information, refer to Localized Decimal Character Settings. The setup for supporting the viewing of multiple languages and cultural symbol conventions is also discussed in Configuring Oracle for Non-English Languages.
MX_TCL_STRIP_NEWLINE Allows you to change the default behavior for MQL commands issued from within Tcl. By default, output requested from MQL does not have a carriage return at the end of the output string. Setting this variable to FALSE adds a carriage return at the end of the output for MQL commands called from Tcl mode only. The default setting is TRUE, which means that a new line is not generated.
MX_TCL_SHLIB Set to reflect the tcl path and library file name (without the extension), when a non-default tcl version is used. For example, for Windows: 
MX_TCL_SHLIB=ENOVIA_INSTALL\win_b64\code\bin\tcl85
For UNIX: 
MX_TCL_SHLIB=ENOVIAHOME/<platform>/code/bin/tcl85
When setting this variable, you must also reset the TCL_LIBRARY and TK_LIBRARY settings to reflect the path to the new library versions.
MX_EXPAND_ALL When TRUE, displays checked in files beneath formats when the Formats browser is displayed. If many files are typically checked in, this may be set to FALSE to improve performance. The default is TRUE.
MX_EDITOR Code can be entered into the Code tab of the program object using the ENOVIA Live Collaboration user interface, or it can be written in an external editor and automatically imported into the program object. The button text is the value of MX_EDITOR. 
MX_EDITOR=Notepad
MX_EDITOR_PATH The external editor button is included on the Code tab only when MX_EDITOR and MX_EDITOR_PATH are set in the ENOVIA Live Collaboration initialization (.ini) file. 
MX_EDITOR_PATH=c:\winnt\system32\notepad.exe
When specifying WordPad, use wordpad.exe instead of write.exe.
MX_FCS_ENABLED When TRUE, enables the ENOVIA Studio Customization Toolkit to use the File Collaboration Server (FCS) for checkin/checkout without using ENOVIA Matrix Web Navigator. When FALSE, the FCS is not used by the ENOVIA Studio Customization Toolkit without ENOVIA Matrix Web Navigator.
MX_FULL_TEXT_LIMIT Sets the limit on the number of files to find in a full text search. This value is passed to the index server and used by the search engine. The default is 0 or no limit.
MX_FULL_TEXT_MODE Sets the search mode of full text search. This value is passed to the index server and used by the search engine.
MX_FULL_TEXT_MINSCORE Sets the minscore for full text search. This value is passed to the index server and is used by the search engine.
MX_ALIASNAME_PREFERENCE Determines the alias to use. An alias refers to the different names that can be given to the same administrative objects according to the audience. These are defined via MQL. This setting must match the alias name. The alias preference takes precedence over the language preference if both are specified. Refer to the MQL Guide for information on defining aliases.
MX_LANGUAGE_PREFERENCE Determines the language to use. A language applies to all words presented to the user through a GUI: buttons, labels, messages, etc. It will also refer to an alternate language for schema, if an alias of this name exists. Schema aliases are defined via MQL. Refer to the MQL Guide for more information.
MX_LCD_EXTERNAL_AUTHENTICATION When TRUE, tells ENOVIA Live Collaboration not to attempt to verify the user’s password before accessing objects in a remote vault. The default is FALSE, which enables a more secure environment.
MX_PROGRAM_POOL_SIZE Sets the initial size of the interpreter pool used by Tcl programs. This setting is also used to extend the pool size when all the interpreters in the pool are allocated and another is requested. The default is 10.
MX_NFS_MAX_DATA Specifies the amount of data transferred in one packet on the network. The default value is set at 1024 on PC’s, 8192 on UNIX. These numbers reflect the differences in the TCP/IP products for each platform. If you have a network interface that supports large datagrams, you can achieve modest performance improvements on PCs by increasing this value up to a maximum of 8192. In the majority of installations, there is little or no benefit in altering this value.
MX_NFS_UID Used to change the user ID setting. The default is 100. This setting applies to PCs only.
MX_NFS_GID Used to change the group ID setting. The default is 99. This setting applies to PCs only.
MX_QUERY_PAGE_SIZE Enables system-wide streaming of queries and expands and sets the number of objects per page of returned items. The data is returned when the first page is available, resulting in improvements in performance and potentially in memory consumption as well.

Streaming can be enabled for all queries and expands through this environment variable either through classes in the ENOVIA Studio Customization Toolkit or at runtime by using the size clause in MQL temporary query or expand business object commands. Some operations, such as expression evaluation operations, use the expand operation internally and the only way to enable streaming for these operations is through this variable. You can override any value set for streaming in temporary queries and expands by using the size clause. Enabling streaming through the Java classes usually provides the greatest improvement in performance and memory consumption. See "About Streaming Query and Expand" in the Studio Modeling - Configuration Guide.

When processing selectables in a streaming query, memory consumption is not necessarily reduced versus non-streaming queries. Although paging is used when the selectables are processed, the entire result set is still buffered in memory, for example:

temp query bus T N R size 1000 select to.from;

This retrieves business objects 1000 at a time, and only 1000 will ever be held in memory at one time. However, the evaluation of to.from for ALL of the found objects will be held in memory until the query has completed.

Starting with V6R2010, the streaming function is on by default. To disable it, you must set MX_QUERY_PAGE_SIZE=0. Otherwise, it will be ON with a default value of 10000.
MX_REMOTE_TIMEOUT Defines the length of time, in seconds, that ENOVIA Live Collaboration will persist in attempting to perform a file operation (e.g., checkin, checkout, delete) in an NFS store. The default is 60 seconds. The code performs the check every 5 seconds.
MX_RESTORE_CONTEXT Used to disable the security mechanism that ensures that if context is changed during program execution, it is restored to the original setting when finished. The default is TRUE, which enables the security mechanism, but may be set to FALSE, if required.
MX_RESTORE_TRIGGERS Set to FALSE by default. However, when TRUE, whenever a program is finished executing, ENOVIA Live Collaboration will set triggers to on. This provides protection in case of failure in a program that turns triggers off before terminating.
MX_RESTRICT_EXPAND Set to TRUE by default. If users attempt a full expand on an object in an indented browser (shift+click with no filters on to or from) an error message is generated. This is because full expands in both directions are extremely time consuming, and it will often seem as if the system has stopped responding. However, full expands may be enabled and the error suppressed by setting this variable to FALSE.
MX_SESSION_SILENT_TIMEOUT Sets the time interval in minutes for allowed inactivity for a session of ENOVIA Matrix Navigator or ENOVIA Studio Business Modeler, before the connection to the database is terminated. Once the user begins to work again, the system will reconnect and attempt to continue from where it left off, without requiring reauthentication. The default setting is 30 with a minimum setting of 5. If an invalid value is specified (such as 3 or a negative number), the minimum will be enforced.
MX_SESSION_TIMEOUT Sets the time interval in minutes for allowed inactivity for a session of ENOVIA Matrix Navigator or ENOVIA Studio Business Modeler, before the connection to the database is terminated, and the user is forced to login again to resume Matrix operations. Once reconnected, the system will attempt to continue from where it left off. The minimum setting is 5. If an invalid value is specified (such as 3 or a negative number), the minimum will be enforced. If not set, no session time out is place.

Timeout settings may be used alone or together, and are not used in MQL, ENOVIA Studio System Administration or ENOVIA Matrix Navigator operating in MQL or Wizard mode. In ENOVIA Matrix Web Navigator and other ENOVIA environments, session timeouts are handled by application server settings.
MX_SERVER_DST Used to tell ENOVIA Live Collaboration to override its current algorithm for converting times to GMT. You should set this value to TRUE if you are using GMT or a GMT offset value in your server’s timezone setting, and your Oracle server takes DST into account when determining the current time. Set this to FALSE for those rare Oracle servers that do not take DST into account. When this setting is not in place at all, ENOVIA Live Collaboration will use the default algorithm that uses the timezone setting in the ENOVIA Live Collaboration database to determine whether or not the times provided by the Oracle server take DST into account.
MX_SET_SORT_KEY Sets any number of basic select items (type, name, revision, owner, locker, originated, modified, current, and policy) by which objects in sets will be presented. By default the value is type|name|revision. You can specify ascending or descending order by prefixing the select with + or - (ascending (+) is the default.) To disable sorting, you can set this variable to a single '|' character. Disabling sorting improves response time of loading the first page of a set. Can be disabled in conjunction with programming techniques to improve performance. Refer to the Programming Guide for more information.
MX_SHOW_HIDDEN_TYPE_OBJECTS For display of objects and connections whose business type or relationship is marked hidden. The default is FALSE, which means that hidden objects and connections are not displayed in query or expand results in the ENOVIA Matrix Navigator or ENOVIA Studio Business Modeler, and are not returned by ENOVIA Studio Customization Toolkit query/expand methods. When TRUE, objects with hidden business types and connections of hidden relationships are displayed when found or navigated to, and they are returned by the original ENOVIA Studio Customization Toolkit query/expand methods. Additional expand methods are also available to override this system setting and retrieve all objects/relationships, including those whose type is marked hidden. In MQL, regardless of this setting, hidden type objects and connections are always listed.
MX_SMTP_HOST Must be specified on each client (UNIX or PC), including the ENOVIA Live Collaboration Server, in order to send e-mail via ENOVIA Live Collaboration from all machines. The named host must be setup as an SMTP server (not POP). This setting is important for use with the ENOVIA Business Process Services and other ENOVIA products, in order for business process notifications to be sent.
MX_SMTP_TIMEOUT Sets the time allowed for connecting to the SMTP server when sending e-mail. The default is 60 seconds.
MX_CHECK_MAIL Specifies (for ENOVIA Matrix Navigator only) how often ENOVIA Matrix Navigator checks for new IconMail in order to effect the new mail indicator. The value is in minutes, and defaults to every 15 minutes. You can set the value to 0 to disable the new mail indicator for ENOVIA Matrix Web Navigator users, as well as to disable the sending of IconMail. When disabled, mail sent via ENOVIA Matrix Navigator, MQL, ENOVIA Matrix Web Navigator, ENOVIA Studio Customization Toolkit IconMail, or other ENOVIA products are sent as email to those recipients with email enabled, but NO IconMail is created, sent, or stored in the database.
MX_SMTP_CONTINUE Used to tell ENOVIA Live Collaboration how to establish communication with the SMTP server. The default is TRUE, which means ENOVIA Live Collaboration checks for a continuation character, “-”, in the current line, allowing multiline messages. If FALSE, no check for a continuation character is done, which means that the current line is assumed to be the only line in the message.
MX_TRACE_FILE_PATH Location of the ENOVIA Live Collaboration error log file. If this variable is not set, the default location is the ENOVIAHOME directory.
MX_TRIGGER_RECURSION_DETECTION The system should employ MX_TRIGGER_RECURSION_DETECTION to check for recursion of trigger programs. Most recursion is not a single program calling itself (indirectly through triggers firing) but more of a ping pong effect where a program calls another program, which calls back to the original eventually (again, through the firing of triggers). The default is “name”, which means that the system does not allow a program to be executed if it is already executing. The variable may also be set to “signature”, which checks for the uniqueness of five properties of the program: Program Name, Input arguments, Trigger event, Trigger type, and Target object ID; or “none” to turn off detection altogether. You must use “signature” when configuring for use with ENOVIA products.

This setting is used in conjunction with MX_TRIGGER_RECURSION_LIMIT.
MX_TRIGGER_RECURSION_LIMIT Set to an integer to indicate the maximum number of trigger programs that can be placed on the trigger stack, helping to avoid server crashes due to the host system running out of stack space. The default value is 30. When the limit is reached, a warning is added to the trigger trace file, and the trigger stack is unwound. The limit is used in conjunction with MX_TRIGGER_RECURSION_DETECTION, no matter what its value is, but it is particularly important to set an appropriate limit for your server when trigger recursion is disabled with the “none” setting.
MX_USE_SCHEMA_NAMES When TRUE, improves performance when multiple ENOVIA Live Collaboration Servers are defined that point to different schemas in the same Oracle Instance (that is, different Oracle Users.) Default is FALSE.
MX_WHERE_MAX_COUNT Controls how complex a where clause can be. This setting approximately corresponds to the number of operands allowed in any where clause. ENOVIA Live Collaboration produces an error if it reaches the limit specified. The default is 512, which shouldn’t need changing in a server environment, since it is comparable to the stack size used by the server's JVM. However, when using the ENOVIA Studio Modeling Platform to run JPOs, which use the default JVM setting for stack size, you may want to lower the value of MX_WHERE_MAX_COUNT (to correspond with the JVM size) if very complex where clauses are used on the ENOVIA Studio Modeling Platform system.
MX_WIN_APP_WAIT Controls how long the ENOVIA Studio Modeling Platform waits for the launched application’s primary window to appear. The value assigned is the number of seconds to wait. The default value is zero.
MX_WIN_MIN_ON_LAUNCH Used to minimize all ENOVIA Studio Modeling Platform windows during the execution of a launched application. The default is FALSE. When TRUE, the ENOVIA Studio Modeling Platform windows are minimized, and when the launched application terminates, the ENOVIA Studio Modeling Platform windows are restored.
MX_LEGACY_RELRULE=FALSE FALSE by default. To revert to pre-V6R2009 rule behavior on relationships, set to TRUE.