1. SaphirTRACE-2.1.6.0.exe Driver
2. README2.TXT File Contents

README2.TXT Driver File Contents (SaphirTRACE-2.1.6.0.exe)

SaphirTRACE für Windows 9x/ME, Windows NT 4.0/2000/XP/2003
Copyright (c) 1996-2004 HST High Soft Tech GmbH, All rights reserved.
------------------------------------------------------------------------------
Kurzbeschreibung der Funktionen
SaphirTRACE v2.1(rev.05)/27.08.2004

Inhaltsverzeichnis

1. Menüleiste
2. Gruppe Aufzeichnung
3. Iconleiste
4. Dialog Einstellungen
5. Aufzeichnungstiefe
6. Hinweise


1. Menüleiste

1.1 Datei
Unter diesem Menüpunkt sind Datei-Funktionen zu finden. Grundsätzlich werden
vom SaphirTRACE die Trace-Daten in den Dateien REPORT1.* , REPORT2.* bis
REPORT5.* aufgezeichnet. Die Datei-Namen werden zyklisch wieder verwendet. 

1.1.1 Verbindung ändern
Über diese Menüoption wird ein Konfigurationswizard zum Einstellen der Art der
CDMS Verbindung geöffnet. Diese Option ist nicht während einer Aufzeichnung 
auswählbar.

1.1.2 Öffnen
Diese Funktion ermöglicht das Öffnen von Dateien in den Standardeditor für 
Textdateien. Folgende Dateiformate können geöffnet werden:

   *.TXT
   In diesen Dateien sind die CAPI-Informationen (Anwendung) nach der
   Dekodierung im Textformat abgespeichert.

   *.PRO
   In diesen Dateien sind die Protokoll-Informationen (ISDN/ATM) im Textformat
   abgespeichert.

   *.*
   Alle Dateien werden angezeigt, bei einer Auswahl eines unbekannten
   Dateiformates wird das Öffnen der Datei mit einer Fehlermeldung
   abgebrochen.

1.1.3 Neu dekodieren
Nach Auswahl des Menüpunktes wird der Standarddialog zum Öffnen einer Datei 
geöffnet. Dort kann eine binäre CDMS-Datei ausgewählt werden, welche dann mit
den im SaphirTRACE eingestellten Dekodiereinstellungen dekodiert wird.

1.1.4 Drucken
Diese Funktion ermöglicht das Drucken von Dateien. Folgende Dateiformate
können gedruckt werden:

   *.TXT
   In diesen Dateien sind die CAPI-Informationen (Anwendung) nach der
   Dekodierung im Textformat abgespeichert.

   *.PRO
   In diesen Dateien sind die Protokoll-Informationen (ISDN/ATM) im Textformat
   abgespeichert.

   *.*
   Alle Dateien werden angezeigt, bei einer Auswahl eines unbekannten
   Dateiformates wird das Drucken der Datei mit einer Fehlermeldung
   abgebrochen.

   Nach Auswahl einer druckbaren Datei erscheint der Standard-Druckdialog, in
   dem weitere druckspezifische Einstellungen vorgenommen werden können.

1.1.5 Start von Programm 1
Mit dieser Funktion kann ein Programm gestartet werden, die Einstellung des 
Programmes und Pfades findet in 4.1 statt. Befindet sich im angegebenen Pfad
kein entsprechendes Programm oder ist der Pfad falsch, so ist dieser Menüpunkt
nicht auswählbar. 

1.1.6 Start von Programm 2
(siehe 1.1.5)

1.1.7 Beenden
Durch die Auswahl dieser Funktion kann der SaphirTRACE beendet werden. Es
erscheint eine Sicherheitsabfrage, wenn zu diesem Zeitpunkt eine Aufzeichnung
stattfindet.


1.2 Aufzeichnung
Unter diesem Menüpunkt sind die Aufzeichnungsfunktionen zu finden.

1.2.1 Starten
Nach Auswahl dieser Funktion beginnt eine Aufzeichnung eines Traces. Diese 
Funktion ist nur auswählbar, wenn keine Aufzeichnung eines Traces läuft. Ist
der Dateiname für die Tracedateien schon vorhanden, so erscheint eine Sicher-
heitsabfrage. Neben den beiden Textdateien (*.txt und *.pro) wird auch noch 
eine Datei im binären cdm-Format erzeugt, welche vom SaphirTRACE oder vom 
Saphir CDMS Manager zu einem späteren Zeitpunkt neu ausgewertet werden kann.

