Ab dem Release 6.07 wird das Utility tstDiff.exe ausgeliefert. Es hat als Aufgabe, verschiedene Differenzprotokolle für Aufzeichnungen zu produzieren. Eine Beschreibung der möglichen Aufgaben und Protokolle finden sie weiter unten.
TstDiff [Allgemeine Optionen] <Aufgabe> TstDiff [Allgemeine Optionen] –ex <Aufgabendatei>
TstDiff kennt folgende Optionen:
Die Optionen haben folgende Bedeutung:
| Option | Wirkung |
|---|---|
| -a, -s, -g | Legen die Umgebung fest, in der die Module gesucht werden sollen. Wenn diese Optionen nicht angegeben sind, werden die jeweiligen Einstellungen aus dem aktuellen Logon-Server übernommen. |
| -lo | Bewirkt, dass jegliche Meldungen die TstDiff während der Verarbeitung ausgibt, nicht am Bildschirm erscheinen, sondern in die angegebene Log-Datei geschrieben werden. |
| -o | (für „Output“) Name der Datei, in die TstDiff das Ergebnis des Vergleichs schreiben soll. Da das Ausgabeformat XML ist, sollte der Dateiname mit dem Suffix „.xml“ enden. Diese Option muss immer angegeben werden, entweder allgemein, oder bei den Aufgabenoptionen. |
| -view | Veranlasst, dass das erstellte Dokument direkt angezeigt wird. Sie müssen dafür den Namen eines XML-Stylesheets angeben, welches TstDiff benutzt, um das XML-Dokument formatiert anzuzeigen. Ohne Angabe eines Stylesheets ist auch keine Anzeige möglich. |
Die Kombination von Optionen -lo und -view speichert einen XSL- Verweis in die Datei die mit -o angegeben ist. Wenn kein Logfile angegeben ist, wird die Datei ohne XSL-Verweis gespeichert und ein Browser gestartet. Dieser zeigt das Ergebnis an, welches entsteht, wenn auf die XML-Datei das XSL angewendet wird.
Die Optionen -o und -xsl können für jede Aufgabe einzeln angegeben werden. Werden die Optionen allgemein angegeben, speichert tstDiff die einzelnen Protokolle in eine Datei und es ergibt sich z.B. folgende XML-Datei:
<?xml version="1.0" standalone="yes" ?> <DiffReports> <DiffSgutReport version="1.0">...Schriftgutprotokoll...</DiffSgutReport> <DiffBsarReport version="1.0">...Bausteinaufrufprotokoll...</DiffBsarReport> <DiffBsarIOReport version="1.0">...Schnittstellenprotokoll...</DiffBsarIOReport> </DiffReports>
Wird hingegen bei jeder Aufgabe die -o Option angegeben, erhalten Sie anstelle der obigen XML-Datei drei XML-Dateien mit folgendem Aussehen:
<?xml version="1.0" standalone="yes" ?> <DiffSgutReport version="1.0">...Schriftgutprotokoll...</DiffSgutReport>
<?xml version="1.0" standalone="yes" ?> <DiffBsarReport version="1.0">...Bausteinaufrufprotokoll...</DiffBsarReport>
<?xml version="1.0" standalone="yes" ?> <DiffBsarIOReport version="1.0">...Schnittstellenprotokoll...</DiffBsarIOReport>
Für mehrere oder häufiger wiederkehrende Aufgaben und bei Einbindung ins Konfigurationsmanagement, lohnt sich die Erstellung von Scriptdateien. TstDiff lädt die Aufzeichnung einmal, wenn sie in mehreren Aufgaben gebraucht wird.
sgut aufz=AVL2001011003 aufz=AVL2001011006 "opts=/save:c:\t\sgutdiff.doc /show /print" bsar aufz=AVL2001011003 aufz=AVL2001011006 bsar=AF-AVL-TEST-C..1 "opts=-dm0 -c1" bsario aufz=AVL2001011003 bsar=AF-AVL-TEST-VB..2 "opts=-dm0 -c2"
Die Bedeutung der einzelnen Zeilen entnehmen Sie bitte der Beschreibung der einzelnen Aufgaben.
2001-01-12-17.24.13.584024: Start TstDiff 2001-01-12-17.24.16.519025: Parsing 'sgut aufz=AVL2001011003 aufz=AVL2001011006 „opts=/save:c:\t\sgutdiff.doc /show“'. 2001-01-12-17.24.16.519027: Parsing 'bsar aufz=AVL2001011003 aufz=AVL2001011006 bsar=AF-AVL-TEST-C..1 „opts=-dm0 -c1“'. 2001-01-12-17.24.16.529025: Parsing 'bsar aufz=AVL2001011003 aufz=AVL2001011006 bsar=AF-AVL-TEST-C..2 bsar=AF-AVL-TEST-VB..2'. 2001-01-12-17.24.16.529027: Parsing 'bsario aufz=AVL2001011003 bsar=AF-AVL-TEST-VB..2 „opts=-dm0 -c2“'. 2001-01-12-17.24.16.539024: Executing 'sgut aufz=AVL2001011003 aufz=AVL2001011006 „opts=/save:c:\t\sgutdiff.doc /show“'. 2001-01-12-17.25.04.792024: Done 2001-01-12-17.25.04.792025: Executing 'bsar aufz=AVL2001011003 aufz=AVL2001011006 bsar=AF-AVL-TEST-C..1 „opts=-dm0 -c1“'. 2001-01-12-17.25.04.792026: Changing 'AF-AVL-TEST-C..1' into 'AF-AVL-TEST-C.INITIIEREN.1'. 2001-01-12-17.25.04.792027: Changing 'AF-AVL-TEST-C..1' into 'AF-AVL-TEST-C.INITIIEREN.1'. 2001-01-12-17.25.12.994024: Done 2001-01-12-17.25.12.994025: Executing 'bsar aufz=AVL2001011003 aufz=AVL2001011006 bsar=AF-AVL-TEST-C..2 bsar=AF-AVL-TEST-VB..2'. 2001-01-12-17.25.12.994026: Changing 'AF-AVL-TEST-C..2' into 'AF-AVL-TEST-C.DO-SPEZIAL.2'. 2001-01-12-17.25.12.994027: Changing 'AF-AVL-TEST-VB..2' into 'AF-AVL-TEST-VB.UEBERTRAGEN.2'. 2001-01-12-17.25.13.695024: Done 2001-01-12-17.25.13.695025: Executing 'bsario aufz=AVL2001011003 bsar=AF-AVL-TEST-VB..2 „opts=-dm0 -c2“'. 2001-01-12-17.25.13.695026: Changing 'AF-AVL-TEST-VB..2' into 'AF-AVL-TEST-VB.UEBERTRAGEN.2'. 2001-01-12-17.25.14.176024: Done 2001-01-12-17.25.14.537024: Saving Document as 'c:\t\tstdiff.xml'. 2001-01-12-17.25.14.537025: End TstDiff
Die einzelnen Aufgaben werden über sog. named Arguments bestückt, die folgendermaßen aussehen:
<name>=<value>.
Grundsätzlich wird versucht, für nicht übergebene Argumente einen Defaultwert zu ermitteln. Als Beispiel sei hier das Argument für die Aufzeichnung erwähnt. Wird nur ein Aufzeichnungsname übergeben, bei einer Aufgabe die zwei Aufzeichnungsnamen braucht, so wird dieser Name für die linke und die rechte Aufzeichnung genommen. Beispiel: <Aufgabe> aufz=meine-aufzeichnung ist identisch mit <Aufgabe> aufz=meine-aufzeichnung aufz=meine-aufzeichnung