Administrator Guide
Administrator Guide
Administrator Guide

Working with Configuration Variables

User-level configuration variables can be set in dialog boxes, as described in this section.

System-, application-, site-, and project-level configuration variables must be edited with a text editor using the syntax explained in Configuration Variable File Syntax.

General Procedure — To Modify User-level Configuration Variables
  1. From the Workspace menu, choose Configuration.
    The Configuration dialog box opens.

  2. In the Category list box, select the category that contains the configuration variable you wish to modify. For a list of all configuration variables by category, see User configuration variables.
    or
    In the Category list box, select All (Alphabetical) or All (By Level), scroll through the configuration variables in the list box to the right, and select the desired variable.
    The controls for setting the definitions of that category of configuration variables are displayed. In the Expansion field, the expansion of the variable (see the note) is shown. In the Description field, a description of the variable and its name are shown.

  3. Use the controls to modify the definition. The procedure varies for the different Types of configuration variables. See one of the following:
    To set a path configuration variable.
    To set a directory configuration variable.
    To set a filename configuration variable.
    To set a keyword configuration variable.
    (Experienced users familiar with configuration variable syntax: See also To edit a configuration variable.)

  4. Click OK.
    If you modified any configuration variable definitions, an alert box opens, asking whether you want to save the changes in the user configuration file, save the changes only in memory for the current session, or cancel the changes.

  5. In the alert box, click Yes to save the changes to the user configuration file, click No to save the changes only in memory for the current session, or click Cancel to cancel the changes.

  6. If you use a text editor to look at the definition of a configuration variable in a configuration file, you may find that the definition contains other configuration variables and conditional syntax. The definition is often text that must be expanded into the actual names of directories, paths, files, and so on. When you select a configuration variable in the Configuration dialog box, the Expansion field shows the expansion of the variable.

To set a path configuration variable
  1. With the path configuration variable selected in the Configuration dialog box, click the Select button.
    The Select Path dialog box opens. In the Directory List, directories, if any, already included in the configuration variable's expansion are shown.

    Select Path dialog box

      

  2. To add a directory to the configuration variable's definition, select the directory from the Directories list box (or key in the directory specification in the Directory field), then click the Add button.

  3. To remove a directory from the configuration variable's definition, select it in the Directory List and click the Remove button.

  4. Click the Done button.

To set a directory configuration variable
  1. With the directory configuration variable selected in the Configuration dialog box, click the Select button.
    The Select Directory dialog box opens. In the field above the Directories list box, the directory (if any) already included in the configuration variable's expansion is shown.

    Select Directory dialog box

      

  2. To change the directory in the configuration variable's definition, select the desired directory in the Directories list box (or key in the directory specification in the Directory field).

  3. Click OK.

To set a filename configuration variable
  1. With the filename configuration variable selected in the Configuration dialog box, click the Select button.
    The Select File dialog box opens. In the Files list box, the file (if any) already included in the configuration variable's expansion is shown.

    Select File dialog box

      

  2. To change the file in the configuration variable's definition, select the desired file in the Files list box or key in the filename in the Files field. (If necessary, use the Directories list box to select the proper directory.)

  3. Click OK.

To set a keyword configuration variable
  1. With the configuration variable selected in the Configuration dialog box, click the Edit button.
    (The Select button is dimmed because keywords cannot be selected.)
    The Edit Configuration Variable dialog box opens.

  2. In the Edit Configuration Variable dialog box's New Value field, enter the desired keyword. (Although keywords are not case sensitive, uppercase letters are used by convention.)
    The keyword is also shown in the Expansion field.

  3. Click OK.

To edit a configuration variable
  1. With the configuration variable selected in the Configuration dialog box, click the Edit button.
    The Edit Configuration Variable dialog box opens.

  2. In the Edit Configuration Variable dialog box's New Value field, edit the configuration variable definition. (Although keywords are not case sensitive, uppercase letters are used by convention.)
    The Expansion field shows the expansion of the definition in the New Value field.

  3. Click OK.

User configuration variables

This table lists user configuration variables by category.

Category

Variable

"Short name"

Description

Archive

MS_ARCHIVE

"Archive Search Path"

Search path for archive files.

MS_ARCHIVECLASS

"Archive Class Search Path"

Search path for archive class files.

MS_KEYPAIRLIST

"KeyPair File List"

Digital signature KeyPair file list.

Cells

MS_CELL

"Cell Library Directories"

Search path(s) for cell libraries.

MS_CELLLIST

"Cell Library List"

List of cell libraries to be searched for cells not found in the current library.

MS_CELLSELECTORDIR

"Cell Selector Directory"

Directory for Cell Selector button configuration (.csf) files.

MS_CELLSELECTOR

"Cell Selector File"

Default Cell Selector button configuration file.

MS_CELLOUT

"Output Cell Libraries"

Default directory for newly created cell libraries.

MS_MENU

"Menu Cells"

Cell library file containing menu cells.

Colors

MS_DEFCTBL

"Default Color Table"

Default color table if DGN file has none.

MS_RMENCTBL

"Right Menu Color Table"

Default menu colors (dialog boxes, borders, etc.) for right screen — specifies a color table (.tbl) file.

MS_LMENCTBL

"Left Menu Color Table"

Default menu colors (dialog boxes, borders, etc.) for left screen — specifies a color table (.tbl) file.

Database

MS_UDLDIR

"Universal Data Link directory"

Points to the directory that contains the Universal Data Link (UDL) files. The UDL files contain the connection strings to a particular data source. The default directory is ..Bentley\Program\PowerDraft\database\oledb\udl.

MS_ORACLE_HOME

"Oracle Home"

Used to set the path to the Oracle client files required for connecting to the database server. If this variable is not set, MicroStation looks at the system registry and path to determine the Oracle Home directory.

MS_DBASE

"Database Files"

Search path(s) for database files.

MS_SERVER

"Server Loader"