1.2.2 Stoppen
Diese Funktion ist nur ausführbar, wenn eine Aufzeichnung eines Traces läuft.
Mit dieser Funktion wird eine Aufzeichnung beendet, vorher erscheint jedoch
eine Sicherheitsabfrage.

1.3 Ansicht
Unter diesem Menüpunkt sind die Ansichtsfunktionen zu finden.

1.3.1 Statusleiste anzeigen
Über diese Menüoption kann die Anzeige der Programmstatusleiste gesteuert 
werden.

1.4 Optionen
Unter diesem Menüpunkt können die Optionen für den SaphirTRACE eingestellt
werden.

1.4.1 Sprache
Bei Auswahl dieser Funktion erscheint ein Auswahlmenü, mit dem dynamisch die
Sprache der Bildschirmausgaben des SaphirTRACE gewechselt werden kann. Zur 
Auswahl stehen die deutsche und englische Sprache. Die gerade aktive Sprache
ist nicht auswählbar.

1.4.2 Einstellungen
Bei Aufruf dieser Menüoption erscheint ein mehrseitiger Registertaschendialog
für die weitergehende Konfiguration des SaphirTRACE (siehe 4).

1.4.3 Einstellungen sichern
Sofortiges Sichern der aktuellen Einstellungen in die Datei Trace32.ini.

1.4.4 Automatisch sichern
Automatisches Sichern der aktuellen Einstellungen nach einer Änderung in die
Datei Trace32.ini.


1.5 Info
Anzeigen der Maske "Info" des SaphirTRACE. Diese beinhaltet die Versionsnummer
und die Internetadresse von HST High Soft Tech GmbH.


2. Gruppe Aufzeichnung
Die Gruppe Aufzeichnung umfaßt alle Einstellungen, die für eine Aufzeichnung
vorgenommen werden können. Elemente können nicht während einer Aufzeichnung
verändert werden. Die Einstellungen gelten sowohl für die Aufzeichnung und
gleichzeitige Dekodierung, als auch für eine Neudekodierung (siehe Abschn. 
1.1.3).

2.1 Protokoll
Abhängig von dem Typ des Adapters gibt es eine ISDN- oder ATM-Box, die
Einstellungen innerhalb der Gruppe sind jedoch identisch. In der Gruppe wird
die Einstellung vorgenommen, in welcher Tiefe die Protokoll-Informationen 
aufgezeichnet werden sollen. Dabei stehen jeweils die Aufzeichnungstiefen
"hoch", "mittel", "niedrig" und "nicht" zur Verfügung.

2.2 Anwendung
In dieser Gruppe wird die Einstellung vorgenommen, in welcher Tiefe die CAPI-
Informationen aufgezeichnet werden sollen. Dabei stehen jeweils die
Aufzeichnungstiefen "hoch", "mittel", "niedrig" und "nicht" zur Verfügung.


3. Iconleiste

Die Symbole der Iconleiste repräsentieren von "links nach rechts" folgende
Funktionen:

3.1 Datei\Öffnen (siehe Abschn. 1.1.2)

3.2 Datei\Drucken (siehe Abschn. 1.1.4)

3.3 Aufzeichnung\Starten (siehe Abschn. 1.2.1 und Abschn. 2)

3.4 Aufzeichnung\Stoppen (siehe Abschn. 1.2.2)


4. Dialog Einstellungen
Unter 1.3.2 können Einstellungen des SaphirTRACE vorgenommen werden.

4.1 Pfade
Einstellen von verwendeten Dateinamen und Pfaden.

4.1.1 Programm 1
Einstellen des Pfades und Programmnamens welches unter 1.1.5 gestartet werden
soll.

4.1.2 Programm 2
Einstellen des Pfades und Programmnamens welches unter 1.1.6 gestartet werden 
soll.

4.1.3 Verzeichnis für Tracedateien
Einstellen des Verzeichnisses in welchem die Tracedateien abgespeichert werden
sollen.


4.2 Tracedatei
Konfiguration von Einstellungen zur Speicherung von Tracedateien.

4.2.1 Tracedaten direkt auf Festplatte schreiben
Bei Aktivierung dieser Option werden die aufzuzeichnenden Tracedaten direkt auf
die Festplatte gespeichert und der Festplattencache wird umgegangen. Ist diese 
Option nicht aktiviert werden die Daten normal unter Verwendung des Caches auf
die Festplatte geschrieben.

4.2.2 Tracedateien ungefragt überschreiben
Bei Aktivierung dieser Option erscheint keine Sicherabfrage mehr, ob durch
zyklische Dateinamensgenerierung alte Tracedateien überschrieben werden sollen.
Nach der Installation ist diese Option nicht aktiviert.

