Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
OpenRoads | OpenSite
  • Product Communities
OpenRoads | OpenSite
OpenRoads | OpenSite Wiki InRoads Command Line Switch
    • Sign In
    • -Road and Site Design - Wikis
      • +OpenRoads Designer
      • +OpenRoads ConceptStation
      • +OpenRail Designer
      • +OpenSite Designer
      • +OpenRoads Navigator Mobile App
      • +SS10/SS4/SS3 OpenRoads
      • +GEOPAK Native
      • -InRoads Native
        • +Bridge
        • +Data Acquisition
        • +Data Import And Export
        • +Drafting
        • +Drainage Design
        • +Geometry Design
        • +InRoads General Topics
        • InRoads Product Tutorials
        • -Installation/Start Up
          • "Error loading the LOCALE resources library, CIVUSTNZF.DRX" followed by a lot of similar messages
          • Enable Desktop Integration of PowerInRoads with ProjectWise
          • InRoads and Bentley Rail Track installation on same system
          • InRoads Command Line Switch
          • SignCAD Integration with GEOPAK
        • +Knowledge Base - InRoads
        • LandXML Translator - Enable Cross Section
        • +Profiles, Cross Sections & Volumes
        • +Quantities
        • +Rail
        • +Reports
        • +Roadway Designer
        • +Site Modeler
        • +Surface Design
        • +Survey Tools
        • +Tools
        • Video: Export Alignment Points to Cogo
        • XIN is Blank - Preferences and Styles Lists are Empty
      • +MX Native
      • +OpenRoads SignCAD

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

    InRoads Command Line Switch

       
      Applies To 
       
      Product(s): InRoads
      Version(s): V08.11.07.494+ (SS2 Only)
      Environment:  N/A
      Area:  N/A
      Subarea:  N/A
      Original Author: Bentley Technical Support Group
       

     

     

     

     

     

     

     

     

    Overview

    Beginning in the InRoads (and Bentley Rail Track) V8i SS2 Refresh (V08.11.07.494), a change was made to the way InRoads products are started.   Users now have the option to disable the Civil Platform tools via a command line switch on the InRoads and MicroStation executables.   Be default, when the V8i SS2 Refresh of InRoads and MicroStation are delivered the Civil Platform and Applications menu are not available in MicroStation.  Users must initially add a new command line switch to activate these options. 

    InRoads can still be initialized through the MDL Applications or a custom Menu button in MicroStation by adding the command line switch to MicroStation.  This allows users to access the Applications Menu and Civil Platform Tools,  upon the initialization of MicroStation Only.

    Please note that these Applications and Civil Platform tools are available if you initialize MicroStation via the InRoads Executable as the command line switch exists in the delivered InRoads Executables.

     

    New Command Line Switch

     -wsLoad_InRoads_SS2=1

    There are 2 ways in which you can add this command line switch to regulate if the Civil Platform tools are loaded and the Applications menu appear in Microstation.

    1.)  Add -wsLoad_InRoads_SS2=1 to target after the Microstation EXE (and InRoads EXEs)

    or

    2.)  Add Load_InRoads_SS2=1 to a CFG in the 'system' folder (i.e. load_inroads.cfg) C:\Program Filed\Bentley\MicroStation V8i (SELECTseries2)\MicroStation\config\system

     

    To proceed with option 1, you will go to Start > All Programs > Bentley > MicroStation V8i (SELECTseries2) > right-click on the MicroStation V8i (SELECTseries2) icon and select Properties.  Then add the command line switch to the end of the "Target" line executable.  You may also wish to verify this command line switch is added to the InRoads icon targets, although they should be delivered with this new command line switch appended to the Target value.

     

        

    When adding the command line switch to the target path, you may receive the following error.  If so, you must make sure you put a space in the line between the path to the executable and the new command line switch.

    For option 2, you can go to C:\Program Files\Bentley\MicroStation V8i (SELECTseries)\MicroStation\config\system > right-click and add a new text document titled load_inroads.cfg.  Edit this new CFG file and in the document, type in Load_InRoads_SS2=1.   This process will add the Applications menu and Civil Platform tools in the same way as editing the executable target, plus this can be easily transferred from one machine to another.

    If working in MicroStation without the command line switch added to the executable or CFG and you try to access InRoads through a shortcut Menu key or through the MDL load, you will receive a SiteModelerAT.DLL error stating 'Unable to load dll: "SiteModelerAT.dll"'.  This is because the Civil Tools utilized by InRoads are not available when InRoads is initialized, therefore it gives an error message.   You will need to have the -wsLoad_InRoads_SS2=1 switch added to the MicroStation executable or have the load_inroads.CFG created to call up the command line switch to bypass this error message.

    Reverting to Pre-SS2 Refresh Settings

    It is possible to revert to Pre-SS2 Refresh settings by removing the command line switch from all InRoads icons, and removing the IF statements from the InRoadsAT.CFG file.  To do so, edit the "InRoadsAT.CFG file in the "..\MicroStation\config\appl" directory and remove the %if defined (Load_InRoads_SS2)at the beginning of the file, and the %endif at the end of the file.

    ProjectWise

    Users may add the InRoads command line switch to their InRoads program association by going to Tools>Associations>Programs... in ProjectWise Explorer, then editing the InRoads association under User Associations, and adding the switch to the Command Line Argument field.  This is demonstrated in a video clip below.

    Administrators may manually add the command line switch to the InRoads applications by editing the Applications in the ProjectWise Administrator.  This is demonstrated in a video clip below.

    To globally update program associations via ProjectWise Administrator for All Users:

    1. Copy the file CivilAppsappinfo.xml to the machine where the ProjectWiser server is installed (located in "C:\Program Files\Bentley\InRoads Group V8.11" folder) .
    2. Open a command window and navigate to the "...\ProjectWise\bin" directory.
    3. Enter the command:
    4. dmsconv.exe -d ODBCDataSourceName -u DatabaseUserName.Password -appfile "PathToThisFile" (This operation should be done by ProjectWise administrator).
    5. When prompted to update MIME type select no. MIME type update is not necessary for this update.

     

     

    Videos

     

    If InRoads is initialized through the Start menu or its icon with the command line switch added to the InRoads executable, the Application Menu and Civil Platform Tools ARE available.  This is how InRoads and Microstation should act as delivered.

    If Microstation only is loaded without the new command line switch, you will see that the Application Menu and Civil Platform Tools are NOT available.  By adding the command line switch, these option become available in Only Microstation.

    Option 2 with the creation of a CFG file to load the Applications and Civil Platform Tools when loading only MicroStation.

    If InRoads is initialized from the Start Menu and the command line switch is not added to InRoads or Microstation executables, you will see the Applications Menu and Civil Platform tools are NOT availalbe and you will receive a Microstation Text Window stating the CivUstAT.DLL could not be loaded.

    In ProjectWise Explorer, users can add the command line switch to their User Program Associations.

    ProjectWise Administrators can set the command line switch globally for InRoads programs.

     

     

    Background Information

    There are two primary reasons for implementing a command line switch to launch InRoads beginning in the V8i SS2 refresh:

    1.)  Many users have requested the ability to fully control the integration of InRoads and the Civil Platform commands within MicroStation. 

    Many of the new Civil Platform commands utilize the emerging ECX Attribute technology within MicroStation, and in order to load this functionality with InRoads, the CFG file needs to be located in the MicroStation config/appl directory where it will be loaded during MicroStation’s startup.  However, many uses have expressed a desire to prevent the “InRoadsAT.CFG” from loading when they run other Bentley layered applications.  The addition of a command line switch now allows for this level of control

    2.)  There is a need to control the loading of multiple InRoads versions within a single version of MicroStation.

    Since the MicroStation V8i SS1 release and including subsequent Select Series releases, there has been an initiative to insure that MicroStation continues to support and run applications no matter what the SS version.  For example, InRoads V8i SS2 can run on MicroStation V8i SS1 or SS2.  Therefore, as the InRoads team continues to develop new versions under this same initiative, it has become necessary to control which version of the Civil Platform files will load on startup.  Therefore, as InRoads begins development of the SS3 version, a command line switch unique to that version will be used to distinguish itself from previous versions. (Note that his ‘command line switch’ methodology can also be applied to previous versions of InRoads V8i as well.)

     

     

    See Also

    Product TechNotes and FAQs

    InRoads Product TechNotes FAQs And Support Video Clips

    External Links

    Bentley Technical Support KnowledgeBase

    Bentley LEARN Server

    Comments or Corrections?

    Bentley's Technical Support Group requests that you please confine any comments you have on this Wiki entry to this "Comments or Corrections?" section. THANK YOU!

     

    • InRoads
    • SELECTservices
    • Application
    • TechNote
    • Menu
    • Share
    • History
    • More
    • Cancel
    • Kevin McDonald Created by Bentley Colleague Kevin McDonald
    • When: Thu, Feb 17 2011 10:26 AM
    • Chris Key Last revision by Bentley Colleague Chris Key
    • When: Tue, Aug 6 2019 3:42 PM
    • Revisions: 31
    • Comments: 3
    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

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