TstSnap: Aufzeichnungen speichern, löschen oder ergänzen

Diese Dokumentation ist in Bearbeitung und noch nicht vollständig.

Wir bitten um Verständnis.

Das Utility tstSnap.exe hilft bei der Verwaltung von Aufzeichnungen. Eine Beschreibung der möglichen Aufgaben finden sie weiter unten.

Syntax

TstSnap [Allgemeine Optionen] <Aufgabe>
TstSnap [Allgemeine Optionen] –ex <Aufgabendatei>

Allgemeine Optionen

TstSnap kennt folgende Optionen:

-a <Anwendung>
-s <Stufe>
-g <Auftrag>
-lo < Log-Datei>
-k[0|1] Trace-Datei nach Verarbeitung (nicht) löschen.
-im[0]1 MVS-Tracesätze (nicht) ignorieren
-spl [0|1] Aufzeichnung in mehrere Teilaufzeichnungen aufteilen bei Überschreitung der Grenzwerte. Gültig nur für AUFZTRANSFORM¹⁾

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 TstRprt während der Verarbeitung ausgibt, nicht am Bildschirm erscheinen, sondern in die angegebene Log-Datei geschrieben werden.
-k	-k oder -k1 bewirkt, dass die Tracedatei nach der Verarbeitung gelöscht wird. Default ist -k0, d.h. die Datei bleibt erhalten.
-im	-im oder -im1 bewirkt, dass unter MVS/Om-Neu erzeugte Trace-Sätze nicht verarbeitet werden. Default ist -im0.

Aufgaben

AUFZSAVE: Speichert die angegebene TraceDatei als Aufzeichnung.
AUFZDELETE: Löscht die unter der Kennung <AufzGuid> aufgezeichneten Daten oder die angegebene Tracedatei
AUFZMERGE: Erweiterung der <Aufzeichnung> um die aufgezeichneten Daten der Tracedatei
AUFZTRANSFORM: Wandelt die TraceDatei in das Snap / Aufzeichnung Format um und optional( speichert es in Teilstücke falls es dem MemoryThreshold überschreitet).²⁾

AUFZSAVE

Argumente:

TraceDatei oder GUID der Aufzeichnung
optional: Neuer Name, unter dem die Aufzeichnung gespeichert werden soll.

Speichert die unter der GUID bzw. in der Tracedatei (.trb) aufgezeichneten Daten als Aufzeichnung in der EDB. Bei Angabe eines Aufzeichungsnamens wird dieser anstelle des beim Aufzeichnen angegebenen Namens verwendet.

AUFZDELETE

Argumente:

TraceDatei oder GUID der Aufzeichnung

Löscht die unter der GUID aufgezeichneten Daten oder die angegebene Tracedatei (.trb).

AUFZMERGE

Argumente:

Name der zu erweiternden Aufzeichnung
TraceDatei, die der Aufzeichnung hinzugefügt werden soll
optional: Neuer Name, unter dem die erweiterte Aufzeichnung gespeichert werden soll.

Erweitert die angegebene Aufzeichnung um die Daten der Tracedatei (.trb). Bei Angabe eines neuen Namens wird die erweiterte Aufzeichnung unter diesem Namen gespeichert.

AUFZTRANSFORM

<TraceDatei> [Name]

Argumente:

TraceDatei oder GUID der Aufzeichnung
optional: Neuer Name, unter dem die Aufzeichnung gespeichert werden soll.

Speichert die unter der GUID bzw. in der Tracedatei (.trb) aufgezeichneten Daten als SNP Datei. Bei Angabe eines Aufzeichungsnamens wird dieser anstelle des beim Aufzeichnen angegebenen Namens verwendet. Bei Angabe der Option -spl 1 wird die Aufzeichnung in mehrere Teilaufzeichnungen aufteilen bei Überschreitung der Grenzwerte.³⁾

Beispiel Aufruf das Splitten einer Aufzeichnung zum erzeugen von Teilaufzeichnungen⁴⁾

tstSnap.exe aufztransform -spl1 D:\work\TRACE\TESTSNAP\AL12542G.trb TESTAUFZSPLIT

¹⁾ , ²⁾ , ³⁾ , ⁴⁾

v10.00