MDL application to load the database interface software.

MS_DBEXT

"Database Server"

The database interface “server” application.

MS_LINKTYPE

"Database Linkages"

User data linkage types recognized by the database interface software.

Data Files

MS_CUSTOMSHEETSIZEDEF

"Sheet Size Definitions"

Defines the location of the sheetsizes definition file that can be used when creating sheet models.

MS_CUSTOMSCALEDEF

"Scales Definitions"

Defines the location of the scales definition file that can be used when creating models.

MS_CUSTOMUNITDEF

"Unit Definitions for Upgrading"

Defines the location of the unit definition file that can be used when upgrading pre-V8 files to V8 DGN files.

MS_HTMLDGNDIR

"HTML Template Directory"

Directory containing template DGN files used to generate cell images for HTML documents.

MS_SETTINGS

"Settings Resource"

Open settings file.

MS_SETTINGSOUTDIR

"Settings Output Directory"

Directory for newly created settings files.

MS_SETTINGSDIR

"Settings Directory"

Directory containing settings files.

MS_REMAP_CSVFILE

"Remap CSV File"

If this variable points to a remapping comma separated value (CSV) file, the remap filter defaults to that file for the remapping during the Save As operation.

DWG/DXF

MS_DWG_COMMANDPREFIX

"DWG Command Prefix"

This variable can be set to a character or string of characters that can be used as a shortcut to the AutoCAD key-in commands. See Using a Command Prefix.

MS_DWG_PGPFILE

"PGP Command Alias File"

This variable points to a PGP file that contains shortcuts, or aliases, for AutoCAD commands. See Using a PGP File.

MS_DWGDATA

"DWG Data Directory"

Local directory to store DWG settings file. For details, see DWG-related Configuration Variables.

MS_BLOCKLIST

"AutoCAD Block List"

List of DWG/DXF files to be searched for AutoCAD blocks.

MS_DWGFONTPATH

"AutoCAD SHX Font Directory"

Path(s) that contain AutoCAD SHX fonts. For details, see DWG-related Configuration Variables.

MS_ACADDIR

"“AutoCAD Program Directory"

Directory containing AutoCAD. This is used to find the DWG support files such as fonts. For details, see DWG-related Configuration Variables.

Design Applications

MS_DGNAPPS

N/A

List of MDL applications to load automatically when a DGN file is opened.

Design History

MS_DESIGN_HISTORY

"Design History capabilities"

Allows users to create, delete, commit, and browse Design History.

MS_DESIGN_HISTORY_COLORS

"Colors"

Specifies the colors to use when identifying changed elements.

MS_DESIGN_HISTORY_COMMIT_ON_CLOSE

"Commit before close"

Specifies whether changes are committed to Design History before the file is closed.

MS_DESIGN_HISTORY_COMMIT_ON_SAVE

"Commit on save"

Specifies whether changes are committed to Design History when the file is saved.

MS_DESIGN_HISTORY_WARNING

"Confirm when taking ownership"

Specifies whether you are prompted to confirm that you will take ownership of all uncommitted changes.

MS_DESIGN_HISTORY_REVISION_NUMBER_FORMAT

"Revision number display format"

Allows you to change the appearance of the revision numbers. For details, see Revision Number Display Format Configuration Variable.

Engineering Links

MS_WEBLIB_HISTORY

"Weblib history"

History file for the Weblib shared library.

MS_BOOKMARKS_IMAGE

"Image bookmarks"

Bookmark file for remote images.

MS_BOOKMARKS_RSC

"Resource bookmarks"

Bookmark file for remote resource files.

MS_BOOKMARKS_ARCHIVE

"Archive bookmarks"

Bookmark file for remote archives.

MS_BOOKMARKS_CELL

"Cell library bookmarks"

Bookmark file for remote cell libraries.

MS_BOOKMARKS_DGN

"DGN bookmarks"

Bookmark file for remote DGN files.

MS_REFAGENTDATA

"RefAgent data file"

File containing URL information for the Reference Agent.

MS_WEBKIOSKMODE

"Kiosk mode"

Set to 1 to turn on kiosk mode.

MS_WEBTYPESFILE

"Special filetype handling"

Specifies a file that contains special handling instructions for various file types.

MS_WEBFILES_DIR

"Weblib local storage"

Directory in which copies of remote files are stored.

MS_WEBDOWNLOADDIR

"Download directory"

Sets the directory in which WWW downloads are stored.

MS_BROWSERMAKECHILDWINDOW

"Reparent browser"

When set to 1, the current browser is reparented inside of the MicroStation main window, allowing the viewer to always be seen.

MS_USEEXTERNALBROWSER

"External browser name"

Sets an external browser.

Extensions

MS_FEATURE

n/a

MS_MODELER

n/a

MS_SELECTSERVICESHOME

n/a

URL of Bentley SELECTservices homepage.

MS_ACIS

"ACIS Directory"

Directory containing the ACIS subsystem.

File Saving

MS_DGNAUTOSAVE

"Design File Auto-Save"

Determines the frequency, in seconds, of the auto-save timer.

MS_V7AUTOSAVE

"V7 Design File Auto-Save"

Determines the frequency, in seconds, of the auto-save timer for V7 format files.

MS_V7AUTOSAVE_NODIALOG

"V7 Auto-Save Dialog"

Automatically saves the V7 format files and skips the dialog box to defer the auto-save operation.

"V7 create backup in V8 format"

Automatically creates a backup of a V7 file in the V8 format. If set to true, a file is created in the same directory with the extension .v8.

MS_DWGAUTOSAVE

"DWG/DXF File Auto-Save"

Determines the frequency, in seconds, of the auto-save timer for DWG and DXF format files.

MS_DWGAUTOSAVE_NODIALOG

"DWG/DXF Auto-Save Dialog"

Automatically saves the DWG and DXF format files and skips the dialog box to defer the auto-save operation.

Levels

