TstDiff - Schnittstelle vergleichen

Die TstDiff-Aufgabe BSARIO vergleicht die Schnittstelle eines aufgezeichneten Bausteinaufrufes. In der Protokolldatei steht, worin die Eingangsschnittstelle sich von der Ausgangsschnittstelle unterscheidet.

Syntax

 tstDiff [tstdiff-Optionen] BSARIO Aufz=<Name1> Bsar=<BstnName1>.<Event1>.<Occ1> ["Opts=<Optionen>"]

Argumente

Aufz: Mit Aufz=<Name> geben Sie den Namen der Aufzeichnung an, die für den Vergleihcd herangezogen wird. Sie müssen dieses Argument einmal übergeben.
Bsar: Mit Bsar=<Name>.<Operation>.<Occ> benennen Sie einen Bausteinaufruf, der für den Vergleich herangezogen wird.
- <Name> ist der Name des Bausteins,
- <Operation> ist der Name der Operatin, die in dem Baustein ausgelöst wurde, und
- <Occ> gibt an, der wievielte Aufruf (Occurence) diees Bausteins (ggf. mit der angegebenen Operation) verglichen werden soll. Wenn Sie <Name>, <Operation> und/oder <Occ> weglassen, wird TstDiff versuchen, einen Baustein zu finden, der den restlichen Angaben entspricht. Sie z.B. <Occ> nicht angeben, wird der erste Aufruf angenommen.
Opts: Die Optionen für die Aufgabe BSARIO müssen in dem Format „Opts=<Optionen>“ (in Hochkommata!) angegeben werden, um sie von den allgemeinen tstDiff-Optionen unterscheiden zu können. Hier können Sie aufgabenbezogene Optionen angeben, sowie bestimmte allgemeine Optionen übersteuern.

Optionen

Der Schnittstellenvergleich kennt folgende Optionen:

-c	`-c[0\|1\|2]` gibt an, ob bei den Objekten, Conditions und Oops-Meldungen alle Inhalte in der Differenzliste ausgegeben werden sollen, oder nur Unterschiede: -c1 ist der Default und bedeutet, dass der Inhalt von Objekten usw., in denen ein Unterschied festgestellt wurde, komplett ausgegeben wird. -c0 bedeutet, dass nur die Felder von Objekten usw. ausgegeben werden, in denen Unterschiede festgestellt wurden. -c2 bedeutet, dass alle Inhalte von Objekten usw. komplett ausgegeben werden, egal ob Unterschiede vorhanden sind oder nicht.
-dm	Mit der Option `-dm[<Schwellenwert>]` erreichen Sie, dass in Listenobjekten die Einträge nicht der Reihenfolge nach verglichen werden, sondern dass diejenigen Einträge miteinander verglichen werden, die am meisten gemeinsam haben. Über die Angabe [Schwellenwert] geben Sie an, wie viele Unterschiede höchstens vorhanden sein dürfen, damit Einträge miteinander verglichen werden können: je niedriger der Wert, desto genauer müssen die Einträge übereinstimmen. Der Default ist 0, d.h. die Einträge müssen gleich sein. Jeder Eintrag wird nur ein Mal benutzt. Welche Einträge jeweils miteinander verglichen wurden, ist in der erstellen XML-Datei am Orderattribut erkennbar (bsp: <Item OrderLeft=„2“ OrderRight=„1“> /Item> bedeutet linker Eintrag 2 ist verglichen worden mit rechtem Eintrag 1).
-dr	gibt an, ob die Unterschiede auch bewertet werden sollen: -dr0 : Die Unterschiede werden nicht bewertet. -dr1 : Die Unterschiede werden bewertet.
-dv	Mit der Option `-dv<Datei>` können Sie die Regeln angeben, die beim Vergleich zu berücksichtigen sind.
-o	Mit der Option `-o<Protokoll-Datei>` (für „Output“) können Sie bestimmen, ob das Ergebnis dieses Vergleich in der allgemeinen Outputdatei, oder in eine für dieses Kommando eigene Outputdatei geschrieben werden soll.
-v	`-v <XSL>` veranlasst, dass das erstellte Dokument direkt angezeigt wird, unter Anwendung des mit <XSL> angegebenen Stylesheets.

Protokoll

Im Protokoll wird angegeben, aus welcher Aufzeichnung (<Aufz>) die zu vergleichende Schnittstelle (<Bsar>) stammt. Danach folgt das eigentliche Differenzprotokoll, eingeleitet durch <DiffBsarIO>. Der Eintrag 'empty=„yes“' bedeutet, dass das Feld keinen Inhalt hat, oder dass dieser Oops/diese Condition usw. nicht vorkam. Der Eintrag 'missing=„yes“' bedeutet, dass das Feld in der Datenstruktur (DSTR) nicht vorhanden ist. Anstelle von <InsertCount>, wie im untenstehenden Beispiel, könnte auch <DeleteCount> stehen, Wenn die Anzahl der Items in <OutputCount> geringer ist als die in <InputCount>, erscheint eine Angabe <DeleteCount>, ist die Anzahl der Items größer (wie in untenstehendem Beispiel) wird ein <InsertCount> angegeben. Der <Count> bei <DiffBsarIOReport> gibt an, wieviele Unterschiede festgestellt wurden. Der Eintrag 'empty=„yes“' bedeutet z.B., dass das Feld keinen Inhalt hat.

