| 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:
- 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) .
- Open a command window and navigate to the "...\ProjectWise\bin" directory.
- Enter the command:
- dmsconv.exe -d ODBCDataSourceName -u DatabaseUserName.Password -appfile "PathToThisFile" (This operation should be done by ProjectWise administrator).
- 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
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
InRoads Product TechNotes FAQs And Support Video Clips
External Links
Bentley Technical Support KnowledgeBase
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!