MS_LEVEL_LIB_DIR

"Level Library Path"

Defines the default directory to look for when exporting levels or importing levels to/from a .csv, .dgn or .dgnlib file.

MS_LEVEL_EDIT_NESTED_ATTACHMENT_LEVELS

"Edit Nested Attachment Levels"

If set, lets you edit the attributes of levels in nested reference attachments.

MS_V7_LEVEL_NAME_PREFIX

"V7 to V8 Level Name Prefix"

Defines the prefix to apply to unnamed levels when a V7 design file is upgraded to a V8 DGN file.

MS_V7TOV8_CSVNAME

"V7 to V8 Level CSV File"

Defines the .csv file, which controls how levels are mapped when a V7 design file is upgraded to a V8 DGN file.

MS_V7TOV8_DELETE_UNUSED_LEVELS

"V7 to V8 Delete Unused Levels"

If set to 1, then all unused levels are deleted when a V7 design file is upgraded to a V8 DGN file. This variable is ignored if the "V7 to V8 Level CSV File" variable is set.

MS_LEVEL_SEED_LEVEL_NAME

"Seed Level Name"

Can be set to the name of a seed level. This can be a level in the master file, or a level in a DGNLIB library file. If the variable is not set, the default level is the seed level. When a new level is create, it takes the attributes of the seed level.

MS_LEVEL_LOAD_ATTACHMENT_FILTER

"Load Attachment Level Filters"

If defined, then level-filters of reference attachments are loaded.

MS_LEVEL_CREATE_ FROM_SEED_ATTRIBUTE_LIST

"Seed Level Attributes to use"

Controls the set of attributes of the seed level that are copied to the new level. Attributes can be one or more of the following attributes as a comma separated list: OverrideSymbology, OverrideColor, OverrideStyle, OverrideWeight, ByLevelSymbology, ByLevelColor, ByLevelStyle, ByLevelWeight, GlobalFreeze, Lock, Plot

MS_LEVEL_EDIT_ATTRIBUTE_LIST

"Control Level Attributes Edit"

Controls which level attributes can be edited or overridden (instead of using operating system privileges for the entire level library). The attributes to be edited can be one or more of the following as a comma separated list: OverrideSymbology, OverrideColor, OverrideStyle, OverrideWeight, ByLevelSymbology, ByLevelColor, ByLevelStyle, ByLevelWeight, GlobalDisplay, GlobalFreeze, Lock and Plot. OverrideSymbology encompasses OverrideColor, OverrideStyle and OverrideWeight. ByLevelSymbology encompasses ByLevelColor, ByLevelStyle and ByLevelWeight. Each attribute accepts a "Library" or "Reference" prefix. Without the prefix, the attribute will be editable for both references and library levels.

MS_LEVEL_SYNC_ATTRIBUTE_LIST

"Control Level Attributes Sync"

Affects the dgnlib update levels custom and reference synchronize levels default key-ins. This variable controls the list of level attributes that will sync when any of the above key-ins is executed. The attributes can be one or more of the following as a comma separated list: OverideSymbology, OverrideColor, OverrideStyle, OverrideWeight, ByLevelSymbology, ByLevelColor, ByLevelStyle, ByLevelWeight, GlobalDisplay, GlobalFreeze, Lock, Plot.

MS_LEVEL_AUTO_SYNC_ATTRIBUTE_LIST

" Level Attribute Auto Sync"

This variable controls the list of level attributes that will automatically synchronize when a file is opened. The attributes can be one or more of the following as a comma separated list: OverideSymbology, OverrideColor, OverrideStyle, OverrideWeight, ByLevelSymbology, ByLevelColor, ByLevelStyle, ByLevelWeight, GlobalDisplay, GlobalFreeze, Lock, Plot. Each of the above attributes can take a “Reference” or “Library” prefix. If the prefix is not used, both reference and level library levels will be synchronized.

MS_REF_REATTACH_LEVEL_SYNC_ATTRIBUTE_LIST

"Ref. Reattach Level Attributes"

Specifies the list of level attributes that will sync when a reference is reattached. The attributes can be one or more of the following as a comma separated list: OverideSymbology, OverrideColor, OverrideStyle, OverrideWeight, ByLevelSymbology, ByLevelColor, ByLevelStyle, ByLevelWeight, GlobalDisplay, GlobalFreeze, Lock, Plot.

MS_UPDATE_KEEP_UNUSED_LIBRARY_LEVELS

"Keep Unused Library Levels"

If set to 1, keying in DGNLIB UPDATE LEVELS will not delete all unused library levels.

MDL Development

MS_RDE_SYSINC

"Runtime resource compiler"

Text to be inserted at the beginning of the command line by the resource compiler DLM. Generally used to specify the location of include files.

MS_DBGSOURCE

"MDL Source"

Location of source code for MDL applications (used by MDL debugger).

MS_MDLTRACE

"MDL Trace"

If set, additional debugging print statements are provided when debugging MDL applications.

MS_ASSERT_MESSAGE

"Assertion Failure Message"

Format of assertion messages. The default is Assertion Failure %s %s(%d).

MS_ASSERT_HANDLING

"Assertion Failure Handling"

Specifies handling of assertion failure:

  • 0 (default) — display error message

  • 1 — log error message

  • 2 — stop in debugger

MS_DEBUGFAULT

"Debug Fault"

If set, automatically invoke the debugger when a fault is detected while an MDL application is active.

MS_DEBUG

"Time Out"

If set to an integer with bit 1 on, do not time out.

MS_TRAP

"Exception Handling"

Exception handling flag — “ALL” (default), “MDL,” or “NONE.”

OLE

MS_OLESERVE_EMBED_REFFILES

"Embed References"

If set, references are embedded along with the master DGN file.

Operation

MS_DGNAUTOSAVE

"Design File Auto-Save"

Determines the frequency, in seconds, of the auto-save timer.

