RequestIni

| ALPHA-VISION® Laufzeit

# Request

## Aufbau des INI-File

Das Ini-File ist eine Textdatei im ASCII-Format. Sie kann mit einem geeigneten Texteditor erzeugt oder verändert werden.
Das Ini-File muß vollständig für den jeweiligen Anwendungsfall ausgefüllt sein. Unvollständige oder inkorrekte Einträge können zu Fehlern oder Ausfällen bei den Ergebnissen führen.

Das lokale Ini-File des Gast-Rechners unterscheidet sich je nach Laufmodus.

Im RAS-Modus enthält das lokale Ini-File nur die Sektion `[COMMUNICATION]`, jedoch mit zusätzlichen Einträgen, die im Weiteren durch den Zusatz `(RAS)` gekennzeichnet werden.
Läuft Request nicht im RAS-Modus werden alle drei Sektionen im lokalen Ini-File benötigt.

Sektionen im Request.ini:

- COMMUNICATION
  Diese Einträge sind zwingend erforderlich
- Events
  Enthält die Einträge zur Übertragung von Meldungsdaten
- MpData
  Enthält die Einträge für die Meßstellendatenübertragung

Mindestens für einen der Abschnitte [Events] bzw. [MpData] müssen - im RAS-Modus am Host-Rechner, sonst am lokalen Rechner - alle Einträge im Ini-File vorhanden sein. Es empfielt sich jedoch, im entsprechenden Ini-File alle Einträge unter beiden Abschnitten zu belassen und die jeweils gewollte / nicht gewollte Option über den Eintrag `DoIt` zu aktivieren bzw. zu deaktivieren.

### Sektion: COMMUNICATION

    [COMMUNICATION]
    Application=Window
    Port=ACI
    DoFile=\\D auf OS\Request\Test.do
    IRQ=3
    Data=8N1
    BaudRate=19200
    ReceiveBufferSize=2
    Ras=1
    PointToPoint=COM1_TO_OS
    IniFilePath=\\D auf OS\Request\Test.ini

Application=
Stellt ein, ob das Programm beim Start als Window oder nur als Icon auf der Taskleiste sichtbar wird
Mögliche Einstellungen:

- Window
- Icon (default)

Port=
Mögliche Einstellungen:

- Jede vorhandene serielle oder parallele Schnittstelle (typisch: COM1, COM2 oder LPT1)
- ACI (Direktverbindung zur Aci, muß für RAS-Modus gesetzt sein)

DoFile=
Name (inklusive Extension .do) und ggf. Pfad des Projektfiles (`*.do`) , dessen Daten gelesen werden sollen.
Im RAS-Modus setzt die Angabe sich zusammen aus dem Freigabenamen des Host-Laufwerks, dem Pfad und dem Namen inklusive Extension .do

IRQ=
Der Interrupt über den die Schnittstelle gesteuert wird
Mögliche Einstellungen:

- alle verfügbaren Interruptnummern (typisch: 3 oder 4)

Data=
Konfigurationparameter für die serielle Schnittstelle, immer 3 Zeichen lang.
Die Einstellung muß auf den gekoppelten Rechnern übereinstimmen

Zeichen Nr. | Bedeutung | Mögliche Einstellungen
--- | --- | ---

1

Anzahl der Datenbits

- 7
- 8 (typisch)

2

Auswertung des Parity-Bits

- E (even)
- O (odd)
- N (no, typisch)

3

Anzahl der zu sendenden Stopp-Bits

- 1 (typisch)
- 2

BaudRate=
Legt die Übertragungsrate für die serielle Schnittstelle fest.
Die Einstellung muß auf den gekoppelten Rechnern übereinstimmen.
Mögliche Einstellungen (in Baud):

- 9600
- 14400
- 19200
- 28800
- 38400
- 57600
- 115200

ReceiveBufferSize=
Grösse eines Übertragungsblocks in kByte
Mögliche Einstellungen:

- frei wählbar
- kein Eintrag (Benutzung des Default-Werts von 1 kByte)

Ras=
`(RAS)`
Nachträgliches Setzen des RAS-Modus bei Laden des Ini-Files über den OPEN-INI-FILE-Button
Mögliche Einstellungen:

- 1 (RAS-Modus ein)
- 0 (RAS-Modus aus)
- -1 (RAS-Modus über command line Parameter, Ini-File Eintrag ignorieren)
ACHTUNG: Ein aktiver Ini-File Eintrag überschreibt gegebenfalls die über die command line gesetzten Einstellungen

PointToPoint=
`(RAS)`
Definiert die Schnittstelle des PCs, über die der Datentransfer erfolgen soll.
Genutzt werden kann jede serielle oder parallele Schnittstelle. Mögliche Einstellungen:

- Der Name der für die ausgewählte Schnittstelle erstellten Verbindung (siehe Direktverbindung zweier PCs: Gastrechner einrichten)

IniFilePath=
`(RAS)`
Angabe des remoten Ini-Files, dessen `[Events]` und `[MpData]` Sektionen geladen werden sollen.
Die Angabe setzt sich zusammen aus dem Freigabenamen des Host-Laufwerks, dem Pfad und dem Ini-File Name inklusive Extension .ini

### Sektion: Events

    [EVENTS]
    DoIt=1
    FileName=C:\Ev_Data\Alarme
    NoOfRecords=500
    DataType=SDF
    Delimiter=44
    SendEOL=1
    Col=Arch_Type, C2; Arch_ObjectNo, C5; Arch_PrvStatus, C5;

DoIt=
Anforderung der Meldungsdaten
Mögliche Einstellungen:

