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.
一般步骤 — 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.
    或者
    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.

  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.

  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.

  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"

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

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.

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

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.

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.

MS_DWGFONTPATH

"AutoCAD Program Directory"

Directory containing AutoCAD. This is used to find the DWG support files such as fonts.

Visual Basic for Applications

MS_VBASAVEONRUN

"Automatically save VBA project"

If set to 1, MicroStation PowerDraft automatically saves modified VBA projects each 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.

Design Applications

MS_DGNAPPS

(not applicable)

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

Design History

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_COMMIT_ON_CLOSE

"Commit before close"

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

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_COLORS

"Colors"

Specifies the colors to use when identifying changed elements.

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.

MS_DESIGN_HISTORY

"Design History capabilities"

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

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 PowerDraft main window, allowing the viewer to always be seen.

MS_USEEXTERNALBROWSER

"External browser name"

Sets an external browser.

Extensions

MS_USERINT_PREFS

(not applicable)

MS_SELECTSERVICESHOME

(not applicable)

URL of Bentley SELECTservices homepage.

MS_DWG_OBJECT_APP

(not applicable)

Lists Object Enabler MDL applications to be loaded. It is currently set to use applications that enable Architectural Desktop and AutoPlant objects (AdtDirectApp and RebisDirectapp). Users should not need to change this setting.

MS_DWG_LWDEFAULT

(not applicable)

Controls the width of the default line weight and is analogous to the AutoCAD registry variable “LWDEFAULT”. The default value is 0 for unweighted default lines. Valid LWDEFAULT values are 0, 5, 9, 13, 15, 18, 20, 25, 30, 35, 40, 50, 53, 60, 70, 90, 100, 106, 120, 140, 158, 200, 211.

MS_DWG_PROXYSHOW

(not applicable)

Controls the display of proxy objects within a DWG drawing. It is analogous to the AutoCAD registry setting PROXYSHOW. Settings are: 0 – no graphics, 1 - complete graphics and 2 – bounding box display only. The default setting is 1.

MS_PROCESSEXCEPTIONLOG

(not applicable)

MicroStation PowerDraft exception.log and "minidump.dmp" management.

MS_APPMEN

(not applicable)

Location of application and sidebar menus.

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. If set to zero, no auto save is done while the file is open. The file is automatically saved on exit or when switching to a different file.

MS_V7AUTOSAVE_NODIALOG

"V7 Auto-Save Dialog"

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

MS_V7BACKUPV8

"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. If set to zero, no auto save is done while the file is open. The file is automatically saved on exit or when switching to a different file.

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.

OLE

MS_OLESERVE_EMBED_REFFILES

"Embed References"

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

Operation

MS_COMPRESS_OPTIONS

"Compress Options Selections"

Sets the values for individual items by alias; overrides the user preferences.

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

"Allow Docking Beside Main Menu"

If set to zero or not set (default), the Main menu bar spans the entire width of the application window. If set to a non-zero value, dockable toolboxes and dialogs can be docked along the Main menu bar.

MS_FILEHISTORY

"File History"

If set, MicroStation PowerDraft 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 disables some creation tools that may result in elements that are incompatible with the DWG file format. Setting it to DGN (default) gains full functional capacity in creating elements. You must restart MicroStation PowerDraft to see the effect of a changed value.

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

MS_DISABLE_FILE_THUMBNAIL

"Disable File Open Thumbnail"

When on, disables the file preview thumbnail images in MicroStation Manager and Open dialog boxes.

"Exit MicroStation when idle"

Specifies the number of minutes of inactivity before exiting MicroStation PowerDraft. The minimum value is 30 minutes. A value of zero means MicroStation PowerDraft will not exit, even when idle.

"Popup Dialog Close Delay"

Specifies the amount of time before closing a pop-up dialog. The value, specified in 1/60 second increments should range between 0 to 2 seconds. The default is 30 (1/2 second).

"Full Path in Title Bar"

If on, full path of current design file displays in the main title bar.

Protection

MS_PROTECTION_ENABLED

"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_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 individual values together to enable two or more license types.

MS_PROTECTION_PASSWORD_MIXED

"Password letters and numbers?"

A password containing a mixture of letters and numbers.

MS_PROTECTION_PASSWORD_MINIMUM

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

Printing

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

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"

Defines the location and/or extension of the Bentley Redline-generated redline file for which the Redline On tool searches.

DWRRDL_DIR

"DWG Redline Location"

Defines the location and/or extension of the Bentley Redline-generated DWG redline file for which the Redline On tool searches.

MS_FILTER_LIB_DIR

"Filter Library Path"

Directory containing filter data files.

Security

MS_SECURITY_LEVEL

"Security level"

Security level for loading and running applications in MicroStation PowerDraft.