MS_AUTORESTORESTATUSBAR

"Auto-restore Status Bar"

If set to 1, the status bar is restored to its default appearance whenever the pointer is moved within.

MS_FKEYMNU

"Function Key Menu"

Open function key menu file.

MS_ACCUDRAWKEYS

"AccuDraw Shortcuts"

Text file listing AccuDraw shortcut keys.

MS_SAVEMENU

"Attached Menus"

File containing information about attached menus.

MS_APPMEN

"Application Menus"

Location of application and sidebar menus.

MS_WORKSPACEOPTS

"Workspace Options"

Sets how MicroStation Manager displays workspace options: 0 or not set (default) = workspace remains same; 1 = workspace options visible but disabled; 2 = workspace options hidden, MM resized.

MS_USECOMMANDWINDOW

"Use Command Window"

If set, 0 sets the status bar interface, and 1 sets the Command Window interface. If not set, the Style setting in MicroStation Manager determines the interface style.

MS_FILEHISTORY

"File History"

If set, MicroStation saves the last four files and directories for each file type.

MS_READONLY

"Read Only"

If set, the active DGN file is read-only.

MS_WORKMODE

"Work Mode"

Workmode activates/disables certain functions in order to produce a more compatible design at the end. Setting this variable to DWG will disable some creation tools that may result in elements that are incompatible with the DWG file format. Setting it to DGN (default) will gain full functional capacity in creating elements. You must restart MicroStation to see the effect of a changed value.

MS_DISALLOWFULLREFPATH

"Disallow Full Ref Path"

If set, you cannot save a reference attachment with a full path specification.

MS_IMMEDIATEUPDATE

"Window Immediate Update"

If set, view windows will immediately update when other windows are moved or resized over them..

MS_OPENV7

"Open V7 Files"

Controls MicroStation's behavior when opening V7-format design files. If not set or set to 0, the file opens with an alert dialog that provides an option to upgrade the file to V8 DGN format. If set to 1, the file is upgraded to V8 DGN format and opened. If set to 2, the file is opened in read-only mode. If set to 3, the file is opened in V7 workmode.

MS_DISABLE_FILE_ICONS

"Disable File Open Icons"

If set, the Show File Icons check box is not shown in the MicroStation Manager, New, and Open dialog boxes. Also, the setting is turned off thereby preventing the display of file list icons. The effect is not evident until you restart MicroStation.

MS_PLTR

"Default Printer Driver File"

Name of printer driver file.

MS_PLOTDLG_DEF_PLTFILE

"Force Default Printer Driver"

Name of printer driver file that loads, rather than last used printer driver.

MS_PLT_SYSPRT_PLTFILE

"Default Windows Printer Driver"

Name of printer driver file that is used when Windows Printers is selected.

MS_PLT_SYSPRT_DEFAULT_PRINTER

"Default Windows Printer Name"

Name of printer that is used when a default system printer opens.

MS_PLT_SYSPRT_DEFAULT_FORM

"Default Windows Form Name"

Name of form that is used when a default system printer opens.

MS_PLT_SYSPRT_DEFAULT_TRAY

"Default Windows Tray Name"

Name of tray that is used when a default system printer opens.

MS_PLTFILES

"Default Output Directory"

Directory for printing output files.

MS_POLTDLG_FORCEOUTDIR

"Force Output Directory"

Directory for plot files; overrides user preference file.

MS_PLOTINI

"Print Config Search Path"

Directory for print configuration files.

MS_PENTABLE

"Pen Table Search Path"

Search path for pen table files.

MS_BATCHPLT_SPECS

"Batch Print Specifications"

Name of the file that contains the batch plotting specifications.

MS_BATCHPLT_JOBSET_DIR

"Batch Print Job Directory"

Directory containing batch printing job files.

MS_BATCHPRINT_LOGFILE

"Batch Print Log File"

Name of batch printing log file.

MS_BATCHPRINT_ADD_ONLY_SHEET_MODELS

"Batch Print Add Sheet Models"

If set to 1, only adds sheet models to the job set when a design file is added.

MS_BATCHPRINT_ADD_ALL_MODELS

"Batch Print Add All Models"

If set to 0, does not add multiple entries, one per model, to the job set when a design file is added.

MS_BATCHPRINT_SETUPSYSPRT

"Batch Print Setup Sysprinter"

Controls the behavior of the Batch Print Setup System Printer dialog. PRNSELECT invokes the Windows printer selection dialog. PAGESETUP invokes the Windows page setup dialog.

MS_PLT_USE_MRU_DEFAULTS

"Enable “Last Used” Defaults"

Enables or disables the use of most-recently-used default files and directories.

MS_PLTDLG_ENABLE_ORIENTATION

"Enable Print Orientation"

Reverses the X and Y values of the paper size without having to edit the .plt file.

MS_PLTDLG_PREVIEW_ORIENTATION

"Preview Orientation"

Manipulates the orientation of the design and paper size definition.

MS_PLT_PREVIEW_USABLEAREACOLOR

"Preview Usable Area Color"

Specifies the color of the usable area rectangle in the preview window.

MS_PLT_PREVIEW_PRINTABLEAREACOLOR

"Preview Printable Area Color"

Specifies the color of the printer driver's printable area rectangle in the preview window.

MS_PLT_PREVIEW_PLOTBOXCOLOR

"Preview Plot Rectangle Color"

Specifies the color of the print bounding box rectangle in the preview window.

MS_PLT_PREVIEW_PLOTFENCECOLOR

"Preview Plot Fence Color"

Specifies the color of the print fence shape in the preview window.

MS_PLTDLG_UNLOADONCLOSE

"Unload Plot Dialog on Close"

Controls the load/unload of the Plot dialog box on closing.

MS_PLT_ENABLE_SCALE_CLIPPING

"Enable Scale Clipping"

If set to 0, does not reduce the plot fence or sheet size to accommodate the specified scale factor.

