MicroStation CONNECT Edition Help

Uncategorized Configuration Variables

The following table lists the configuration variables that are uncategorized. Each configuration variable expects a valid value. An invalid value will not override a setting. You do not need to close and restart in order for the configuration variable change to take effect, unless noted.

Variable Description
MSDIR The root installation directory.
MSLOCAL Specifies the base directory path for where the required writable portions (that is, local for a network installation) are installed.
MS_80TRUETYPESCALE If set to 1, TrueType fonts using nonstandard TrueType definitions will display as they did prior to V8.
MS_ALWAYSRELATIVEREFPATH If set (to any value), always turns on the Save Relative Path check box and disables it so that it cannot be turned off. It will save relative paths whenever possible.
MS_ANNOTATIONSCALEPROPAGATION Controls the propagation of a model's annotation scale.

If set to NEVER, the annotation scale will not be propagated, which is not recommended. If undefined or set to any other value, the annotation scale will be automatically propagated.

We recommend that you use a single annotation scale for all annotations in a model. When you attach a model containing annotations to another model, the Use Active Annotation Scale setting allows you to automatically scale all reference annotations to the same scale as the master model. If your reference model has annotations of different scales, those annotations that do not match their model's annotation scale may face display, selecting, and printing problems. There may also be a performance slowdown.

MS_ARCHIVE Search path for archive files.
MS_ARCHIVECLASS Search path for archive class files.
MS_AUTO_UPDATE_FIELDS Controls the rules for updating fields in the active model. If set to ALWAYS, the fields are always kept up to date. If set to NEVER, the fields are never updated. If not set or set to FOLLOWMODELFLAG, the model's Auto-Update Fields property determines if fields are updated for that model.
MS_BASICEXT_LOAD List of MDL applications that implement extensions to the BASIC language (MS_BASIC_LOAD).
MS_CMDTABLE_LOAD List of MDL applications that will have their key-in tables auto-loaded.
MS_CMDWINDRSC Command Window resource file. Default is used if undefined.
MS_CODESET MDL application for handling multi-byte character sets.
MS_CONFIGURATIONOPTS Allows you to control the creation or selection of WorkSpaces and WorkSets from the respective drop-down lists in the Work page. Following are the options for this configuration variable:
  • None (Default) - If undefined, you can create WorkSpaces as well as WorkSets.
  • DisallowCreatingWorkSpace - Disables the Create WorkSpace option in the WorkSpace drop-down.
  • DisallowCreatingWorkSet - Disables the Create WorkSet option in the WorkSet drop-down.
  • DisallowSelectingWorkSpace - Disables the WorkSpace selection drop-down.
  • DisallowSelectingWorkSet - Disables the WorkSet selection drop-down.
MS_DATA Directory for data files created or used.
MS_DBOLEDBDATEFORMAT See Setting Up the Database Interface.
MS_DEFCHARTRAN Default character translation table.
MS_DEFAULTSHEETRGB Allows you to specify a different background color, which is used when you create the first sheet model. Expects an RGB triplet separated by commas.
MS_DEFAULTDRAWINGRGB Allows you to specify a different background color, which is used when you create the first drawing model. Expects an RGB triplet separated by commas.
MS_DESIGNFILTER Default file filter for the File Open, Open, and Save As dialogs. If MS_DESIGNFILTER is not defined, the default filter is "*.dgn".
MS_DETAILINGSYMBOLSTYLE_REQUIREDSETTINGS Allows you to customize the validation rules of detailing symbol styles.
MS_DGNAPPS List of all design file MDL applications.
MS_DGNINDEXER_PORT If set, the application uses this port to connect to the remote DGN Indexing servers. The default value is 4000.
MS_DGNOUT Directory containing DGN files created as a result of "on the fly" translation from other file formats.
MS_DIMLEGACYPOINTORDER If set to 1, the dimensioning tools use the legacy data point sequence for placing linear and angular dimensions (StartPoint – ExtensionPoint – EndPoint).
MS_DISABLEWINDOWGHOSTING If set to 1 or ON, disables the window ghosting mechanism in the Windows OS. Windows creates a ghost window for the application's windows when it determines that an application has been unresponsive for at least five seconds. Several features, such as Print/Plot and Image Save, may require a long span of continuous processing time, resulting in the activation of these ghost windows and the associated undesirable side effects in the user interface. Turning off the window ghosting for the process prevents these undesirable effects.
MS_DISALLOWRELATIVEREFPATH When set to 1, you cannot save a relative path for a reference. The Save Relative Path check box is removed from the Attach Reference dialog.
MS_DRAWINGDIR Specifies the default folder path that should open when you click the Browse Drawing File or Create New Drawing File icons in the Create Drawing dialog.
MS_DWG_XREF_DEFAULTTREATASELEMENT_OFF When this variable is not set, DWG’s xReference attachments are treated as elements, just as they are in AutoCAD. When it is set to 1, the attachments are not to be treated as elements.
MS_DWG_PRESERVE_LINETYPE_ON_3DPOLYLINE