4.2.3 Tracedatei nach Aufz. öffnen (Protkoll)
Bei Aktivierung dieser Funktion wird nach Beendigung des Tracevorgangs automatisch
die gerade geschriebene Protokoll-Aufzeichnungsdatei geöffnet.

4.2.4 Tracedatei nach Aufz. öffnen (CAPI)
Bei Aktivierung dieser Funktion wird nach Beendigung des Tracevorgangs automatisch
die gerade geschriebene CAPI-Aufzeichnungsdatei geöffnet.


4.3 Sonstiges
Konfiguration von sonstigen Parametern des SaphirTRACE.

4.3.1 Startlogo anzeigen
Anzeige des Startlogos bei Programmstart oder sofortiger Start des SaphirTRACE
ohne Startlogo.

4.3.2 Programm an Mauszeiger anordnen
Beim Programmstart wird die linke obere Fensterposition am Mauszeiger ange-
ordnet.



5. Aufzeichnungstiefe

Beschreibung der Aufzeichnungstiefe bei ISDN/X.31-Adaptern

   - ISDN nicht:
     keine Aufzeichnung des D-Kanals oder der B-Känale

   - ISDN niedrig:
     Aufzeichnung des D-Kanals, Dekodierung der Protokolle Q.921, Q.931 - DSS1,
     Q.931 - 1TR6 und ISO 8208 / X.31 / X.25PL im Übersichtmodus und des 
     S0-Line Synchronisationszustandes.

   - ISDN mittel:
     Aufzeichnung des D-Kanals und der B-Kanäle, Dekodierung der TimeStamps im
     Millisekundenbereich, der Protokolle Q.921, V.120Async, X.75SLP, 
     Q.931 - DSS1, Q.931 - 1TR6 und ISO 8208 / X.31 / X.25PL im Vollmodus ohne
     Bitanzeige und des S0-Line Synchronisationszustandes.

   - ISDN hoch:
     Aufzeichnung des D-Kanals und der B-Kanäle, Dekodierung der TimeStamps im
     Mikrosekundenbereich, der Protokolle Q.921, V.120Async, X.75SLP, PPP, 
     Q.931 - DSS1, Q.931 - 1TR6 und ISO 8208 / X.31 / X.25PL in der maximalen 
     Anzeige, des S0-Line Synchronisationszustandes und Anzeige von T.30 Fax.

Beschreibung der Aufzeichnungstiefe bei ATM-Adaptern

   - ATM nicht
     keine Aufzeichnung von Protokollinformationen
     
   - ATM niedrig  
     Aufzeichnung des Signalisierungskanals, Dekodierung der Protokolle Q.2110, 
     Q.2931 und ISO 8208 / X.31 / X.25PL im Übersichtmodus und des 
     Synchronisationszustandes.
   
   - ATM mittel
     Aufzeichnung aller Kanäle, Dekodierung der TimeStamps im Millisekunden-
     bereich, der Protokolle Q.2110, Q.2931, V.120Async, X.75SLP und 
     ISO 8208 / X.31 / X.25PL im Vollmodus ohne Bitanzeige und des 
     Synchronisationszustandes.
   
   - ATM hoch
     Aufzeichnung aller Kanäle, Dekodierung der TimeStamps im Mikrosekunden-
     bereich, der Protokolle Q.2110, Q.2931, V.120Async, X.75SLP, PPP und
     ISO 8208 / X.31 / X.25PL in der maximalen Anzeige und des 
     Synchronisationszustandes. 

Beschreibung der Aufzeichnungstiefe bei Anwendung

   - Anwendung nicht:
     Keine Aufzeichnung von CAPI-Messages.

   - Anwendung niedrig:
     Aufzeichnung der CAPI-Messages und Dekodierung der CAPI-Messages im
     Übersichtsmodus.

   - Anwendung mittel:
     Aufzeichnung der CAPI-Messages und der CAPI-Messages-Layer 3 und
     Dekodierung im Vollmodus.

   - Anwendung hoch:
     Aufzeichnung der CAPI-Messages, der CAPI-Messages-Layer 3 und CAPI-Data-
     Layer 3 und Dekodierung im Vollmodus mit Datenmodus und SFF-Format.


6. Hinweise

Der SaphirTRACE überprüft wieviel freier Speicherplatz auf der aktuellen 
Partition zur Verfügung steht. Es wird eine Warnung ausgegeben, wenn weniger
als 5 MB Speicherplatz frei ist. Dann ist nur noch eine minimale Aufzeichnungs-
dauer möglich.