MS_PLT_ENABLE_PRESERVE_SCALE

"Enable Preserve Clipping"

If set to 0, does not preserve the current plot scale when a new view, fence or paper size is selected.

MS_PLT_ENABLE_AUTO_ROTATE

"Enable Automatic Rotation"

If set to 0, does not manipulate the plot rotation in order to achieve the best fit.

MS_PLT_ENABLE_AUTO_ORIENT

"Enable Automatic Orientation"

If set to 0, does not manipulate the paper orientation in order to achieve the best fit.

MS_PLT_HONOR_SHEET_INFO

"Honor Sheet Definitions"

If set to 0, operates as if no sheet attributes are set.

MS_PLT_AREA_PRIORITY

"Print Area Priority"

If set to 1, sheet definitions in the model take priority over the active fence.

MS_PLT_FORM_SCALE_PRIORITY

"Form Scale Priority"

If set to 1, the default form scale is reapplied whenever the paper size changes.

MS_PLT_MAX_ON_NEW_AREA

"Maximize on New Print Area"

If set to 1, the print size is maximized automatically when the print area changes.

MS_PLT_FIT_RASTER_REFS

"Fit with Raster Refs"

If set to 1, raster references are included when computing the design range for the Fit print area modes.

MS_PLT_AUTO_FIT_VIEW

"Automatically Fit View"

Controls the setting for the print area mode.

MS_PLTDLG_KEEPVIEWFLAGSONFENCECHANGE

"Keep View Flags on New Fence"

When a new fence is placed, controls the setting for resetting or preserving current print attributes.

MS_PLTDLG_WEIGHTOVERRIDE

"Print Dialog Weight Override"

Sets the weight print attribute.

MS_PLOTDLG_DEF_PENTABLE

"Default Pen Table"

Defines the default pen table that is loaded.

MS_PLTDLG_SETUPSYSPRTICON

"Setup Sysprinter Icon Mode"

Controls the behavior of the Configure Windows Printer icon on the Print dialog box. PRNSELECT invokes the Windows printer selection dialog. PAGESETUP invokes the Windows page setup dialog.

MS_PLT_ENABLE_PAGESETUP_MARGINS

"Enable Page Setup Margins"

If defined, margins are enabled on the Windows Page Setup dialog box.

MS_PLTDLG_SETUPSYSPRT_ENABLE_PRINT

"Enable Setup Sysprinter Print"

Controls the print behavior of the Configure Windows Printer icon.

MS_PLTDLG_ENABLE_SAVE_CONFIG

"Enable Save Configuration"

Disables the Print dialog Save Configuration menu items.

MS_PLT_SCALE_METHOD

"Scale Method"

Determines how the print scale displays in the Print dialog.

MS_PENTABLE_IMPORTEMPTYSECTIONS

"Import Empty Pen Table Section"

During AutoCAD plot style table imports, ignores pen table sections that have no effect. If set to 1, empty sections are created.

MS_PENTABLE_DISABLECOLOR

"Pen Table Disable Color"

Controls the color of a disabled section in a pen table; default is medium gray.

MS_PENTABLE_REGEX_LEVEL_COMPARE

"Pen Table RegEx Level Compare"

If defined, when comparing level names in the pen table, regular expressions are evaluated.

MS_PENTABLE_SLOTNUM_MATCH_APPLIES_TO_CHILD

"Pen Table Slot Number Match"

Controls how the pen table reference slot number match applies to the parent reference and its children.

MS_PENTABLE_IMPORTCTB_NOPENMAP

"Pen Table Import Pen Maps"

When importing CTB files, allows the proper color-to-width resymbolization of multi-colored elements.

MS_PLTFILE_EDITOR

"Plot Driver Editor"

Name of text editor to be used when Edit Printer Driver is activated.

MS_PLNONAME

"Exclude DGN Name from Plot"

Enables/disables the insertion of the DGN name in the output file.

MS_PLT_VIEWFLAGOFF_LINEWIDTHMM

"View Weight Off Line Width"

Allows the minimum line thickness to be set in millimeters.

MS_PLT_INVERT_WHITE_COLORS

"Invert White-to-Black Colors"

Allows you to override the colors that are automatically inverted from white to black.

MS_PLT_OLE_MAX_MFB_SIZE

"Maximum OLE Plot Buffer"

Allows for sharper plotted OLE objects at the expense of memory usage, processing time and plot file size.

MS_PLT_FORCE_HARDWARE_TEXT

"Force Hardware Text"

Text that otherwise would be stroked in software is sent to the printer driver as hardware text.

Protection

MS_PROTECTION_LICENSE_ENABLE

"Control license creation"

  • Set to 0 to disable license creation

  • Set to 1 to enable password licenses

  • Set to 2 to enable certificate licenses

  • Set to 4 to enable Everyone licenses

  • Set to 7 to enable all types of licenses (default)

Add indivual values together to enable two or more license types.

MS_PROTECTION_ENABLE

"Enable file protection"

  • Set to 0 to disable file protection (default)

  • Set to 1 to enable password or certificate protection

  • Set to 2 to enable password protection

  • Set to 3 to enable certificate protection

MS_PROTECTION_PASSWORD_MIXED

"Password letters and numbers"

A password containing a mixture of letters and numbers.

MS_PROTECTION_PASSWORD_MIMIMUM

"Minimum length of password"

Sets the minimum length of a file protection password. The default is 5.

MS_PROTECTION_NOENCRYPT_THUMBNAIL

"Do not encrypt file thumbnail"

The thumbnail is an image of the last used view of the design file. The image is displayed by Windows File Explorer and MicroStation Manager.

MS_PROTECTION_NOENCRYPT_PROPERTIES

"Do not encrypt file properties"

Set to 1, tells the Protect command to leave file properties unencrypted or set to 0 to allow Protect encrypt file properties.

Primary Search Paths

MS_DGNLIBLIST

