| Bezieht sich auf | |||
| Produkt(e): | MicroStation | ||
| Version(en): | alle MicroStation basierenden Produkte | ||
| Umbegung: | N\A | ||
| Produktbereich: | Konfiguration | ||
| Produktunterbereich: | Allgemein | ||
Mit dem Befehlszeilenparameter -debug wird die Datei msdebug.txt in einem "Temp"-Ordner erstellt. Der Speicherort des "Temp"-Ordners variiert je nach Version der Anwendung und von Windows.
Bei der CONNECT Edition ist der Standardspeicherort der benutzereigene "Temp"-Ordner, der durch die Variable _USTN_LocalUserTempPath definiert ist:
C:\\Users\%username%\AppData\Local\Temp\Bentley\MicroStation\10.0.*
Einmal erstellt, kann eine msdebug.txt-Datei in Bentley Configuration Explorer für die Überprüfung eingelsen weden, dies bietet eine benutzerfreundlichere Möglichkeit, den Inhalt zu lesen.
Bentley Configuration Explorer ist ein leistungsstarkes Analyse- und Bearbeitungswerkzeug für die Konfigurationsverwaltung und -wartung.
msdebug.txt erstellen:
Für einen schnellen einmaligen Einsatz
Drücken Sie: Windows-Taste + R
Geben Sie im Dialogfeld Ausführen ein (oder fügen Sie ein):
"C:\Programme\Bentley\MicroStation CONNECT Edition\MicroStation\microstation.exe" -debug
Die Datei wird unter C:\Users\%username%\AppData\Local\Temp\Bentley\MicroStation\10.0.0\msdebug.txt gespeichert und in Notepad (der Anwendung mit der Dateierweiterung .txt) geöffnet:
oder
Öffnen Sie eine Eingabeaufforderung (drücken Sie die Windows-Taste und geben Sie "cmd" ein).
Geben Sie in der Eingabeaufforderung ein (oder fügen Sie ein):
"C:\Programme\Bentley\MicroStation CONNECT Edition\MicroStation\microstation.exe" -debug
Die Datei wird unter C:\Benutzer\<Benutzername>\AppData\Local\Temp\Bentley\MicroStation\10.0.0\msdebug.txt gespeichert und in Notepad (der Anwendung mit der Dateierweiterung .txt) geöffnet:
Zur wiederholten Verwendung ändern Sie das MicroStation-Verknüpfungssymbol:
Navigieren Sie zu der Verknüpfung (bei Windows 10 ist dies "C:\ProgrammDaten\Microsoft\Windows\Startmenü\Programme\MicroStation CONNECT Edition\MicroStation CONNECT Edition\MicroStation CONNECT Edition.lnk") und klicken Sie mit der rechten Maustaste auf > Eigenschaften.
Auf der Registerkarte Verknüpfung: Fügen Sie <space>-debug am Ende der MicroStation-Verknüpfung hinzu (im Feld Ziel:)
Auf der Registerkarte Allgemein: Benennen Sie die Verknüpfung um
Für andere Anwendungen
Für Anwendungen, die auf MicroStation basieren, sind die Schritte ähnlich, die verwendeten Pfade variieren je nach Anwendung, z.B. für AECOsim Building Designer lautet der Debug-Befehl:
"C:\Programmdateien\Bentley\AECOsim CONNECT Edition\AECOsimBuildingDesigner\AECOsimBuildingDesigner.exe" -debug
Debug Schalter
Der Inhalt von msdebug.txt kann durch Hinzufügen eines Schalters am Ende des Debug-Befehls gesteuert werden, wenn er in allen drei oben genannten Situationen verwendet wird.
-z.B.:
"C:\Programmdateien\Bentley\MicroStation CONNECT Edition\MicroStation\microstation.exe" -debug=n
wobei 'n' ein Wert von 1 bis 5 ist, mit den folgenden Ergebnissen:
| Wert von n | Art des Berichts |
|---|---|
| 1 | Kurzer Bericht, der den aktuellen String-Wert jeder Konfigurationsvariablen anzeigt, während sie verarbeitet wird. |
| 2 | Darüber hinaus wird die aktuelle Übersetzung jeder Konfigurationsvariablen angezeigt, während sie verarbeitet wird. |
| 3 | Darüber hinaus werden Informationen über bedingte Unterbrechungen angezeigt, indem die Zeilennummer bei der Verarbeitung jeder if-Präprozessoranweisung angezeigt wird. |
| 4 | Außerdem werden die endgültigen Übersetzungen aller Konfigurationsvariablen am Ende des Berichts gedruckt. Dies ist die Standardeinstellung. |
| 5 | Darüber hinaus werden die endgültigen Werte aller Konfigurationsvariablen auf jeder Ebene (System, Anwendung, Organisation, WorkSpace, WorkSet, Rolle, Benutzer) angezeigt. |
Msdebug.txt Inhalte
Die Datei MSDebug.txt besteht aus zwei Abschnitten. Der erste Abschnitt enthält eine Liste aller verarbeiteten Konfigurationsdateien und der in jeder Datei gesetzten Konfigurationsvariablen. Jede verarbeitete Konfigurationsdatei hat einen Start- und einen Endpunkt, die wie folgt gekennzeichnet sind:
Verarbeitung der Makrodatei [C:\Bentley\Program\MicroStation\config\mslocal.cfg]
.
.
.
Ende der Makrodatei [C:\Bentley\Program\MicroStation\config\mslocal.cfg]
Zwischen diesen beiden Zeilen befinden sich alle Variablen und ihre Einstellungen, die aus dieser speziellen Konfigurationsdatei geladen werden:
Beispiele:
Processing macro file [d:\Bentley\Program\MicroStation\config\system\mslocal.cfg]
(system): MS_SPELLINGLANGUAGE=AmericanEnglish [AmericanEnglish]
(system): MS_HELPLOAD_LANGUAGE=en [en]
End of macro file [d:\Bentley\Program\MicroStation\config\system\mslocal.cfg]
Processing macro file [d:\Bentley\Program\MicroStation\config\appl\qvisgl.cfg]
(appl): MS_GRAPHICSACCELERATOR=qvisgl [qvisgl]
End of macro file [d:\BentleyProgram\MicroStation\config\appl\qvisgl.cfg]
Außerdem wird angegeben, auf welcher Ebene die Variable gesetzt wurde (z. B. System, Appl, Benutzer, Site, Projekt oder vordefiniert).
Der letzte Abschnitt der Datei MSDebug.txt ist die Zusammenfassung der Konfigurationsvariablen. Hier finden Sie die folgenden Angaben:
Eine Auflistung aller Konfigurationsvariablen
Auf welcher Ebene jede Variable gesetzt wurde
Der vollständige Pfad zum Speicherort der Dateien
ob die Variable gesperrt oder nicht gesperrt ist
Die msdebug-Datei kann Ihnen bei der Fehlersuche helfen, z. B. bei Prozessorausnahmefehlern, indem sie Ihnen hilft, den Speicherort bestimmter Dateien zu ermitteln. Die Schritte für dieses Verfahren sind unten aufgeführt:
- Erstellen Sie die Datei msdebug.txt
- Öffnen Sie sie in einem ASCII-Texteditor (wie NotePad).
- Suchen Sie nach den folgenden Variablen:
MS_USERPREF (hier erfahren Sie, wo sich Ihre Benutzereinstellungsdatei befindet)
MS_INITAPPS (hier erfahren Sie, ob andere Programme während des Starts gestartet werden)
MS_SYMBRSRC (hier finden Sie den Speicherort aller MicroStation-Ressourcendateien)
MS_DGNAPPS (zeigt an, welche anderen Programme mit MicroStation gestartet werden)
MS_DGNMACROS (hier wird angegeben, welche Makros mit MicroStation gestartet werden)
_USTN_UIPATH (hier wird der Speicherort aller *.m0*-Dateien angegeben)
Achten Sie darauf, dass Sie nach allen Instanzen der Variablen suchen.
Informationen für Vor-CONNECT-Versionen
Für MicroStation V8 XM Edition und höher wird die Datei in dem Verzeichnis erstellt, das durch die MicroStation-Konfigurationsvariable MS_TMP festgelegt ist.
| MicroStation V8i: | C:\Dokumente und Einstellungen\Benutzername\Lokale Einstellungen\Temp | |
| MicroStation V8 XM Edition : | C:\Dokumente und Einstellungen\Benutzername\Lokale Einstellungen\Temp |
Bei V8 2004 und früheren Versionen wird sie in dem Ordner erstellt, auf den "Start in:" eingestellt ist (im Dialogfeld Eigenschaften des MicroStation-Programmsymbols), was normalerweise derselbe Ordner ist, in dem sich die Datei ustation.exe befindet.
| MicroStation V8.0 through V8 2004 Edition: | C:\Programmdateien\Bentley\Programme\MicroStation | |
| MicroStation/J: | C:\Bentley\Program\Microstation | |
| MicroStation 95/SE: | C:\win32app\ustation |
NOTES:
- Diese Speicherorte gelten für Windows XP. Für Windows Vista, Windows 7 und Windows 8.x beziehen Sie sich auf den durch die MicroStation-Konfigurationsvariable MS_TMP angegebenen Speicherort.
- Der Standardpfad ist üblicherweise %temp%\Bentley\.... oder $(MS_TMP)msdebug.txt, der (über _USTN_LocalUserTempPath) auf die Umgebung %temp% + die versionsspezifischen Zusätze verweist. Bei Standard-Windows-Installationen ist %temp% standardmäßig c:\Users\%username%\AppData\Local\Temp, also wäre der gesamte Pfad C:\Users\%username%\AppData\Local\Temp\Bentley\MicroStation\8.21.3\msdebug.txt.
- Um zu vermeiden, dass Sie nach der resultierenden msdebug.txt suchen müssen, verwenden Sie den Befehlszeilenparameter -debugfileopen (eingeführt in MicroStation V8i SELECTseries 3) anstelle von -debug (Erläuterungen zu Letzterem siehe unten).
msdebug.txt erstellen:
1. Von einer DOS-Eingabeaufforderung in einem Befehlsshell-Fenster
Wechseln Sie an einer Eingabeaufforderung in das Verzeichnis, in dem sich ustation.exe befindet, und geben Sie den folgenden Befehl ein: ustation.exe -debug
Beispiele:
Für MicroStation V8i: C:\Programmdateien\Bentley\MicroStation\ustation.exe -debug*
Für MicroStation V8 XM: C:\Programmdateien\Bentley\MicroStation\ustation.exe -debug*
Für MicroStation V8: c:\Programmdateien\Bentley\Programme\Microstation\ustation.exe -debug
Für MicroStation/J: c:\bentley\programm\microstation\ustation.exe -debug
Für MicroStation 95\SE: c:\win32app\ustation\ustation.exe -debug
2. Über das Verknüpfungssymbol von MicroStation
Hängen Sie <space>-debug an das Ende der MicroStation-Verknüpfung an (im Feld Ziel:).
Beispiele:
Für MicroStation V8i: C:\Programmdateien\Bentley\MicroStation\ustation.exe -debug*
Für MicroStation V8: Ziel: c:\Programmdateien\Bentley\Programm\Microstation\ustation.exe -debug*
Für MicroStation/J: Ziel: c:\bentley\programm\microstation\ustation.exe -debug
Für MicroStation 95\SE: Ziel: c:\win32app\ustation\ustation.exe -debug
Speichern Sie die Änderungen und doppelklicken Sie dann auf das Symbol.
HINWEIS: Denken Sie daran, diese Änderung nach dem Erstellen der Datei MSDebug.txt zu entfernen.
3. Von Windows "Ausführen"
Wählen Sie Start > Ausführen
Geben Sie den Pfad zur Datei ustation.exe ein.
HINWEIS: Wenn der Pfad Leerzeichen enthält, müssen Sie den Pfad in Anführungszeichen setzen.
Beispiele:
Für MicroStation V8i: C:\Programmdateien\Bentley\MicroStation\ustation.exe -debug*
Für MicroStation V8: "c:\Programmdateien\Bentley\Programm\Microstation\ustation.exe" -debug*
Für MicroStation/J: c:\Bentley\Programme\MicroStation\Ustation.exe -debug
Für MicroStation 95\SE: c:\win32app\ustation\ustation.exe -debug
Klicken Sie auf OK.
*HINWEIS: Der Speicherort für ustation.exe für MicroStation V8i befindet sich unter:
C:\Programme (x86)\Bentley\Programme\MicroStation\ auf 64-Bit-Betriebssystemen wie Vista und Windows 7.
Sie sollten ein DOS-Fenster erhalten, in dem steht: "Debugging output saved to [msdebug.txt]".
Drücken Sie die Eingabetaste
Suchen Sie die Datei msdebug.txt in dem entsprechenden Verzeichnis.
Sehen Sie auch
Wie Sie eine msdebug-Datei in der MicroStation CONNECT Edition erstellen, erfahren Sie unter:
https://communities.bentley.com/products/microstation/w/microstation__wiki/23926.export-configuration-variable-values-to-a-text-file
How to setup MicroStation logging with ProjectWise Explorer Integration