MicroStation PowerDraft 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) of MicroStation PowerDraft are installed.
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_CODESET MDL application for handling multi-byte character sets.
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 (For use on Windows Vista or later) 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_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 be treated as elements.
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 web site.
MS_HELPPATH Path to help resource files.
MS_INVALID_FIELD_INDICATOR_STRING_NULL If set to 1, displays "null" for text fields that evaluate to an empty string. If undefined (the default), "####" is displayed for text fields that evaluate to an empty string.
MS_INITAPPS List of initial start-up MDL applications.
MS_KEYPAIRLIST Digital signature KeyPair file list.
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_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 or not to use the reference's color table. You need to close and restart in order for this configuration variable change to take effect
MS_RIGHTLOGICKB If set to 1, keyboard input is right to left.
MS_RSRC Main resource file. Typically set to "msdraft.rsc."
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_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 If this variable is not defined, the product 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 variable is defined, the product takes whatever the variable is set to and looks for a saved view of the same name. If the specified saved view name cannot be found, then the system creates/updates the thumbnail image using the view that was active at the last time you selected File > Save Settings.

The latter also occurs if the variable is not defined and if the saved view called "Preview" does not exist in any design, drawing, or sheet model in the DGN file. If this variable is set to "NONE," then no new thumbnail is generated. If a thumbnail already exists in the DGN file, setting this variable to "NONE" does not remove what already exists in the DGN file; it simply does not update what already exists.

MS_USERLICENSE File containing license information.
MS_USERPREF User preference resource file.
MS_USERPREF_APPS Set by application configuration files to add user preferences to standard dialogs.
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_VIEWATTRIBUTES_PLUGINASSEMBLIES List of assemblies to search in for View Attributes dialog plug-in groups.
PZIP_OUT Specifies default directory for creation of Packager files.

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 PowerDraft 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.