"DGN Library List"

List of DGN libraries.

MS_DEF

"Design Files"

Search path(s) for DGN files.

MS_RFDIR

"References"

Search path(s) for references.

MS_MDLAPPS

"Visible MDL Applications"

Search path(s) for MDL applications displayed in the MDL dialog box.

MS_MDL

"MDL Applications"

Search path(s) for MDL applications or external programs loaded by MDL applications.

MS_MACRO

"Macros"

Search path for macros.

MS_RSRCPATH

"Resource Files"

Search path(s) for resource files loaded by MDL applications.

MS_LIBRARY_PATH

"Library Path"

Search path for dynamic link libraries.

RDL_DIR

"Redline Location"

Location and/or extension of the Bentley Redline-generated redline file. Defaults to the name of the open DGN file but with the suffix “.rdl,” instead of “.dgn,” in the same directory as the open DGN file.

DWGRDL_DIR

"DWG Redline Location"

Location and/or extension of the Bentley Redline-generated DWG redline file. Defaults to the name of the open DWG file with “_redline” inserted before “.dwg.” in the same directory as the open DWG file.

MS_FILTER_LIB_DIR

"Filter Library Path"

Directory containing filter data files.

Reference

MS_REF_DEFAULTATTACHDIRECTORY

"Default Attachment Directory"

If set, the Attach Reference dialog box defaults to this directory, rather than the directory of the last attached reference.

MS_REF_DEFAULTSETTINGS

"Default Attachment Settings"

Controls the default settings for reference attachments. This variable is set to a comma-separated list of key=value pairs.

To store the complete path to V7 files for newly attached references, set the variable to completepathv7=1.

MS_DISALLOWFULLREFPATH

"Disallow Full Ref Path"

If set, MicroStation does not save the full path to references. By default, MicroStation stores both an abbreviated (portable) path and the full path to references.

MS_REF_NEWLEVELDISPLAY

"New Level Display"

If set, MicroStation displays newly created levels in references. By default, when new levels are created in a model that is referenced by another model, the new levels are not displayed when the referencing model is opened. Newly created models are considered until “Save settings” is performed. This functionality only works when both the master file and referenced files are in the V8 file format.

MS_NEST_COLORADJUSTMENT

"Nested Reference Color Adjustment"

If set to any value, the nested reference color adjustments at each level are multiplied by this value. If not set, the color adjustment for the top level reference controls the color adjustment for all nested references.

MS_REF_DONTHILITEFORMANIP

"Hiliting References for Manipulation"

By default, MicroStation highlights all elements in a reference file when the reference is manipulated. If this variable is set to any value, this highlighting is disabled. Disabling speeds up the reference manipulations but makes it more difficult to see which references are being manipulated.

Rendering/Images

MS_MTBL

"Material Tables"

Search path(s) for material tables.

MS_MATERIAL

"Material Palettes"

Search path(s) for material palettes.

MS_PATTERN

"Pattern Maps"

Search path(s) for pattern maps.

MS_BUMP

"Bump Maps"

Search path(s) for bump maps.

MS_IMAGE

"Images"

Search path(s) for images.

MS_IMAGEOUT

"Image Output"

Directory in which image files created with Utilities > Image > Save and Utilities > Image > Capture are stored.

MS_SHADOWMAP

"Shadow Maps"

Directory where shadow maps will be read from and written to.

MS_LIGHTING

"IES Lighting Files"

Directory where IES lighting data will be stored.

MS_LIGHTLIST

"Pre-defined Light Sources"

Directory that lists the location of predefined lights.

MS_RENDERLOG

"Rendering statistics log"

File in which rendering statistics are logged.

MS_PTDIR

"Particle Tracing Work Dir"

Working directory for temporary Particle Tracing files.

MS_IMAGE_EDITOR

"Image Editor"

Default program to be used to edit an image file. The program is activated by double-clicking in the preview area of the Map Editor dialog box.

MS_MATERIAL_PREVIEW_BACKGROUND

"Material Preview Background"

Image to be used for the background of material previews in the Material Editor.

MS_RENDERV7MATERIALS

"V7 Material Compatibility"

If set to 1, materials are rendered as they were in V7. Most affected are translucency, transparency, specularity, and diffuse as applied to pattern maps.

Security

MS_SECURITY_LEVEL

"Security level"

Security level for loading and running applications in MicroStation.

MS_SECURITY_SPC

"Software Publishing Certs"

Path where MicroStation can find the Software Publishing Certificates used to digitally sign the applications that can be loaded in MEDIUM security mode.

Seed Files

MS_VIEWGROUPSEED

"View Group Seed File"

Name of file containing seed view group for models without a view group.

MS_VIEWGROUPSEEDNAME

"View Group Seed"

Name of seed view group for models without a view group.

MS_DWGSEED

"DWG Seed File"

Seed file used to create DWG file.

MS_SEEDFILES

"Seed File Location"

Search path(s) for all seed files.

MS_DESIGNSEED

"Default Design File Seed"

Default seed file.

MS_TRANSEED

"Default Translation Seed"

Default seed file for DWG, CGM, and IGES translations.

MS_CELL_SEEDFILE

"Cell Library Seed File"

Seed file used when creating or upgrading cell libraries.

MS_SHEETSEED

"Drawing Sheet Seed File"

Seed file used when creating drawing sheets.

MS_USERPREFSEED

"User Preference Seed"

Name of seed file used to create user preference resource file.

MS_DESIGNMODELSEED

"Design Model Seed File"

Name of file containing the seed model for the new design models.

MS_DESIGNMODELSEEDNAME

"Design Model Seed"

Name of seed model for new design models.

MS_SHEETMODELSEED

"Sheet Model Seed File"

Name of file containing seed model for new sheet models.

MS_SHEETMODELSEEDNAME

"Sheet Model Seed"

Name of seed model for new sheet

MS_DWGSHEETMODELSEED

