Bentley Communities
Bentley Communities
  • Site
  • User
  • Site
  • Search
  • User
MicroStation
  • Product Communities
MicroStation
MicroStation Wiki Managing Exception Logs
    • Sign In

    • -MicroStation Wiki
      • +Learning Tips
      • -MicroStation
        • +3D Printing - MicroStation
        • +Animation - MicroStation
        • +Archive / Backup - MicroStation
        • +Base Geometry - MicroStation
        • +Batch Processing - MicroStation
        • +CONNECT Advisor - MicroStation
        • CONNECT Integration - MicroStation
        • +CONNECTION Client
        • +Cells - MicroStation
        • +Change Tracking - MicroStation
        • +Configuration - MicroStation
        • +Coordinate Systems - MicroStation
        • +Curves - MicroStation
        • +Custom Linestyles - MicroStation
        • +DGN - MicroStation
        • +DWG - MicroStation
        • +Database - MicroStation
        • +Detailing Symbols - MicroStation
        • +Dimensions - MicroStation
        • +Documentation & Help - MicroStation
        • +Drawing Aids - MicroStation
        • -Exception - MicroStation
          • Create a Dump File with Task Manager
          • ADPlus with SLS option
          • Crash running Print Organizer with Signcad installed
          • Download and Install Windows Debugging Tools
          • Exception Log 101
          • Generate Type 7 Minidump files
          • Managing Exception Logs
          • MicroStation Exception Log Primer
          • MicroStation crashes when loading Tool Boxes dialog
          • MicroStation crashing on start up
          • Microsoft DebugDiag - Quick Guide for MicroStation crash issues
          • Setting up Dr. Watson for MicroStation J
          • Troubleshooting MicroStation Processor Exception Errors in MicroStation J
          • Unable to Load/Create CmdFrame
          • Full memory dumps using Windows Error Reporting (WER)
          • Generate a hang dump with ProcDump
          • Generate crash logs with ADPlus
          • Generate Type 7 Minidump with Page Heap
          • How to collect Event logs
          • How to generate Dependency Walker log files
          • How to generate ProcMon logs
          • MicroStation Connect crashes during startup (Dell Backup and Recovery)
          • MicroStation Connect crashes immediately when started (IBM Trusteer Rapport)
          • MicroStation Connect crashes when started (Sophos)
          • MicroStation Connect crashes when started (Trend Micro)
          • MicroStation Connect does not start (SentinelOne)
          • MicroStation crashes on start up (restore defaults)
          • MicroStation crashes on start up (UPF related)
          • MicroStation crashes on startup (Legacy LicenseClient)
          • MicroStation exits when attaching Bing Map
          • MicroStation J does not exit
          • MicroStation not working
          • Open Light Manger and select Solar, crashes MicroStation Connect
          • Other Crash Dumps
          • Performance Issue when starting MicroStation
          • SQLite error when starting MicroStation
          • Startup Logs
          • VBA Error - Class not registered
        • +FAQ - MicroStation
        • +Feature Based Solids Modeling - MicroStation
        • +File Access - MicroStation
        • +GUI - MicroStation
        • +General - MicroStation
        • +Graphics Display - MicroStation
        • +Groups - MicroStation
        • +Hardware / Input Devices - MicroStation
        • +Import/Export - MicroStation
        • +Installation - MicroStation
        • +Interchange - MicroStation
        • +Interference - MicroStation
        • +Internationalization - MicroStation
        • +Levels - MicroStation
        • +Licensing - MicroStation
        • +Manipulation - MicroStation
        • +Markup / Redline - MicroStation
        • +Measure - MicroStation
        • +Mesh - MicroStation
        • +Models - MicroStation
        • +Multi-Lines - MicroStation
        • +OLE - MicroStation
        • +Other - MicroStation
        • +Parametrics - MicroStation
        • +Patterning - MicroStation
        • +Point Cloud - MicroStation
        • +Printing - MicroStation
        • +Programming - MicroStation
        • +Project Navigation - MicroStation
        • +Properties - MicroStation
        • +RSS Feeds - MicroStation
        • +Reference - MicroStation
        • +Security - MicroStation
        • +Selection - MicroStation
        • +Settings - MicroStation
        • +Sheet Composition - MicroStation
        • +Solids - MicroStation
        • +Standards - MicroStation
        • +Surfaces - MicroStation
        • +Tables - MicroStation
        • +Text - MicroStation
        • +UI Customization - MicroStation
        • +Units - MicroStation
        • +View - MicroStation
        • +Visualization - MicroStation
        • Welcome Page - MicroStation
        • +Accreditation - MicroStation
        • +i.Models - MicroStation
        • +ProjectWise Integration
        • +Raster - MicroStation
    • +Administration Wiki
    • +Annotations Wiki
    • +Bentley View Wiki
    • +MicroStation PowerDraft
    • +Programming Wiki
    • +Visualization Wiki

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

    Managing Exception Logs

      Product: MicroStation
      Version: V8 2004 Ed. (08.05.01.xx and above)
      Environment: N\A
      Area: Exception
      Subarea: N\A

    Overview

    When MicroStation experiences a Process Exception or an Access Violation, the information generated by the exception or violation can be very helpful in diagnosing the source of the issue, often minimizing the time it takes to resolve it.

    As an exception in MicroStation occurs, its details (e.g. processes and other programs that are running at the time of the exception, memory contents, etc.) are appended in the Exception.log file in the folder to which MS_TMP points. Because each exception can generate approximately 240KB of information*, the size of Exception.log could grow rather substantially over time. A Visual Basic script file manageExceptionLogs.vbs is included in MicroStation v8.5.1 and above to help manage the exception logs, simplifying troubleshooting efforts. The script can be customized by an administrator and can be optionally set up to notify individuals when an exception occurs. The MicroStation configuration variable MS_ProcessExceptionLog identifies which VB script to use and where the exception logs should be written to. For example, the default is:

    MS_ProcessExceptionLog = 0 "$(windir)\system32\wscript.exe" "$(MSDIR)manageExceptionLogs.vbs"

    This statement is all one line. It identifies that the Microsoft Windows program wscript.exe should run manage ExceptionLogs.vbs in a hidden window and that any resulting exception.log file will be written to MS_TMP.

    MS_ProcessExceptionLog is examined and parsed for both a "window display control" (see SW_xxxx constants in the Microsoft documentation of "ShowWindow") value and an executable with optional arguments. When run, the script performs the following operations:

    1. Delete $(MS_TMP)ExceptionHistory-20

      A maximum number of logs can be created. The maximum number is defined by "g_maxLogsToKeep" in the script; 20 is the default.

      Shift any existing sub directories to the next higher value. For example move $(MS_TMP)ExceptionHistory-19 to $(MS_TMP)ExceptionHistory-20, then move 18 to 19, 17 to 18, ... 1 to 2.

    2. The exception log that is created in ExceptionHistory-1 will be moved to ExceptionHistory-2, allowing a new exception to be created in ExceptionHistory-1.

    3. Create $(MS_TMP)ExceptionHistory-1\
    4. Move the most recently created Exception.log and MiniDump.dmp into $(MS_TMP)ExceptionHistory-1\
    5. An optional E-mail can be sent to the CAD Manager identifying the name of the computer where the exception occurred. This can be particularly useful for initial deployment of MicroStation. Script variables relating to this ability include:

      Const g_emailHostName = "yourservername" = Exchange Server or SMTP server's DNS name or IP address (i.e. mailhost.xyzzy.com)

      Const g_emailCADAdministrator= "some.name@xyzzy.com" or Const g_emailCADAdministrator= "some.name" = Address of the person to notify of exceptions. More than one address can be included simply by separating the names with commas (i.e. "John.Smith, Jane.Doe") The E-mail domain does not need to be included in this section.

      Const g_emailUserDomain = "@xyzzy.com" = An optional suffix (or anything else) to append to the sender's address. Example '@bentley.com'

    *A snapshot of MicroStation's process memory is written to the companion binary file MiniDump.dmp, which is rewritten with every exception. The size of this file will vary based on what the Windows system environment variable (note: NOT a configuration variable) MS_MiniDumpType is set to and the amount of virtual memory occupied by MicroStation at the time of the fault. If MS_MiniDumpType is set to 4 (the default), MiniDump.dmp could be on the order of 10s of KB. If MS_MiniDumpType is set to 7, much more information is collected and MiniDump.dmp could be on the order of many 10s of MB to 100's of MB.

    NOTE: If you run anti-virus software (e.g. Norton AntiVirus), you may be alerted that a "suspected virus" may be accessing the system when MicroStation creates the exception logs through the VBScript. However, workarounds may exist. For example, information for Norton's AntiVirus Script Blocking is described here. Please check with your system/computer administrator before disabling this setting.

    Supplemental information regarding Dr. Watson log files can be found in the Microsoft KnowledgeBase articles "Using Dr. Watson" and "Overview of Dr. Watson". This is useful to anyone who encounters a Dr. Watson log or would like a better understanding of what is in one.

    See also

    Other language sources

      Original Author: Bentley Technical Support Group
    • exception
    • MicroStation
    • Share
    • History
    • More
    • Cancel
    • Dan Koval Created by Bentley Colleague Dan Koval
    • When: Fri, Sep 6 2013 1:31 PM
    • Leonard Jones Last revision by Bentley Colleague Leonard Jones
    • When: Wed, Dec 27 2017 4:48 AM
    • 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

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