If set to True or 1, the line type associated to the 3D Polylines will be preserved. If set to False or 0, the line type will be forced to 0. The default value is set to False or 0.

MS_ELEVPROP_AS_Z Allows you to assign elevation attributes as Z values during SHP, MIF/MID, or TAB file Import/Open/Attachment. This is accomplished by setting the value to one or more property names that you used to indicate elevation in your SHP, MIF/MID, or TAB files. For example, if you have a SHP, MIF/MID, or TAB file that uses a property called "ELEVATION" to contain elevation data, you would set:

MS_ELEVPROP_AS_Z=ELEVATION

If you have an additional SHP, MIF/MID, or TAB file that uses a property called "HEIGHT" to contain elevation data, you can use a vertical "|" delimiter to specify two elevation attributes as follows:

MS_ELEVPROP_AS_Z=ELEVATION|HEIGHT

MS_GUIHAND Identifies auxiliary handlers.
MS_HELPLOAD_APPLICATION Determines which application help is based on. Current options are HTMLHelp (default), or StaticWeb. StaticWeb refers to static HTML pages on a website.
MS_HELPLOAD_ CONTENTSPAGE Defines the name of the HTML page containing the initial help contents for the product. The default name is index.html.
MS_HELPLOAD_ HOSTEDHELP_TOPICPAGE Used for internal implementation only. Do not modify.
MS_HELPLOAD_ TOPICPAGE Specifies the format specification for the name of an HTML page containing help for a specific topic.
MS_HELPLOAD_ USEBROWSER If set, display help as HTML pages in a browser rather than using a CHM file.
MS_HELPPATH Path to help resource files.
MS_INITAPPS List of initial start-up MDL applications.
MS_INVALID_FIELD_INDICATOR_STRING Sets the display string for text fields that evaluate to an empty string. If you want to display empty strings as white spaces, then define them within single or double quotes. For example, " " or ' '. If the variable is undefined or set to blank, the default display string will be ####.
MS_LEVEL_DO_NOT_SYNCHRONIZE_ATTACHMENT_LEVELS_TO_DGNLIB If set to 1, the reference attachment levels are not synchronized to the attached library.
MS_MEASURE_AREA_UNIT2 If set to 1, the unit of measurement in the Area or Volume fields is displayed as unit2. For example, m2 for Square meters and m3 for Cubic meters. If not set, it is displayed as Sq.unit or Cu.unit. For example, Sq.m for Square meters and Cu.m for Cubic meters.
MS_NO_POSITION_MAPPING_HINTS If set to 1, the keyboard navigational aids will not display when <Esc> is clicked.
MS_NOTEAUTOUPDATE Controls the list of settings that will be propagated to existing notes when a dimension style is saved. To propagate all settings, set to All. To control individual settings, list attributes in a comma-separated list.
MS_OLDUSERLICENSE File that contains old user license information. Required for when installing a product upgrade.
MS_OLEDBMAXDATA See Setting Up the Database Interface.
MS_OPENDESIGNFILEFILTER Initial file filter list for the File Open and Open dialogs.
MS_OPENREFFILEFILTER Initial file filter for the Attach Reference File dialog.
MS_ORACLEPREFETCH Specifies the number of rows pre-fetched from the database, maximum 65535. For example, if MS_ORACLEPREFETCH is set to 1000, there will be 1000 rows of data returned to the client and cached. If this configuration variable is not set, one row is pre-fetched. Setting MS_ORACLEPREFETCH can result in improved query performance over high latency networks, such as Wide Area Networks (WANs).
MS_PATTERNORIENTATION_ROTATEWITHVIEW

Pattern orientation mode.

If set to 0- Pattern orientation of reference is fixed to a view.