"DWG Sheet Model Seed File"

Name of file containing seed model for new sheet models in DWG files.

MS_DWGSHEETMODELSEEDNAME

"DWG Sheet Model Seed"

Name of seed model for new sheet models in DWG files.

Spelling

MS_SPELLINGUSERDICTIONARY

"Spelling User Dictionary"

Specifies the user dictionary.

MS_SPELLINGLANGUAGE

"Spelling Language"

Specifies the language. Valid languages are: AmericanEnglish, BritishEnglish, Brazilian (Brazilian Portuguese), Danish, Dutch, Finnish, French, German, Italian, Norwegian, Spanish.

MS_SPELLINGDICTIONARYPATH

"Spelling Dictionaries"

Specifies the directory to search for core dictionaries.

Standards Checker

MS_STANDARDSCHECKER_SETTINGSFILE

"Required Standards Checker Set"

Sets the *.dgnlib file used for standards checking. If this variable is set, the specified file is always used for standards checking.

MS_STANDARDSCHECKER_SETTINGSNAME

"Required Standards Checker Name"

Sets the name of the settings to use (within the file specified by MS_STANDARDSCHECKER_SETTINGSFILE). If this variable is set, you cannot select different named settings.

MS_STANDARDSCHECKER_OUT

"Standards Checker Report Directory"

Default directory for standards checker reports.

MS_STANDARDSCHECKER_STYLESHEET

"Standards Checker Style Sheet"

If this variable is set, it specifies the XML style sheet that is used to view the Standards Checker XML report. This variable can be either a file or a URI (Universal Resource Identifier) that can be used by the browser to locate the style sheet. If this variable is not set, the XML style sheet in $(_USTN_WORKSPACEROOT)system/data/standardschecker.xsl is used.

MS_STANDARDSCHECKER_APPS

"Standards Checker Applications"

The list of MDL applications that are loaded when the Standards Checker utility is started.

Symbology

MS_SYMBRSRC

"Symbology Resources"

List of symbology resource files — last one in list has highest priority.

System Env(ironment)

MS_CONFIG

"Main Configuration File"

Main MicroStation configuration file — sets up all configuration variables.

RSC_COMP

"Resource Compiler Command Line"

Text string to be inserted at the beginning of the command line by the resource compiler (used to specify where to search for include files).

MDL_COMP

"MDL Compiler Command Line"

Text string to be inserted at the beginning of the command line by the MDL compiler (used to specify where to search for include files).

BMAKE_OPT

"BMAKE Options"

Command line options for BMAKE. Used to search for bmake include (.mki) files.

MS_DEBUGMDLHEAP

"Extended Malloc"

If set (to the base name of an MDL application or “ALL), use extended malloc for debugging.

Tags

MS_TAGOUTPUT

"Tag Output"

Output directory for tag data.

MS_TAGREPORTS

"Tag Reports"

Output directory for tag reports.

MS_TAGTEMPLATES

"Tag Templates"

Directory containing tag report templates.

Temp and Backup Files

MS_BACKUP

"Backup Files"

Default directory for backup files.

MS_DWG_BACKUP

"Directory for DWG backup files"

Directory for DWG backup (.bak) files. If this variable is not set, the files are placed in the same directory as the DWG file.

MS_NO_DWG_BACKUP

"Turn off DWG .bak files"

If set, a .bak file is not created when a DWG or DXF file is edited.

MS_TMP

"Temporary Files"

Directory for temporary files created and deleted by MicroStation.

MS_SCR

"Scratch Files"

Directory for scratch files created by MicroStation.

Translation — CGM

MS_CGMIN

"CGM Input Directory"

Input directory for CGM translations.

MS_CGMOUT

"CGM Output Directory"

Output directory for CGM translations.

MS_CGMLOG

"CGM Log Files"

Output directory for CGM log files.

MS_CGMTABLES

"CGM Configuration Tables"

Directory containing the CGM translation tables.

MS_CGMINSET

"CGMIN Settings File"

Settings file for the CGMIN application.

MS_CGMOUTSET

"CGMOUT Settings File"

Settings file for the CGMOUT application.

Translation — IGES

MS_IGESIN

"IGES Input Directory"

Input directory for IGES translations.

MS_IGESOUT

"IGES Output Directory"

Output directory for IGES translations.

MS_IGESLOG

"IGES Log Files"

Output directory for IGES log files.

MS_IGESINSET

"IGESIN Settings File"

Settings file for IGES import.

MS_IGESOUTSET

"IGESOUT Settings File"

Settings file for IGES export.

Translation — Step

MS_STEPOUT

"Step Output Directory."

Output directory for Step translations.

MS_STEPLOG

"Step Log Files."

Output directory for Step log files.

MS_ROSEDB

"Rose database directory."

Rose database directory.

User Commands

MS_UCM

"User Commands"

Search path(s) for user commands (UCMs).

MS_INIT

"Startup User Command"

Name of a user command to executed at startup

MS_EXIT

"Exit User Command"

Name of a user command to executed at exit

MS_NEWFILE

"New File User Command"

Name of a user command to executed when a DGN file is opened

MS_APP

"Apps from 'TSK' statements"

Search path(s) of applications started from “TSK” statements.

Visual Basic for Applications

MS_VBA_SAVEONRUN

"Automatically save VBA project"

If set to 1, MicroStation automatically saves modified VBA projects every time it starts running a VBA program.

MS_VBAAUTOLOADPROJECTS

"Names of standard projects"

Names of the projects that are opened when the VBA dialog box is opened.

MS_VBASEARCHDIRECTORIES

"Directories to search for VBA projects"

Directories that are searched when opening an existing VBA project.

MS_VBANEWPROJECTDIRECTORY

"Directory for new projects"

Directory that is used when a new project is created.

This table lists uncategorized configuration variables:

Variable

Description

CLASSPATH

Path to Java/JMDL classes.

HISTORY_MAX_MINOR_VERSIONS