- 0 (keine Anforderung)
- 1 (Anforderung mit Eventlog-Abgleich bei Start)
- 2 (Anforderung ohne Eventlog-Abgleich)
Einstellung 1 sollte nur benutzt werden, wenn tatsächlich ein komplettes Eventlog benötigt wird, da ein Eventlog einige tausend Einträge enthalten und ein vollständiger Abgleich beim Start des Programms den OS-Rechner somit entsprechend lange belasten kann.

FileName=
Name (inklusive Pfad, exklusive Extension) der Datei, in der die Meldedaten abgelegt werden.
Ohne Pfadangabe wird die Datei im selben Verzeichnis angelegt, in dem sich das Programm Request.exe befindet.Bei einer ungültigen Pfadangabe wird die Datei nicht geschrieben.

NoOfRecords=
Nach der hier angegebenen Anzahl von Einträgen wird eine neue Datei begonnen. Diese trägt den gleichen Namen, die Nummer wird in der Extension hochgezählt (<Dateiname>.001, <Dateiname>.002 etc.)
Mögliche Einstellungen:

- Wert zwischen 1 und 20000

DataType=
Datenformat, in dem die Datei geschrieben wird (siehe auch Übertragung der Daten: Datenausgabeformate)
Mögliche Einstellungen:

- BIN (Binär)
- ASCII (delimited ASCII)
- SDF (System Data)

Delimiter=
Maximal dreistelliger Dezimalwert aus der ASCII-Tabelle als Trennzeichen in der Meldedaten-Datei.
Nur gültig, wenn unter DataType ASCII eingetragen ist. Beispiele typischer Einstellungen:

- 22 (-)
- 32 (blank)
- 44 (,)
- 59 (;)
- 92 (\)

SendEOL=
Datensatz-Endkennung
Nur gültig, wenn unter DataType ASCII oder SDF eingetragen ist.
Mögliche Einstellungen:

- 1 (Datensatz mit CR/LF abschließen)
- 0 (Datensatz nicht mit CR/LF abschließen, es gibt nur eine EOF-Kennung)

Col=
<Keyword 1>, <Format 1>;.......; <Keyword n>,<Format n>
Angabe, welche Felder mit welchen Parametern übertragen werden sollen.

- Keyword: Kennung aus der Archivdaten-Liste
- Format: Setzt sich zusammen aus dem Formattyp und der Länge

Format | Bedeutung
--- | ---
Cnnn | Zeichenkette mit nnn Zeichen
In | Ganzzahl, n = 1, 2, oder 4 Bytes
Fn | Gleitpunktzahl, n = 4 oder 8 Bytes

Bei DataType ASCII oder SDF ist als Format nur C zulässig

### Sektion: MpData

    [MpData]
    DoIt=1
    FileName=C:\Mp_Data\MPDAT.TXT
    DataType=SDF
    Delimiter=44
    SendEOL=1
    StartHour=12
    StartMin=00
    IntervalHour=04
    IntervalSec=20
    Col=PointId, C9; Description, C30; Value, C9;
    OBJECTS=30
    OBJ.0000=011004,011006,011007,012006,013004,013006,013007,014004,
    OBJ.0001=014006,014007,021004,022005,031014,031015,031008,031009,
    OBJ.0002=041003,041004,041102,

DoIt=
Anforderung der Meßstellendaten

- 0 (Daten nicht anfordern)
- 1 (Daten anfordern)

FileName=
Name der Datei (inklusive Pfad und Extension), in der die angeforderten Daten abgelegt werden
Ohne Pfadangabe wird die Datei im selben Verzeichnis angelegt, in dem sich das Programm Request.exe befindet.Bei einer ungültigen Pfadangabe wird die Datei nicht geschrieben.

DataType=

Delimiter=

SendEOL=

StartHour=
StartMin=
IntervalHour=
IntervalSec=
Start- und Intervallzeiten für zyklische Meßstellendaten-Übertragung.
Alle angegebenen Zeiten beziehen sich auf die Zeiten des Clients (PCs)!

- Das größte zulässige Intervall beträgt 24 Stunden
- Eine Intervallangabe von 0 Sekunden und Stunden bewirkt ein einmaliges Anfordern der Daten
- Bei Intervallzeiten > 1 Sekunde erfolgt die erste Übertragung zum in StartHour und StartMin angegebenen Zeitpunkt, alle weiteren dann entsprechend der eingetragenen Intervallzeiten

Col=
<Keyword 1>, <Format 1>;.......; <Keyword n>,<Format n>
Angabe, welche Felder mit welchen Parametern übertragen werden sollen

- Keyword: Kennung aus der Keyword-Liste
- Format

Objects=
Anzahl der Objekte bzw. Datensätze, die übertragen werden sollen.
Der Wert dient dem Anwender als Hilfe, ist für das Programm aber nicht relevant.

OBJ.nnnn=
Liste der PointIds für die zu übertragenden Datensätze.

- Jede Zeile beginnt mit der Zeichenfolge "OBJ." und einer nachfolgenden Zeilenzählnummer
- Die erste Zeile hat die Zeilenzählnummer 0000
- Aus Lesbarkeitsgründen sollten pro Zeile nicht mehr als 10 PointIds gelistet werden
- Jede Zeile endet mit einer CR/LF Syntax
Eine Übertragung mehrerer tausend Meßstellen ist möglich, jedoch ist zu beachten, daß auf dem OS-Rechner für die Übertragung Ressourcen benötigt werden und dies bei vielen zu übertragenden Meßstellen entsprechend Zeit in Anspruch nimmt.