If set to 1- Pattern orientation rotates with reference and is independent of the view rotation. (default is 1)

MS_PLOTBORDER_TIME_FORMAT Changes the date and time format for printed outputs from Windows Regional Settings to another format. Set to v7.0 to use the v7.0 format.
MS_REFCOLORTABLE If defined and set to 1, always uses the reference's color table. If defined and set to any value other than 1, never uses the reference's color table. If not defined, uses the user preference to determine whether to use the reference's color table.
MS_RIGHTLOGICKB If set to 1, keyboard input is right to left.
MS_RSRC Main resource file. Typically set to "ustation.rsc."
MS_SESSION_DEBUG Used to start session debug prior to the loading of the database server. By setting this configuration variable, you can receive immediate debug information from the consumer DLL. MS_SESSION_DEBUG can be used with all the database servers. A value of 1 enables receipt of debug information from the database server and the corresponding DLL — ORACLE, ODBC, or OLEDB. A value of 0 enables receipt of debug information only from the DLL.
MS_SHEETDIR Specifies the default folder path that should open when you click the Browse Sheet File or Create New Sheet File icons in the Create Drawing dialog.
MS_SIGNATURE_DISPLAY_UNVERIFIED Controls how an unverified digital signature is crossed out. Value is color weight style strikeout where:

color = a number, specifying the menu color identifier number

weight = a number specifying the line weight of the annotation

style = a number specifying the style

strikeout = how to strike out the signature

  • "X" Draw an X over the signature
  • "—" Draw a line through the middle of the signature

The default is a heavy solid red X over the signature. This is represented by 4 7 0 X

To draw a heavy solid blue line through the signature, use the following: 1 7 0 —.

MS_SIGNATURE_DELETE_REQUIRES_PRIVATE_KEY If set, you may not delete a digital signature unless you possess the private key that was used to create the signature. The default is 0.
MS_SIGNATURE_SHOW_FULL_NAME If on, displays the full subject and issuer name from the signer's certificate in the Properties balloon for a digital signature element.
MS_SMARTSOLID Specifies the directory path for the SmartSolid subsystem.
MS_SNAP_TANGENT_POINT_DEFAULT_MODE The snap mode used to compute the location of a perpendicular or tangent point snap. Applies only when perpendicular or tangent point is the default snap mode. Possible values are:

b - bisector

i - intersection

k - keypoint

m - midpoint

m1 - multisnap1

m2 - multisnap2

m3 - multisnap3

The default is 'k' (keypoint).

MS_STARTSCREEN_SHOWMODELPICKER If set to 0 or False, hides the Model picker displayed in the recent files list in the Work Page as well as in the backstage (File > Open). Hiding the picker, improves performance, particularly if you have large number of models in your recent files. By default, this configuration is undefined and the Model picker is not displayed.
MS_SYNCGROUP_APPS Used for internal implementation only. Do not modify.
MS_SYNCGROUP_RSCS Used for internal implementation only. Do not modify.
MS_TEXT_AUTOSTACKFRACTIONS_ALIGNMENT Sets the alignment for stacked fractions, when the Fractions advanced text style setting is on. Values are:

1 = Top

2 = Center (Normal for DWG files. The default if the configuration variable is not defined.)

3 = Bottom

MS_TEXT_AUTOSTACKFRACTIONS_TYPE Sets the type for stacked fractions, when the Fractions advanced text style setting is on. Values are:

1 = Normal

2 = Diagonal (Normal for DWG files. The default if the configuration variable is not defined.)

3 = Normal Center

MS_TEXT_STACKFRACTIONS_SCALE The value is the percentage scale factor for stacked fractions. (70 is normal for DWG files, and is the default if this configuration variable is not defined.)
MS_THUMBNAIL Allows you to create thumbnail view from a saved view.

If you have a saved view that you want to preview in the thumbnail view, set the name of that saved view as the value of this configuration variable.

If you don't want to display any thumbnail view, then set the value of this configuration to " NONE ". However, if a thumbnail already exists in the DGN file, then that thumbnail is displayed as is and is never updated.

If this variable is not set, then the thumbnail preview is derived from the following:
  • The product first looks for a saved view called "Preview" and if found uses that saved view's settings (model, orientation, render mode, etc.) to create the thumbnail.
  • If the saved view called "Preview" does not exist, then the system creates/updates the thumbnail image using the view that was active at the last time you selected File > Save Settings.
