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 unter Datei → Einstellungen… → Telegramme → Protokoll/Datenbank verändern. Der Cache hat eine eigene Seite unter Datei → Einstellungen… → Telegramme → Telegramm-Cache.

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 Telegramme in Datenbank speichern zu setzen. Standardmäßig werden alle Telegramme gespeichert.

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.

Zusätzlich legen Sie über eine Auswahlliste fest, ob das Speichern auf bestimmte Kanäle eingeschränkt werden soll.

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 aus der Datenbank einlesen. Dazu ist im Einstellungsdialog der Haken vor Telegramme beim Start aus Datenbank lesen zu setzen. Zum Laden können Sie zwischen zwei Modi wählen:

• die letzten ... Einträge: Es wird maximal die angegebene Anzahl an Einträgen geladen.
• 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=InnoDB DEFAULT CHARSET=utf8mb4;

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 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 Format DD.MM.YYYY hh:mm:ss (Beispiel: 25.07.2010 14:42:17)
• Typ: Telegrammtyp. Es können alle Telegrammtypen gespeichert werden:
  • 1: FMS Telegramm
  • 2: ZVEI Telegramm
  • 3: ZVEI Telegramm mit Informationen über Sirenenauslösung
  • 4: POCSAG Telegramm
  • 5: TETRA SDS mit Position
  • 6: TETRA SDS mit Nachricht
  • 7: TETRA SDS mit Status
  • 8: Status-Telegramm
  • 9: Positions-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 Telegrammadresse. Die Länge und das Format dieses Feldes variieren je nach Telegrammtyp:
  • ZVEI: Adresse-Feld beinhaltet die 5-Tonfolge
  • FMS: Adresse-Feld beinhaltet:
    • 1. Zeichen: Behörde (hexadezimal, Wertebereich: 1-F)
    • 2. Zeichen: Landeskennung (hexadezimal, Wertebereich: 0-F)
    • 3.-4. Zeichen: Ortskennung (dezimal, Wertebereich: 00-99)
    • 5.-8. Zeichen: Fahrzeugkennung (dezimal, Wertebereich: 0000-9999)
    • 9. Zeichen: Status (hexadezimal, Wertebereich: 1-F)
    • 10. 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)

Fehlende Information

Die Belegung der Felder Adresse, Meldung und Funktion ist nur für FMS, ZVEI und POCSAG beschrieben. Gebraucht wird: Wie sind diese Felder bei den Typen 5 bis 9 (SDS, Status, Position) belegt?

Cache

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

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. Der Cache selbst schreibt keine Telegramme in die Datenbank, sondern liest lediglich die gespeicherten Telegramme aus. Das Schreiben in die Datenbank kann auf der Seite Protokoll/Datenbank konfiguriert werden, siehe Datenbank.