Datenbank/Protokolldatei¶

BosMon kann alle empfangenen Nachrichten in eine Datenbank schreiben/aus der Datenbank lesen sowie in eine Protokolldatei schreiben.

Die Konfiguration lässt sich im Einstellungsdialog Datei->Einstellungen… unter Telegramme->Protokolldatei verändern.

Datenbank¶

Datenbank auswählen:

Die Telegramme können in jede im System angelegte Datenbank geschrieben bzw. aus ihr gelesen werden. Im Feld Datenbank lässt sich die Datenbank auswählen

Einträge speichern:

BosMon kann eingetroffene Telegramme in eine Datenbank schreiben. Dazu ist im Einstellungsdialog der Haken vor Protokolldatei schreiben zu setzen. Standardmäßig werden alle Telegramme gespeichert.

Durch durch Filter lassen sich die zu speichernden Telegramme begrenzen. Ist kein Filter gesetzt, so werden alle Telegramme gespeichert. Sind Filterelemente eingetragen, so werden alle Telegramme gespeichert auf die ein Filter zutrifft.

Die benötigte Tabelle wird von BosMon automatisch in der Datenbank angelegt sollte sie nicht vorhanden sein.

Einträge beim Start laden:

BosMon kann bereits aufgezeichnete Einträge bei einem Neustart automatisiert einlesen. Dazu ist im Einstellungsdialog der Haken vor Einträge beim Start laden zu setzen. Zum Laden können 3 unterschiedliche Modi ausgewählt werden:

Alle Einträge laden: Alle in der Protokolldatei gespeicherten Einträge werden geladen. Achtung: Bei einer sehr großen Anzahl an Einträgen kann dies lange dauern.

Lade die letzten … Einträge: Es wird maximal die angegebene Anzahl an Einträgen geladen.

Lade die letzten … Stunden: Es werden nur Einträge geladen, die innerhalb des angegebenen Zeitraums in Stunden eingetroffen sind.

Datenbankschema:

Möchten Sie nicht, dass BosMon die Tabelle automatisch anlegt, so können Sie dies auch manuell vornehmen. Das Plugin TelegramStorage setzt mindestens folgendes Datenbankschema voraus:

CREATE TABLE IF NOT EXISTS `TelegramStorage` (
  `Timestamp` int(11) NOT NULL,
  `Type` int(11) default NULL,
  `Source` int(11) NOT NULL,
  `Flags` int(11) default NULL,
  `Address` varchar(255),
  `Message` text
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

Das Hinzufügen weiterer, benutzerdefinierter Spalten in das Tabellenschema ist erlaubt. BosMon wird die weiteren Spalten mit den Default-Werten befüllen.

Protokolldatei¶

BosMon kann eingetroffene Telegramme in eine Protokolldatei schreiben. Dazu ist im Einstellungsdialog der Haken vor Protokolldatei schreiben zu setzen. Standardmäßig werden alle Telegramme gespeichert.

Durch durch Filter lassen sich die zu speichernden Telegramme begrenzen. Ist kein Filter gesetzt, so werden alle Telegramme gespeichert. Sind Filterelemente eingetragen, so werden alle Telegramme gespeichert, auf die ein Filter zutrifft.

Format der Protokolldatei:

"<Zeit>","<Typ>","<ID>","<Flags>","<Adresse>","<Meldung>","<Funktion>"

Zeit: Zeit im FormatDD.MM.YYYY hh:mm:ss (Beispiel: 25.07.2010 14:42:17)
Typ: Telegrammtyp. Mögliche Typen:
- 1: FMS Telegramm
- 2: ZVEI Telegramm
- 3: ZVEI Telegramm mit Informationen über Sirenenauslösung
- 4: POCSAG Telegramm
Flags: Telegrammspezifische Flags. Die Flags werden bitweise angegeben:
- Bit 0 gesetzt: Telegramm ist eine Wiederholung
- Bit 1 gesetzt: Der 5-Tonfolge folgte der Sirenendoppelton (bei Telegrammtyp 3)
Adresse: Beinhaltet die Telegramadresse. Die Länge und das Format dieses Feldes variiert je nach Telegrammtyp:
- ZVEI: Adresse-Feld beinhaltet die 5-Tonfolge
- FMS: Adresse-Feld beinhaltet:
  
  Zeichen: Behörde (hexadezimal, Wertebreich: 1-F)
  
  Zeichen: Landeskennung (hexadezimal, Wertebereich: 0-F)
  
  3.-4. Zeichen: Ortskennung (dezimal, Wertebereich: 00-99)
  
  5.-8. Zeichen: Fahrzeugkennung (dezimal, Wertebereich: 0000-9999)
  
  Zeichen: Status (hexadezimal, Wertebereich: 1-F)
  
  Zeichen: FMS Info-Feld (Wertebereich: 1-F)
- POCSAG: Adresse- Feld beinhaltet die POCSAG RIC (ohne SubRIC)
Meldung: Wird nur bei POCSAG- und FMS- Telegrammen gesetzt, enthält den Alarmierungstext
Funktion: Wird nur bei POCSAG-Telegrammen gesetzt, in dieses Feld wird die SubRIC geschrieben (a-d)

Cache¶

Für das Bereitstellen von bereits empfangenen Telegrammen im Netzwerk kann man die Cache-Funktionalität aktivieren.

Es gibt 3 Cache-Modi:

Kein Cache: Es werden keine Telegramme gecached.

RAM-Cache: Es wird eine konfigurierbare Anzahl an Telegrammen im Speicher vorgehalten. Werden Telegramme über das Netzwerk angefragt, so beantwortet BosMon die Anfrage aus dem Speicher. Die Anzahl der Telegramme ist begrenzt, dafür ist die Antwortzeit sehr schnell.

Datenbank-Cache: Es werden Telegramme aus der konfigurierten Datenbank gelesen. Dr Cache selbst schreibt keine Telegramme in die Datenbank, sondern liest lediglich die gespeicherten Telegramme aus. Das Schreiben in die Datenbank kann im Reiter Datenbank konfiguriert werden.