Übertragung der Daten in Request

| ALPHA-VISION® Laufzeit

# Request

## Übertragung der Daten

### Datenausgabeformate

1. Binär-Format:
   Die Daten werden im binären Format, in Felder unterteilt, ausgegeben. Im INI-File wird dazu der Feldinhalt und die Feldlänge definiert.
   Jeder String wird mit 0x0 abgeschlossen.
   Wird die Feldlänge kürzer angegeben als in der Keyword-Liste oder der Archivdaten-Liste spezifiziert, so werden die Daten von rechts abgeschnitten. Wird eine größere Feldlänge angegeben, so sind die Daten, die über die festgelegten Feldlängen hinaus gehen, undefiniert (Datenmüll).
2. ASCII-Format:
   Die Daten werden durch Begrenzer getrennt, am Ende folgende Leerzeichen werden unterdrückt.
   Beim Delimited ASCII wird jeder Datensatz mit CR (0 Dh) und LF (0Ah) abgeschlossen.
3. SDF-Format (System Data Format):
   Die einzelnen Feldinhalte werden mit festen Längen ausgegeben.
   Wenn der Inhalt eines Feldes kürzer ist als die Feldlänge, wird der verbleibenden Platz mit Leerzeichen ausgefüllt.
   Beim SDF wird jeder Datensatz mit CR (0 Dh) und LF (0Ah) abgeschlossen.

### Ereignisdaten

Die Ereignisdaten (event data) sind die Daten, die vom System in das Eventlog eingetragen werden.
Welche dieser Daten übertragen werden, wird in der Ini-Datei festgelegt.
Für die Benennung von Ereignisdaten-Files kann ein frei wählbarer Name im INI-File eingetragen werden. Die Extension für ein Ereignisdaten-File wird automatisch von Request erzeugt; sie lautet `.001` bzw `.002`. Diese Extension wird alternierend vergeben und dient dazu, auf dem PC wechselweise Dateien anzulegen, damit die jeweils geschlossene Datei von der Applikation bzw. vom Anwender bearbeitet werden kann. Die Anzahl der Ereignisse, nach denen die aktuell von der OS versorgte Datei geschlossen und eine neue angelegt wird, ist in der Ini-Datei einzutragen.

Damit eine Application erkennen kann, welche der beiden Dateien zur Zeit geschlossen ist (also gerade nicht von der OS geschrieben wird), legt Request ein Status File an. Diese Datei liegt im selben Unterverzeichnis wie das Ereignisdaten-File und hat den selben Namen, jedoch als Extension `.STS`. Im diesem Status-File wird ein String eingetragen, der Angaben über das aktuell geschlossene Ereignisdaten-File einhält. Dieser String besteht aus Dateiname, Datum dieser Datei in ANSI-Schreibweise und Uhrzeit im Format hhmmss. Die einzelnen Angaben sind jeweils durchz ein Komma getrennt. Datum und Zeit werden vom PC abgegriffen.

### Übertragung von Meßstellendaten (MP data)

Die Übertragung von Meßstellendaten dient dazu, sich diese Daten in einer belibigen Zusammenstellung zu belibigen Zeiten ausgeben zu lassen. Welche Daten im welchem Format und zu welcher Zeit gesendet werden sollen, wird in der Ini-Datei eingetragen. Weiterhin wird in der Ini-Datei festgelegt, ob die Meßstellendaten einmalig nach dem Aufruf der Request.exe gesendet werden sollen oder zyklisch.
Im Falle des zyklischen Sendens muß der Anwender oder die aufrufende Applikation dafür sorgen, daß das aktuelle Meßstellendaten-File vor dem Erzeugen eines neuen Files gesichert oder bearbeitet wird.

Der Name von Meßstellendaten-Files und die Extension können frei gewählt werden.

Achtung: Request überprüft nicht, ob bereits ein Meßstellendaten-File mit gleichem Namen existiert. Sofern eine solche Datei vorhanden ist, wird sie ohne Rückfrage überschrieben. Sollen Ereignismeldungsdaten und Meßstellendaten in dem selben Unterverzeichnis zeitgleich erzeugt werden, so ist darauf zu achten, daß die Namen für die Dateien unterschiedlich gewählt werden, weil es sonst zu Konflikten und ungewollten Ergebnissen kommen kann.

Sobald ein Meßstellendaten-File erzeugt (und geschlossen) wurde, legt Request ein Status-Filee an. Diese Datei liegt im selben Unterverzeichnis wie das Meßstellendaten-File und hat den selben Namen, jedoch als Extension `.STS`.In diesem Status-File wird ein String eingetragen, der Angaben über das aktuell geschlossene Meßstellendaten File enthält. Dieser String besteht aus Dateiname, Datum dieser Datei in ANSI -Schreibweise und Uhrzeit im Format hhmmss. Die einzelnen Angaben sind jeweils durch ein Komma getrennt. Bevor ein neues Meßstellendaten-File mit gleichem Namen auf PC erzeugt wird, wird ein eventuell vorhandenes Status-File gelöscht.