MS_USERLICENSE File containing user license information.
MS_USERPREF User preference resource file.
MS_USERPREF_APPS Set by application configuration files to add user preferences to standard dialogs.
MS_USE_DEFAULT_WORKSETFOLDER

If set to 0, It will open the location of the previously opened file. If set to 1, It will open the default DGN folder created in the WorkSet. The default value is set to 0.

MS_VISEDGES_OMIT_EDGES_BETWEEN_PLANAR_FACES If set to 1, the interior edges between adjacent planar faces will be omitted even if the Remove Smooth Edges check box is off. This may be desirable for meshes imported from external formats that do not correctly display the interior edges between mesh faces.
MS_VISEDGES_PRESERVE_UPDATE_SEQUENCE If set to 1, when you export the visible edges, the references are displayed in the sequence set in the Update Sequence dialog.
MS_VIEWATTRIBUTES_PLUGINASSEMBLIES List of assemblies to search in for View Attributes dialog plug-in groups.
MS_WORKSETMISMATCH_ALERT_EXCLUDE_VARS_ALLLEVELS Files at the location pointed by this configuration variable will be excluded from WorkSet mismatch check. By default, this configuration variable points to the paths that contain files which are common across WorkSets.
MS_WORKSETMISMATCH_ALERT_EXCLUDE_VARS_WORKSPACELEVEL Files at the location pointed by this configuration variable will be excluded from WorkSet mismatch check. By default, this configuration variable points to the paths that contain files which are common across WorkSpaces.
PZIP_OUT Specifies default directory for creation of Packager files.
ITEMTYPE_PICKLIST_EXCELPATH If defined, you can specify Excel file to be used exclusively for Picklists. Add full path, folder path with *.xlsx, files with similar pattern (E.g: Files with the same, serial number like E:\PickList\Item List.xlsx OR E:\PickList\*.xlsx OR E:\PickList\Item*.xlsx). If not defined, the default configuration variable, ITEMTYPE_LOOKUP will be used for both Picklists and Lookup. If ITEMTYPE_PICKLIST_EXCELPATH or ITEMTYPE_LOOKUP is not defined, you will be prompted to set these configuration variables when trying to use Excel data for Picklists or Lookups. Refer:Item Types Dialog

Framework Configuration Variables

The following table lists the Framework configuration variables, which start with the prefix "_USTN".
Variable Description
_USTN_COMMONAPPDATAPATH Defines the full path to the file directory containing application data for all users. By default, this configuration variable points to the C:\ProgramData\Bentley\MicroStation\10.0.* folder.
_USTN_CUSTOM_CONFIGURATION Defines the path of your custom Configuration directory.
_USTN_FIRSTDGNAPPS Allows you to add applications that load on MicroStation startup.
_USTN_HELPNAMESPACE Used for internal implementation. Do not modify.
_USTN_IRSTEMP Used for internal implementation. Do not modify.
_USTN_LOCALUSERAPPDATAPATH Defines the full path to the directory containing application data for currently signed in user. By default, this configuration variable points to the C:\Users\<user_name>\AppData\Local\Bentley\MicroStation\10.0.* folder.
_USTN_LOCALUSERTEMPPATH Defines the full path to the temp directory containing application data for currently signed in user. By default, this configuration variable points to the C:\Users\<user_name>\AppData\Temp\Bentley\MicroStation\10.0.* folder.
_USTN_MASTEMP Used for internal implementation. Do not modify.
_USTN_MASTEMP_EXTRACT Used for internal implementation. Do not modify.
_USTN_MASTEMP_PACKAGE Used for internal implementation. Do not modify.
_USTN_MASTEMP_ZIP Used for internal implementation. Do not modify.
_USTN_OUTDIRNAME Defines the name for the design file output file. The default value is out.
_USTN_PRODUCT_HELPFILENAME Used for internal implementation. Do not modify.
_USTN_USERAPPDATAPATH Defines the full path to the roaming directory containing application data for currently signed in user. By default, this configuration variable points to the C:\Users\<user_name>\AppData\Roaming\Bentley\MicroStation\10.0.* folder.
_USTN_WORKSETDGNSDIRNAME Defines the name of the WorkSet design files folder. The default value is dgn.
_USTN_WORKSETSTANDARDSDIRNAME Defines the name of the WorkSet standards files folder. The default value is Standards.