<?xml version="1.0" standalone="yes" ?> 
  <DiffBsarIOReport version="1.0"> 
    <Aufz> 
      <Name>AVL2001011003</Name> 
      <Bsar> 
        <Appl>TEST</Appl> 
        <Name>AF-AVL-TEST-VB</Name> 
        <Evnt>UEBERTRAGEN</Evnt> 
        <Occ>1</Occ> 
      </Bsar> 
    </Aufz> 
    <DiffBsarIO> 
      <Parm Name="STLMODL"> 
        <Items> 
          <Item OrderLeft="1" OrderRight="1"> 
            <Field Name="000-GUID"> 
              <Left>Guid</Left> 
              <Right>Guid</Right> 
            </Field> 
          <Item OrderRight="2"> 
            <Field Name="000-GUID"> 
              <Left>empty="yes"</Left> 
              <Right>Guid</Right> 
            </Field> 
            <Field Name="000-NAME">...</Field> 
          </Item> 
        </Items> 
      </Parm> 
      <Parm Name="STRMODL" /> 
      <Glob Name="SYSTVAR">... analog an Parm</Glob> 
    </DiffBsarIO> 
    <Count>10</Count> 
  </DiffBsarIOReport>

Der <Count> bei <DiffBsarIOReport> gibt an, wieviele Unterschiede festgestellt wurden. Der Eintrag 'empty=„yes“' bedeutet z.B., dass das Feld keinen Inhalt hat.

Beispiel

Kommandozeile TstDiff.exe -lo c:\t\tstdiff.log -o c:\t\tstdiff.xml bsario aufz=AVL2001011003 bsar=AF-AVL-TEST-VB..2 „opts=-dm0 -c2“ TstDiff.exe -lo c:\t\tstdiff.log -o c:\t\tstdiff.xml -ex d:\work\tstdiff.txt

Scriptdatei zur 2. Kommandozeile

bsario aufz=AVL2001011003 bsar=AF-AVL-TEST-VB..2 "opts=-dm0 -c2"

Auszug aus der Logdatei

USER

2001-01-12-17.24.13.584024: Start TstDiff 2001-01-12-17.24.16.529027: Parsing 'bsario aufz=AVL2001011003 bsar=AF-AVL-TEST-VB..2 „opts=-dm0 -c2“'. 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

Protokolldatei

<?xml version="1.0" standalone="yes" ?> 
<DiffBsarIOReport version="1.0">
  <Aufz>
    <Name>AVL2001011003</Name>
    <Bsar>
      <Appl>TEST</Appl>
      <Name>AF-AVL-TEST-VB</Name>
      <Evnt>UEBERTRAGEN</Evnt>
      <Occ>1</Occ>
    </Bsar>
  </Aufz>
  <DiffBsarIO>
    <Parm Name="STLMODL">
      <Items>
        <Item OrderRight="1">
          <Field Name="000-GUID">
            <Left empty="yes" />
            <Right>Guid</Right>
          </Field>
          <Field Name="000-NAME">
            <Left empty="yes" />
            <Right>AF-AVL-TEST-VB</Right>
          </Field>
          <Field Name="000-TITLE">
            <Left empty="yes" />
            <Right>Testfunktion in VB</Right>
          </Field>
          <Field Name="000-SHORT">
            <Left empty="yes" />
            <Right>AVL6</Right>
          </Field>
          <Field Name="000-TYPE">
            <Left empty="yes" />
            <Right>EFUN</Right>
          </Field>
          <Field Name="000-APPL">
            <Left empty="yes" />
            <Right>TEST</Right>
          </Field>
          - <Field Name="000-ITYP">
            <Left empty="yes" />
            <Right>EXE</Right>
          </Field>
          <Field Name="000-ISPC">
            <Left empty="yes" />
            <Right>VLSTAVL6.EXE</Right>
          </Field>
          <Field Name="000-START-TS">
            <Left empty="yes" />
            <Right>2001-01-10-18.08.51.796946</Right>
          </Field>
          <Field Name="000-END-TS">
            <Left empty="yes" />
            <Right>2001-01-10-18.08.51.816945</Right>
          </Field>
        </Item>
      </Items>
    </Parm>
    <Parm Name="STRMODL">
      <Items>
        <Item OrderLeft="1" OrderRight="1">
          <Field Name="000-GUID">
            <Left>Guid</Left>
            <Right>Guid</Right>
          </Field>
          <Field Name="000-NAME">
            <Left>AF-AVL-TEST-VB</Left>
            <Right>AF-AVL-TEST-VB</Right>
          </Field>
          <Field Name="000-TITLE">
            <Left>Testfunktion in VB</Left>
            <Right>Testfunktion in VB</Right>
          </Field>
          <Field Name="000-SHORT">
            <Left>AVL6</Left>
            <Right>AVL6</Right>
          </Field>
          <Field Name="000-TYPE">
            <Left>EFUN</Left>
            <Right>EFUN</Right>
          </Field>
          <Field Name="000-APPL">
            <Left>TEST</Left>
            <Right>TEST</Right>
          </Field>
          <Field Name="000-ITYP">
            <Left>EXE</Left>
            <Right>EXE</Right>
          </Field>
          <Field Name="000-ISPC">
            <Left>VLSTAVL6.EXE</Left>
            <Right>VLSTAVL6.EXE</Right>
          </Field>
          <Field Name="000-START-TS">
            <Left>2001-01-10-18.08.51.796946</Left>
            <Right>2001-01-10-18.08.51.796946</Right>
          </Field>
          <Field Name="000-END-TS">
            <Left>2001-01-10-18.08.51.816945</Left>
            <Right>2001-01-10-18.08.51.816945</Right>
          </Field>
        </Item>
      </Items>
    </Parm>
  </DiffBsarIO>
  <Count>10</Count>
</DiffBsarIOReport>