|
| Allgemeine Hinweise zu HitBatch-LogfilesIm Zusammenhang mit dem HitBatch-Client sind folgende Protokolldateien ("Logfiles") zu unterscheiden.
Struktur und Speicherform werden durch Parameter der Steuerdatei (i.d.R. Hitbatch.INI) festgelegt. Der Inhalt ergibt sich aus dem konkreten Programmablauf. Auf Besonderheiten der jeweiligen Betriebssystemumgebung wie Dateisystempfade, Schreibweisen und Zugriffsrechte wird hier nicht näher eingegangen. Besonderer Hinweis: Die Auswertung der Logfiles ist Pflicht! AblaufprotokollDer generelle Ablauf des Programms mit Lesen der Steuerdatei, Verbindungsaufnahme zu HIT-Server, abarbeiten der einzelnen Aufgaben (Sets) und Verbindungsabbau wird je nach Konfiguration in unterschiedlicher Ausführlichkeit um Bildschirm und/oder dem Ablaufprotokoll festgehalten. Struktur & InhaltGesteuert durch Parameter in HitBatch.INI, besonders relevant hierbei
BeispielBearbeite Set-1 [Global] Userid=276090000000015; ... ProtoLevel=4; ProtoFile=HitBatch.log; ProtoAppend=1; ProtoScreen=-1; ... AntwortVerbose=3; Schwere=0; ... BlockRestLog=BLOCKREST.LOG; MaxConsecutiveErrors=-1; ... SetCount=1; StartSet=1; WrapAround=0; ConnectLogFile=CONNECTION.LOG; ConnectLogLevel=0; [Set-x] Meldung=ZUGANG; Befehl=IS; VerhaltenBeiNachfrage=1; NachfrageListe=0; TestDoppelteHeader=0; TestRowCounter=1; DataLinesSoFar=0; InputAfterSuccess=0; CsvIn=0; CsvOut=1; CsvLog=0; FuncOnly=0; FileNameIn=ZUGANG.csv; FileNameOut=ZUGANG.out; FileNameLog=ZUGANG.log; Verbindungsaufbau zum Hit-Server ... Verbindung zum Backup-Server ok:hitbackup.hi-tier.de/2223 SEND<*1:XS/T:LOGON/BNR15;MBN;PIN;MELD_WG;TIMEOUT;VERBOSE;VERSIONC:276090000000015;0;900015;4;200;3;23> Datentransfer ... 1.Satz gelesen, Übertragung ... SEND<*2:IS:ZUGANG/BNR15;LOM;ZUGA_DAT:090000000001;DE0912300100;1.1.2003> 2.Satz gelesen, Übertragung ... SEND<*3:IS:ZUGANG/BNR15;LOM;ZUGA_DAT:090000000001;DE0912300101;1.6.2004> Anzahl gelesener Zeilen (inklusive Überschriftszeile) : 3 Anzahl Zeilen ohne Fehler (GOOD) : 2 Anzahl Zeilen mit Fehler (BAD) : 0 Anzahl Zeilen mit Antworten in der LOG-Datei : 2 Set-1 beendet, Sekunden:2 Verbindungsabbau ... SEND<*4:XS:LOGOFF/:> HitBatch beendet HitBatch - Returncode:0, Sekunden:2 Set-LogfileFür jeder separate Aufgabe in der Steuerdatei HitBatch.INI existiert ein eigener "Set". Mit Angaben zu den Eingabedateien mit den Datensätzen aus denen die einzelnen Befehle an den Hitserver erzeugt werden und Ausgabedateien mit Protokollantworten des Servers ("Logfile") und ggf. Datenausgabedateien für abgeholte Daten oder zur Trennung von vom Server akzeptierten Sätze ("Goodfile") und abgelehnten und damit nicht gespeicherten Sätzen ("Badfile"). Struktur & Inhalt
Beispiel*090000000001;DE0912300100;1.1.2003 Die mit Stern gekennzeichneten Datenzeilen sind zur besseren Lesbarkeit fett
angezeigt. Block-LogfileIm Blockmodus wird eine Folge von Befehlen immer als Ganzes betrachtet. Wenn nun während einer Blockübertragung die Verbindung abbricht, gilt der ganze Block als noch nicht gesendet. Bei einem automatischen Wiederaufsetzen wird die Übertragung mit dem ersten Satz des Blockes fortgesetzt. In aller Regel ist davon aus zu gehen, dass die Sätze des abgebrochenen Blocks nicht im Server verarbeitet sind, da der COMMIT implizit am Blockende erfolgt. Würde nun schon ein Teil der Antworten im normalen Set-Logfile stehen, könnte eine Auswertung dieses Logfiles anhand der Schwere zur falschen Annahme gelangen, diese Sätze wäre verarbeitet. Aus diesem Grund werden die Antworten zu einem Block erst am Ende der Verarbeitung des gesamten Blockes ins Set-Logfile geschrieben. Dies dahin werden diese "halbfertigen" Antworten in einer eigenen Datei, dem Block-Logfile, zwischengespeichert. Im Falle des Blockabbruch, insbesondere wenn der durch zu viele aufeinanderfolgenden Datenfehler provoziert war (vgl. Parameter MAXCONSECUTIVEERRORS), kann diese Datei bei der Fehleranalyse hilfreich sein. Eine vollautomatische Auswertung ist aber in der Regel nicht erforderlich. Gesteuert durch Parameter in HitBatch.INI, besonders relevant hierbei
Connection-LogfileIn den obigen Logfiles ist nicht erkennbar mit welchem - Primary oder Backup - Server die Verbindung tatsächlich erfolgte. Wenn der INI-Parameter CONNECTLOGFILE angegeben ist, wird dort exakt protokolliert mit welchen Server die Verbindung erfolgte. Damit können etwaige Verbindungsprobleme analysiert werden. Gesteuert durch Parameter in HitBatch.INI, besonders relevant hierbei
BeispielHitBatch Version 23, 23.03.2004 16:00 |
![]()
© 1999-2021 Bay.StMELF,
verantwortlich für die Durchführung sind die
Stellen
der Länder , fachliche Leitung ZDB: Frau Dr.
Kaja.Kokott@hi-tier.de,
Technik: Helmut.Hartmann@hi-tier.de
Seite zuletzt bearbeitet:
03. November 2021 16:34,
Anbieterinformation: Impressum -
Datenschutz -
Barrierefreiheit
|