MS_SECURITY_SPC

"Software Publishing Certs"

Path where MicroStation PowerDraft 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 to create or upgrade cell libraries.

MS_SHEETSEED

"Drawing Sheet Seed File"

Seed sheet file drawing composition, DWG import, and IGES import.

MS_USERPREFSEED

"User Preference Seed"

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

MS_DESIGNMODELSEED

"Design Model Seed File"

File containing seed model for new design models.

MS_DESIGNMODELSEEDNAME

"Design Model Seed"

Seed model for new design models.

MS_SHEETMODELSEED

"Sheet Model Seed File"

File containing seed model for new sheet models.

MS_SHEETMODELSEEDNAME

"Sheet Model Seed"

Seed model for new sheet models.

MS_DWGSHEETMODELSEED

"DWG Sheet Model Seed File"

File containing seed model for new sheet models in DWG files.

MS_DWGSHEETMODELSEEDNAME

"DWG Sheet Model Seed"

Seed model for new sheet models in DWG files.

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 PowerDraft configuration file — sets up all configuration variables.

Tags

MS_TAGOUTPUT

"Tag Output"

Output directory for tag set libraries.

MS_TAGREPORTS

"Tag Reports"

Output directory for tag reports.

MS_TAGTEMPLATES

"Tag Templates"

Directory containing tag report templates.

Temp and 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, .bak file is not created when a DWG or DXF file is edited.

MS_BACKUP

"Backup Files"

Default directory for backup files.

MS_TMP

"Temporary Files"

Directory for temporary files created and deleted by MicroStation PowerDraft.

MS_SCR

"Scratch Files"

Directory for scratch files created by MicroStation PowerDraft.

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 PowerDraft 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_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_CUSTOMFONTCREATION_ENABLE

If set to 1, MicroStation PowerDraft uses a custom font to render text characters that cannot be rendered using the font with which a text element was placed.

MS_DATA

Directory for data files created or used by MicroStation PowerDraft.

MS_DEFCHARTRAN

Default character translation table.

MS_DESIGNFILTER

Default file filter for the MicroStation Manager, Open, and Save As dialog boxes. If MS_DESIGNFILTER is not defined, the default filter is “*.dgn”.

MS_DGNOUT

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

MS_DISALLOWFULLREFPATH

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

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_DWGSAVETEXTSYLETEMPLATENAME

Naming template for DWG text styles automatically created when saving a DGN file as a DWG file for fonts in which text was placed without using a text style . In the template, %s indicates the font name. If this configuration variable is not defined, the template defaults to Style-%s.

MS_DWG_PLANARPOLYLINES

If defined as “3DPOLYLINE,” planar line strings that are not parallel to the X-Y plane or that have non-zero elevations will be saved to 3D polylines when the open DGN file is saved as a DWG file. Otherwise, planar line strings will be saved to 2D “LightWeight” polylines.

MS_GUIHAND

Identifies auxiliary handlers.

MS_HELPPATH

Path to help resource files.

MS_INITAPPS

List of initial start-up MDL applications.

MS_JAVA_OSS

Sets the maximum Java/JMDL stack size for any thread.

MS_JAVA_SS

Sets the maximum native stack size for any thread.

MS_NEST_COLORADJUSTMENT

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_OLDUSERLICENSE

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

MS_OPENDESIGNFILEFILTER

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

MS_OPENREFFILEFILTER

Initial file filter for the Attach Reference File dialog box.

MS_REF_DONTHILITEFORMANIP

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

MS_REF_NEWLEVELDISPLAY

If set, MicroStation PowerDraft 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_RIGHTLOGICKB

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

MS_RSRC

Main MicroStation PowerDraft resource file. Typically set to “msdraft.rsc.”

MS_USERLICENSE

File containing MicroStation PowerDraft license information.

MS_USERPREF

User preference resource file.

Using configuration variables in key-ins

As an alternative to using the Configuration dialog box (Workspace > Configuration), you can define a configuration variable from the Key-in window using the key-in EXPAND SET. For example, to create a configuration variable MYFILE having as its value the name of the open DGN file, key in EXPAND SET MYFILE = $(_dgnfile) — note that there must be a space both before and after =.

You can also use configuration variables as parameters in key-ins. For example, to create a cell whose name is the name of the open DGN file (without the extension), key in $ CREATE CELL $(basename(_dgnfile)). In this example the first $ is an alias for the key-in EXPAND KEYIN. In other words, the key-in EXPAND KEYIN CREATE CELL $(basename(_dgnfile)) is equivalent. The second $ indicates what follows in parentheses is a configuration variable.

To check the value of a configuration variable, key in EXPAND ECHO $(<configuration_variable>) — for example, EXPAND ECHO $(MS_DESIGNSEED). The value is displayed in Message Center.