Die TstDiff-Aufgabe RATING bewertet in drei Schritten ein Differenzprotokoll auf Basis der Definitionen in den EDB-Tabellen DCAW, DDST und DPST. Zwischen den einzelnen Schritten gibt es die Möglichkeit für die Einbindung eigener Filter- und Bewertungsverfahren. Die Umsetzung basiert auf dem Konzept „TstDiff: Unterschiede bewerten“. Hiermit kann man: Die Differenzen bewerten und einen allgemeinen Protokollstatus ermitteln. Eine erneute Bewertung durchführen. Die durch TstEdge oder TstDiff erstellten Differenzprotokolle sind während des Vergleichs schon bewertet worden. Nachdem Sie manuelle Änderungen an den Bewertungen vorgenommen haben, können Sie einzelne Schritte erneut durchführen, um so einen Protokollstatus „OK“ zu bekommen.
tstDiff [tstdiff-Optionen] RATING < ALL | CW | DS | PS > file=<Datei> diffxsl=<Datei> protxsl=<Datei> diffname=<Diffname> category=<Kategorie> opts=<Optionen>
Die Angabe ALL bewirkt, dass alle drei Bewertungsschritte durchgeführt werden. Die Schritte können auch einzeln durchgeführt werden:
Die Bewertung kennt folgende Argumente:
| file | Mit File=<Datei> geben Sie den Namen der Protokolldatei an, die bewertet werden soll. |
| diffxsl | Mit diffxsl=<Datei> benennen Sie ein Stylesheet (XSL), welches auf das Protokoll angewendet wird, bevor der Status der Differenzen ermittelt wird. |
| protxsl | Mit protxsl=<Datei> benennen Sie ein Stylesheet (XSL), welches auf das Protokoll angewendet wird, bevor die Protokollstatus ermittelt wird. |
| diffname | Mit diffname=<Diffname> können Sie Diffnamen angeben, sodass nur Differenzen mit diesen Diffnamen berücksichtigt werden. Dieses Argument darf beliebig oft verwendet werden. Alternativ kann für mehrere Diffnamen auch diffname=<Diffname1>;<Diffname2> . . . <DiffnameN> geschrieben werden. |
| category | Mit category=<Kategorie> können Sie Kategorien angeben, sodass nur Differenzen dieser Kategorien berücksichtigt werden. Dieses Argument darf beliebig oft verwendet werden. Alternativ kann für mehrere Kategorien auch category=<Kategorie1>;<Kategorie2> . . . <KategorieN> geschrieben werden. |
| opts | Mit Opts=<Optionen> können Sie aufgabenbezogene Optionen angeben, sowie bestimmte allgemeine Optionen übersteuern. |
Die Bewertung kennt folgende Optionen:
| -o | Mit der Option -o <Protokoll-Datei> (für „Output“) können Sie bestimmen, ob das Ergebnis dieses Vergleichs in der allgemeinen Outputdatei oder in eine für dieses Kommando eigene Outputdatei geschrieben werden soll. |
| -v | Mit der Option -v <XSL> (für „Vorschau“) können Sie veranlassen, dass das erstellte Dokument direkt angezeigt wird. |
1. Bestimmen der Differenzen
Beim Ermitteln der Differenzen wird pro Differenzsatz ein „DiffName“ gesetzt.
<Type DiffName="BsarType"> <Left>ASTR</Left> <Right>ASTR</Right> </Type>
2. Bestimmen der Kategorie und Gewichtung
Beim Ermitteln der Kategorie und Gewichtung werden nur Differenzen mit einem DiffNameberücksichtigt. Wenn für diesen DiffName ein Eintrag in der DCAW gefunden wird, werden die Kategorie und Gewichtung gesetzt. Das Attribut „IsDifferent“ besagt, ob der DiffKind nicht „Equal“ war.
<Type DiffName="BsarType" IsDifferent="no" Category="Definition" Weight="Info"> <Left>ASTR</Left> <Right>ASTR</Right> </Type>
3. Bestimmen des Status einer Differenz
Beim Ermitteln des Status einer Differenz wird vorher ein ggf. angegebenes Stylesheet angewendet und anschließend alle Differenzen die einen DiffName, Kategorie und Gewichtung haben, berücksichtigt. Fehlen die Kategorie und Gewichtung, so wird Schritt 2 für diese Differenz noch einmal durchgeführt. Wird ein Eintrag in der DDST gefunden, dann wird der „Status“ gesetzt.
<Type DiffName="BsarType" IsDifferent="no" Category="Definition" Weight="Info" Status="Accept"> <Left>ASTR</Left> <Right>ASTR</Right> </Type>
4. Bestimmen des Protokollstatus
Beim Ermitteln des Status eines Protokolls wird vorher ein ggf. angegebenes Stylesheet angewendet und anschließend für jeden Eintrag in der DPST gezählt, wieviele Differenzen es gibt die den Angaben entsprechen. Die Differenzen ohne DiffName, Kategorie, Gewichtung und Status werden nicht mitgezählt und haben keinen Einfluss auf den Protokollstatus. Am Ende wird das Attribut „ProtocolStatus“ gesetzt.
<DiffBsarReport version=„1.0“ ProtocolStatus=„NotOK“>
</DiffBsarReport>
5. Sonstige Bemerkungen
Das Protokoll wird gespeichert in einer Datei mit dem Namen, der mit der Option -o spezifiziert wird.
Eine vorhandene Bewertung wird überschrieben, wenn die Bewertung erneut durchgeführt wird.
Namen der Differenzen
| DiffName | Beschreibung |
|---|---|
| BsarType | Bausteintyp des Moduls |
| BsarStat | Zustand den das Modul zurückgegeben hat |
| TimeTotal | Die Gesamtverweildauer des Bausteinaufrufs |
| TimeFunc | Die Verweildauer des Bausteinaufrufs |
| CalleeCount | Die Anzahl gerufene Module |
| CallName | Name des gerufenen Moduls |
| CallEvnt | Ausgelöste Operation beim gerufenen Modul |
| CndOpCount | Anzahl Conditionoperationen |
| CndSev | Severity der Condition |
| CndTitle | Titel der Condition |
| CndArg | Argument der Condition |
| CndAssoc | Association der Condition |
| OopsCount | Anzahl Oopse |
| OopsMsg | Text der Oopsmeldung |
| ParmObjt | Objektstruktur des Parameterobjektes |
| ParmClass | Klasse des Parameterobjektes |
| ParmDstr | Datenstruktur des Parameterobjektes |
| ParmRole | Rolle des Parameterobjektes |
| ParmItemCount | Anzahl Items im Parameterobjekt |
| ParmField<Typspezifikation> | Feld mit Typspezifikation in einem Parameterobjekt. Beispiel: ParmFieldX - Alphanumerisches Feld ParmFieldZ - Timestampfeld |
| GlobObjt | Objektstruktur des globalen Objektes |
| GlobClass | Klasse des globalen Objektes |
| GlobDstr | Datenstruktur des globalen Objektes |
| GlobRole | Rolle des globalen Objektes |
| GlobItemCount | Anzahl Items im globalen Objekt |
| GlobField<Typspezifikation> | Feld mit Typspezifikation in einem globalen Objekt Beispiel: GlobFieldD - Datumsfeld GlobFieldN - Numerisches Feld |