The number of minor versions for the Limit History command to preserve in the history file.

MSDIR

MicroStation root installation directory.

MSLOCAL

Specifies the base directory path for where the required writable portions (that is, local for a network installation) of MicroStation are installed.

MS_80TRUETYPESCALE

If set to 1, True Type fonts using nonstandard True Type definitions will display as they did prior to V8.

MS_81TEXTNODEMIRRORING

If set, MicroStation uses the V8.1 method for mirroring a selection with Mirror Text turned off.

When this option is on, two problems can occur:

  • some style runs (collections of characters with the same text styles applied) may be reversed when mirrored about the Y axis (vertical)

  • line order is reversed in multi-line text when the element is mirrored about the X axis (horizontal)

MS_ASPECTRATIO

Specifies the correct aspect ratio of the display screen. This variable should be set to the ratio of the width to the height of the display area.

MicroStation automatically detects the aspect ratio of the display screens on most systems. In some configuration (including dual screen Windows displays), the video driver returns incorrect display size information, causing elements to appear stretched in either the horizontal or vertical direction. Use this variable to correct the aspect ratio.

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_DATA

Directory for data files created or used by MicroStation.

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_DGNOUT

Directory containing DGN files created as a result of “on the fly” translation from other file formats.

MS_DISALLOWFULLREFPATH

When set to 1, you cannot save a full path for a reference.

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

MS_DWGAUTOSAVE

Determines the frequency, in seconds, of the auto-save timer for DWG and DXF files. For example, if set to 300 (the default), an auto-save occurs approximately 5 minutes after the first change to the design. The minimum value is 30 seconds.

MS_DWGAUTOSAVE_NODIALOG

If set, auto-save occurs automatically, without displaying the default auto-save dialog box. For details, see DWG-related Configuration Variables.

MS_DWGINSERTLAYER

Specifies the layer to which normal (unshared) cells and reference attachments are assigned when saving the open DGN file in DWG format. If this configuration variable is not defined, layer 0 is used.

MS_DWGNODIRECTPROXIES

Controls how direct proxies (Autodesk Architectural Desktop multiview block references) are displayed. If set to 1, only the proxy entity's graphics or bounding box are displayed. If set to 0, these proxy entities are displayed as 2D or 3D representations, and they can be modified.

MS_DWGOMITUNIQUEEXTENSION

If more than one file with the same name is present in the same directory, appends the extension to the output filename when saving the file. For details, see DWG-related Configuration Variables.

MS_DWGPATFILE

Filename containing AutoCAD Pattern Definitions.

MS_DWGREF_ALLOWMASTERCOLORS

Defines how MicroStation uses color tables for DWG/DXF files attached as references. For details, see DWG-related Configuration Variables.

MS_DWGSYSTEMDATA

Identifies the directory containing the DWG settings file Dwgsettings.rsc. Overrides the directory specified by MS_DWGDATA.

The display and plotting color tables (DwgDisplayColor.tbl and DwgPlotColors.tbl) can also be controlled by placing them in this directory.

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_SERVER

Specifies the root location of the help content. Defaults to $(USTN_DOCUMENTATIONROOT), but can be set to a file server or URL. This variable does not determine if you are using uncompiled HTMLHelp content. If you set this variable, the value of MS_HELPLOAD_SERVER should be the location containing the product directory (i.e., MicroStation)

MS_HELPPATH

Path to help resource files.

MS_INITAPPS

List of initial start-up MDL applications.

MS_NEST_COLORADJUSTMENT

Not set by default, any color adjustment made to a top level reference is applied to all the nested attachments directly. If set to any value, then the color adjustments are applied cumulatively.

MS_OLDUSERLICENSE

File that contains old user license information. Required for when installing a product upgrade.

MS_OPENDESIGNFILEFILTER

Initial file filter for the MicroStation Manager and Open dialog boxes.

MS_OPENREFFILEFILTER

Initial file filter for the Attach Reference File dialog box.

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

For a detailed list of formatting strings for date and time, see Data and Time Format.

MS_PLTDLG_UNLOADONCLOSE

Controls whether the plot dialog is unloaded when its window is closed. If set to 1, TRUE, or undefined, the plot dialog application unloads itself when its dialog is closed, and all settings revert to their defaults when the dialog is reopened. If this variable is set to 0 or FALSE, the application remains loaded after the window is closed, and certain settings are retained when the plot dialog is reopened. For consistent behavior of the plot dialog, this variable should be undefined. Note that selecting File > Exit from the plot dialog menu always unloads the application.

MS_PLTMODELNAME

Displays the name of the model from which the print is produced.

MS_REFCOLORTABLE

If defined and set to 1, MicroStation always uses the reference's color table. If defined and set to any value other than 1, MicroStation never uses the reference's color table. If not defined, MicroStation uses the user preference to determine whether or not to use the reference's color table.

MS_REF_CYCLECHECK

If set to 0, MicroStation skips the circular reference check for DGN files. This variable does not affect DWG files.

MS_RIGHTLOGICKB

If set to 1, keyboard input is right to left.

MS_RSRC

Main MicroStation resource file. Typically set to “ustation.rsc.”

MS_SELECTSERVICESHOME

URL of Bentley SELECTservices homepage.

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_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.)

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

Stores a thumbnail image in each DGN file that can be seen in the MicroStation file open dialog boxes, as well as Windows Explorer. Can be used to control the behavior of thumbnail generation.

MS_USERPREF

User preference resource file.

MS_USERPREF_APPS

Set by application configuration files to add user preferences to standard dialogs.

MS_VBAV8TOV7DIALOG

Specifies the name of a VBA macro that opens a dialog to collect information to be used in translating a DGN file from V8 to V7 format.

MS_VBAV8TOV7FILTER

Specifies the name of a VBA macro that sets up a translation filter.

PZIP_OUT

Specifies default directory for creation of Packager files.