Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
  • Welcome
  • Products
  • Support
  • About
  • More
  • Cancel
MicroStation
  • Product Communities
  • More
MicroStation
[Archived] AskInga Wiki MicroStation J Workspaces
    • Sign in

    • -AskInga
      • +3D MicroStation
      • +AccuDraw Secrets
      • +Animation - Rendering
      • +Behind The Scenes
      • +Cells
      • +Colours
      • +Conversion - Translation
      • +Coordinate Input
      • +Design Settings
      • +Dimensions
      • +DWG
      • +EDG
      • +Element Manipulation
      • +Element Properties
      • +Element Selection
      • +Freeware - Shareware
      • +Interface Look And Feel
      • +Internet - E-Links - Links
      • +Keyins
      • +Levels
      • +Line Styles
      • +Models
      • +MSM Archive
      • +Other
      • +Presentations
      • +Printing - Plotting
      • +Programming - Automation
      • +Rasters - Images
      • +References
      • +Tags - Data Fields - Fields
      • +Text - Fonts - Annotation
      • +Views
      • +Windows - Interacting With
      • -Workspaces - Configuration
        • All about saving DWG files
        • Auto-open a file to a specific model
        • Change the MicroStation Manager workspace options
        • Complete list of MicroStation V8's configuration variables
        • Compress your UPF file
        • Configuration variable operators
        • Configuration variable processing
        • Configure your compress options
        • Control the output location of MicroStation Packages
        • Convert MDF files to DGNLIB
        • Create new UPF every time you start MicroStation
        • Creating a configuration file
        • Current working directory
        • Customized Standards Checker Reports
        • Degeek MS DESIGN HISTORY REVISION NUMBER FORMAT
        • Deleting your UPF while retaining most settings
        • Digging into your workspace
        • Disable stuff MicroStation can or can't do
        • Do you really need to restart MicroStation when editing variables?
        • Edit Project variables via workspace configuration
        • Get rid of MicroStation Text Window
        • Have only one UPF regardless of the workspace you are using
        • How to figure out what the command line switches are
        • How to set WORKDIR DGNDIR after starting MicroStation
        • Learning about workspaces
        • List the configuration variables
        • Lock down your variables
        • Managing MicroStation backup directories
        • MicroStation J and V8 workspaces on the same computer
        • MicroStation J enhanced workspace functionality
        • MicroStation J Workspaces
        • Monitor your UPF file
        • Move your custom interface from one machine to another
        • MS_RFDIR limitations
        • Open V7 files without reconfiguring V8
        • Open Windows Explorer to location of workspace files
        • Preprocessor directives for processing configuration files
        • Quickly restore the defaults with a command line switch
        • Referencing other configuration variables
        • Regarding the last line in a configuration file
        • Report your variables with Expand Echo keyin
        • Return to the MicroStation Manager
        • Run Debug from a modified icon
        • Run debug from the command prompt DOS window
        • Set temporary variables with the Expand Set keyin
        • Set up a seed file for your UPF file
        • Setting the MS_OPENV7 variable
        • Sharing your workspace
        • Shawn Foster's BE 2005 presentations
        • Show all configuration variables not just some
        • Show full path of active file in title bar
        • Specify sub-folders when making a new project
        • Specify the folder for msdebug.txt
        • Temporary files
        • The types of configuration variables
        • The User Preference File [UPF]
        • Total length of file paths
        • Transcending the workspace and time continuum
        • Understanding configuration variables
        • Understanding MicroStation BASIC configuration variables
        • Use a library legend to help manage your library definitions
        • User interface hierarchy
        • Viewing and determining the configuration variables
        • What happens when you launch MicroStation?
        • What is a workspace?
        • Working with V7 files in V8
        • Workspace root
        • You're the CAD Manager, now what?
    • graffiti

     
     Questions about this article, topic, or product? Click here. 

    MicroStation J Workspaces

    AskInga logo

    Original Article Date: Jan 1, 1999

    Understanding the differing workspace variables and new root variables in MicroStation/J will enable you to modify your workspaces more easily and effectively.
    1999-01-01 Originally published in The Client Server
    2006-03-02 Aquired and posted on AskInga

    If you have begun working in MicroStation/J, then you have already noticed that the directory structure has changed from earlier MicroStation editions. Depending on how you wrote your configuration files, it may not be possible for you to simply drop your configuration files on top of MicroStation/J. You may have to do a bit of tweaking before you have your workspaces as you like them. This article should make that process a bit easier.

    Msdebug.txt
    Your msdebug.txt file can prove invaluable when creating or modifying workspaces. It is basically a snapshot of your configuration, showing which configuration files are being read, which variables are being defined in these files and where these variables are pointing as they are defined. The end of the file contains a summary that shows all the variables and their final definitions.

    A quick comparison of debugs from MicroStation/J and any previous editions of MicroStation can show you where your variables were pointing, where they were defined and where to define them now. The debug will also give you the pathname to your configuration files, as well. In MicroStation/J, the information is saved in the ../bentley/program/microstation directory. In MicroStation SE/95/V5, the debug information is saved in the root directory of MicroStation.

    After you install MicroStation/J, you should run a debug of MicroStation/J (as well as any previous editions of MicroStation). To do this, you need to append –debug to your command line. On Windows platforms, you can edit the properties of the MicroStation icon by right-clicking on the MicroStation icon.

    Go to the shortcut tab and add –debug to the target or command line. For example, if your command line is c:\win32app\ustation.exe, then it should look like this: c:\win32app\ustation.exe –debug. Click OK.

    Now double-click the MicroStation icon. A text window will pop up and scroll for a few moments. When the debug is finished, you can press Enter to close the text window. (Remember to remove the –debug from your icon when you are finished.)

    If your operating system supports a command line, you can also key this in. Simply add the –debug to the end of your normal keyin.

    Note: In MicroStation/J, your configuration files have moved a bit. Your *.ucf files (user configuration files ) are now in ..\bentley\workspace\users. The license.txt file, previously named the site.txt file, is now located in the ..\bentley\workspace\standards\ directory, along with a standards.cfg. This is the new site directory in MicroStation/J. Your *.pcf files (project configuration files) are now located in the ..\bentley\workspace\project\ directory.

    Differing variables:
    The major difference you will see in MicroStation/J is the absence of the WSMOD, and its associated variables. Previous editions of MicroStation loaded (by default) the following files, and were pointed to by these variables.

    Note: This is not a complete listing of MicroStation 95/SE variables—just the main variables partially defined by the WSMOD variable.

    MicroStation 95/SE Variable

    Definition MicroStation 95/SE Directory
    MS_WSMOD Points to the main workspace directory \ustation\wsmod\
    MS_CELL Points to the default cell libraries \ustation\wsmod\default\cell\
    MS_SEEDFILES The default seed files \ustation\wsmod\default\seed\
    MS_LEVELNAMES The level name files \ustation\wsmod\default\data\
    MS_SETTINGSDIR Your Settings Manager files \ustation\wsmod\default\data\
    MS_FKEYMENU Your function key menus \ustation\wsmod\default\data\
    MS_GLOSSARY The files for MicroStation’s glossary \ustation\wsmod\default\data\
    MS_SETTINGS Your current settings resource file \ustation\wsmod\default\data\
    MS_SYMBRSRC Your font and linestyle resources \ustation\wsmod\default\symb\
    MS_SHEETSEED The seed files for your sheet files \ustation\wsmod\default\seed\
    MS_TRANSEED The seed file for DWG, CGM and IGES translations \ustation\wsmod\default\seed\
    MS_BATCHPLT_SPECS The file containing batch plotting specifications \ustation\wsmod\default\data\



    Here are the variables in MicroStation /J, along with their definitions.

    MicroStation /J Variable

    Definition MicroStation /J Directory
    MS_WSMOD No longer contained in MicroStation  
    MS_CELL $(_USTN_SYSTEMROOT)cell\ \bentley\workspace\system\cell\
    MS_LEVELNAMES $( _USTN_SYSTEMROOT)data\ \bentley\workspace\system\data\
    MS_SETTINGSDIR $(_USTN_SYSTEMROOT)data\ \bentley\workspace\system\data\
    MS_FKEYMENU $(_USTN_USERINTROOT)fkeys\funckey.mnu \bentley\workspace\interfaces\fkeys\
    MS_GLOSSARY $(MS_DATA)*.gls \bentley\workspace\system\data\
    MS_SETTINGS $(MS_DATA)styles.stg \bentley\workspace\system\data\
    MS_SYMBRSRC  $(_USTN_SYSTEMROOT)symb\*.rsc \bentley\workspace\system\symb\
    MS_SHEETSEED $(_USTN_SYSTEMROOT)seed\sheetsd.dgn \bentley\workspace\system\seed\
    MS_TRANSEED $(_USTN_SYSTEMROOT)seed\transeed.dgn \bentley\workspace\system\seed\
    MS_BATCHPLT_SPECS $(MS_DATA)batchplt.spc \bentley\workspace\system\data\



    The files formerly contained in the WSMOD directories are now contained in the /bentley/workspace/system directories. These files are the resource files.

    New variables:
    The new variables defined in MicroStation /J are the *root variables, of which there are several. These variables supercede the WSMOD variables previously used. The *root variables are the foundation of many other MicroStation variables.

    Root Variable

    Definition MicroStation /J Directory
    _USTN WORKSPACEROOT The workspace root directory \bentley\workspace\
    _USTN_USERINTROOT  Root directory for interface files \bentley\workspace\interfaces\
    _USTN_SYSTEMROOT  System workspace files \bentley\workspace\system
    _USTN_PROJECTSROOT Your project files \bentley\workspace\projects\

    The following variables use the *root variables in their definition:

    _USTN_SYSTEMROOT=$(_USTN_WORKSPACEROOT)system\
    \bentley\workspace\system\
    These are the files typically delivered by Bentley. These include DGN files, cell libraries, font and linestyle resource files, Settings Manager resource files, etc.

    _USTN_SITE=$(_USTN_WORKSPACEROOT)standards\
    \bentley\workspace\standards\
    These directories are delivered empty. This is the location meant to be used as your site files, and should be populated with your data files.

    _USTN_PROJECTSROOT=$(_USTN_WORKSPACEROOT)projects\
    \bentley\workspace\projects\This is the main project directory. When creating a new project from the MicroStation Manager, the project will appear in this directory, complete with subdirectories for your data files.

    _USTN_PROJECT=$(_USTN_PROJECTSROOT)
    \bentley\workspace\projects\
    This is the directory containing your project configuration files.

    _USTN_USER=$(_USTN_WORKSPACEROOT)users\
    \bentley\workspace\users\
    This is the directory containing your user configuration files (.ucf). When you create a new workspace, a new .ucf file is also created.

    _USTN_USERINTROOT=$(_USTN_WORKSPACEROOT)interfaces\
    \bentley\workspace\interfaces\
    This is the root directory containing product specific interfaces.

    _USTN_USERINT=$(_USTN_USERINTROOT)$(_ENGINENAME)\
    \bentley\workspace\interfaces\MicroStation
    This is the user interface directory for data, containing the interfaces for the products used.

    MS_UCM=$(_USTN_SYSTEMROOT)ucm\
    \bentley\workspace\system\ucm\
    This directory contains the delivered user command examples.

    MS_APPMEN=$(_USTN_SYSTEMROOT)data\
    \bentley\workspace\system\data\
    This is the location of application menus.

    MS_MATERIAL=$(_USTN_SYSTEMROOT)materials\
    \bentley\workspace\system\materials\
    This is the location of material files for rendering.

    MS_PATTERN=$(_USTN_SYSTEMROOT)materials\pattern\
    \bentley\workspace\system\materials\pattern\
    This is the location of the pattern files for rendering.

    MS_BUMP=$(_USTN_SYSTEMROOT)materials\bump\
    \bentley\workspace\system\materials\bump\
    This is the location of the bump files used for rendering.

    MS_DATA=$(_USTN_SYSTEMROOT)data\
    \bentley\workspace\system\data\
    This is the location of your data files. Typically color tables, level name files, settings manager resources, etc.

    MS_FKEYMNU=$(_USTN_USERINTROOT)fkeys\funckey.mnu
    \bentley\workspace\interfaces\fkeys\funckey.mnu
    This is the location of your function key menus. This has been broken out into the interface directory.

    MS_MENU=$(_USTN_SYSTEMROOT)menus\cell\msmenu.cel
    \bentley\workspace\system\menus\cell\msmenu.cel
    This is the location of your menu cells.

    MS_SYMBRSRC=$(_USTN_SYSTEMROOT)symb\*.rsc
    \bentley\workspace\system\symb\*.rsc
    This is the location of your font resource and linestyle resource files.

    MS_DWGTABLES=$(_USTN_SYSTEMROOT)tables\dwg\
    \bentley\workspace\system\tables\dwg
    This is the location of your translation table files.

    MS_SHEETSEED=$(_USTN_SYSTEMROOT)seed\sheetsd.dgn
    \bentley\workspace\system\seed\sheetsd.dgn
    This is the default seed file for creating sheet files.

    MS_CGMTABLES=$(_USTN_SYSTEMROOT)tables\cgm\
    \bentley\workspace\system\tables\cgm\
    This is the location of your CGM translation tables.

    MS_CELL=$(_USTN_SYSTEMROOT)cell\;$(_USTN_SITE)cell\
    \bentley\workspace\system\cell\; ..\bentley\workspace\standards\cell\
    These are the location of your cell libraries.

    MS_SETTINGSDIR=$(_USTN_SYSTEMROOT)data\;$(_USTN_SITE)data\
    \bentley\workspace\system\data\; ..\bentley\workspace\standards\data\
    These are the location of your settings manager resource files.

    MS_MACRO=$(_USTN_SITE)macros\;$(_USTN_SYSTEMROOT)macros\
    \bentley\workspace\standards\macros\; ..\bentley\workspace\system\macros\
    These are the location of your MicroStation BASIC macros.

    MS_SEEDFILES=$(_USTN_SYSTEMROOT)seed\;$(_USTN_SITE)seed\
    \bentley\workspace\system\seed\; ..\bentley\workspace\standards\seed\
    These are the location of your seed files.

    Knowing the definition of these variables will greatly ease your updating process. And if you do need to tweak your configuration files a bit, then having a debug and a listing of the variables will help you, as well. And always remember to document your workspaces.

    AskInga Article #286

    • Askinga
    • Article
    • WorkSpacesConfiguration
    • Share
    • History
    • More
    • Cancel
    • Danielle Schutz Created by Bentley Colleague Danielle Schutz
    • When: Thu, May 22 2008 12:03 PM
    • Inga Morozoff Last revision by Bentley Colleague Inga Morozoff
    • When: Tue, Jun 8 2010 2:58 PM
    • Revisions: 6
    • Comments: 0
    Recommended
    Related
    Communities
    • Home
    • Getting Started
    • Community Central
    • Products
    • Support
    • Secure File Upload
    • Feedback
    Support and Services
    • Home
    • Product Support
    • Downloads
    • Subscription Services Portal
    Training and Learning
    • Home
    • About Bentley Institute
    • My Learning History
    • Reference Books
    Social Media
    •    LinkedIn
    •    Facebook
    •    Twitter
    •    YouTube
    •    RSS Feed
    •    Email

    © 2021 Bentley Systems, Incorporated  |  Contact Us  |  Privacy |  Terms of Use  |  Cookies