Spezifikation Datenformat fr Stationsdaten               G.Berg
===========================================               DJ6FM
Version 2.0                                               05.06.94


Die Spezifikation beschreibt das Datenformat, wie es beim Versand
der Daten ber Packet-Radio verwendet wird.


1. Allgemeines:
===============

1.1 Dateien:
------------
- Stationsdatei  *.STN  (bei allen Diensten)
- Linkdatei      *.LNK  (nur bei PR)
- Updatedatei    *.UPD

Das Datenformat der Stations- und Linkdatei ist datenbankgerecht und
zur Ein-/Ausgabe in Masken geeignet:

- Alle Zeilen einer Datei haben das gleiche Format.
  (Keine Kommentare, kein Header usw.).
- Alle Zeilen einer Datei haben die gleiche (feste) Anzahl von Feldern.
- Die Felder haben eine definierte maximale Lnge.


Die Updatedatei ist eine Steuerdatei zum Aktualisieren der Stations- und
Linkdateien. Updatedateien mssen nicht von allen Programmen verarbeitet
werden. Es kann dann ein anderes Updateprogramm (z.B. von HAMMAP)
verwendet werden.



1.2 Felder:
-----------
- Die Felder werden durch Kommata getrennt.
- Kommata drfen nicht weggelassen werden (auch wenn danach nur noch leere
  Felder kommen).
- Innerhalb eines Feldes darf kein Komma stehen (auch nicht im Info-Feld).
- Leerzeichen zu Beginn oder Ende eines Feldes (zur Formatierung) sind zulssig.
- Der Inhalt darf die maximale Lnge nicht berschreiten (Leerzeichen zu
  Beginn und Ende des Feldes zhlen dabei nicht mit).
- Felder mssen nicht bis zu Ihrer maximalen Lnge mit Leerzeichen aufgefllt
  werden.

- Umlaute sollen nicht verwendet werden.
- Gro-/Kleinschreibung ist beliebig bei Call, Locator und allen
  Abkrzungen. Vorzugsweise sollte in diesen Feldern Groschreibung
  verwendet werden.
- Sortierungen mssen unabhngig von der Gro- / Kleinschreibung erfolgen.
- Zeile, Datum, Baud und QRG sind rein numerische Felder. Sie drfen nur
  Zahlen enthalten oder leer sein.
- Felder, deren Inhalt unbekannt ist, bleiben leer. Fr numerische Felder
  (Datum, Baud und QRG) ist der Wert 0 gleich einem leeren Feld (= unbekannt),
  bei allen brigen Feldern ein Fragezeichen '?' (nicht mehrere).
- Ausnahme: Folgende Felder drfen nicht leer sein:
        Stationsdatei:  Call, Zeile
        Linkdatei:      Call1, Call2

Alle Abkrzungen (Status, Typ, Software, Hardware) haben einheitlich zwei
Buchstaben. Dies ist ein Kompromi zwischen Lesbarkeit und Datenmenge.
Die Abkrzungen werden zentral von den Datensammlern vergeben.


2. Stationsdatei:
=================

Fr jede Station knnen (bei gleichem SSID) ein oder mehrere Zeilen
angegeben werden (z.B. wenn die Station mehrere Benutzer-QRG's,
Baud-Raten, Sysops usw. hat).

- Die erste Zeile einer Station ist die Hauptzeile. Sie hat die Zeilennummer 0.
- Zustzliche Zeilen haben die Zeilennummern 1 ... 9.
- Fr leere Felder einer Zusatzzeile gilt der gleiche Inhalt wie im
  entsprechenden Feld der Hauptzeile.
- Status und Datum sollten (sofern bekannt) fr jede Zeile eingesetzt werden.
- Bei zustzlichen Benutzerzugngen und/oder Baud-Raten sollte in jeder Zeile
  QRG und Baud-Rate fr eine Kombination angegeben werden.
- Mehrere unterschiedliche Zusatzinformationen sollten in getrennten
  Zusatzzeilen angegeben werden.
- In Zusatzzeilen mssen die Felder Sysop, Locator, QTH und Info leer sein.
  (In Baken-Dateien mu das Feld Info nicht leer sein.)

- Die Stationsdatei ist nach dem Call sortiert.
- Bei einer Station mit mehreren SSID's soll fr das ganze Call-Feld (incl.
  SSID) eine alphabetische Sortierung erfolgen (1, 10, ..., 15, 2, ..., 9).
- Bei mehreren Zeilen fr das gleiche Call werden diese nach der
  Zeilennummer sortiert.


Beispiel:

DB0CPU,0,OK,9212,DI,FN,RM,438.425,1200,DJ6II ,JN49FL,Ludwigshafen,AG Mikrocomputer
DB0CPU,1,PL,9211,  ,  ,  ,438.425,9600,      ,      ,            ,
DB0CPU,2,  ,    ,  ,  ,  ,144.650,1200,      ,      ,            ,



Zeilensyntax:   (alles in einer Zeile)
-------------
Hauptzeile:
  call,0,[status],[datum],[typ],[software],[hardware],
    [qrg],[baud],[sysop],[locator],[qth],[info]

Zusatzzeilen:
  call,zeile,[status],[datum],[typ],[software],[hardware],
    [qrg],[baud],,,,[info*]

* = Nur fr Baken-Dateien.


Felddefinitionen:
-----------------
Die angegebene Zeichenzahl ist die maximale Feldlnge (ohne Leerzeichen
zu Beginn oder Ende).

Call    9 Zeichen   mit SSID (mit Bindestrich angehngt)
                    Beispiel: DB0GE-8
                    Feld darf nicht leer sein.
                    SSID '-0' kann weggelassen werden.

Zeile   1 Zeichen   0 = Hauptzeile fr Station
                    1...9 = Zusatzzeilen fr Station
                    Feld darf nicht leer sein.

Status  2 Zeichen   Abkrzungen:
                      OK = in Betrieb
                      IS = Instabil
                      TE = Test
                      DF = Defekt
                      PL = Geplant

Datum   4 Zeichen   Datum von dem die Information stammt
                    Format: JJMM
                    Beispiel: 9212 = Dezember 92

Typ     2 Zeichen   Abkrzungen:
                      Packet Radio:
                        DI = Digipeater
                        MB = Mailbox
                        LN = Link-Node (ohne Benutzerzugang)
                        GW = Gateway
                        DX = DX-Cluster
                        WX = Wetter-Knoten
                        TI = TCP/IP-Server (Endstelle)
                        UN = User Node (Benutzer)

                      Andere Dienste:
                        RR = RTTY-Relais
                        RB = RTTY-Box
                        AR = AMTOR-Relais
                        AB = AMTOR-Box
                        FR = Fonie-Relais
                        FB = Fonie-Box
                        TV = ATV-Relais
                        LT = Linear-Transponder
                        BE = Beacon (Bake)
                        EM = EME-Station
                        MM = Multimode-Relais

Software 2 Zeichen  Abkrzungen:
                      Packet Radio:
                        FN = FlexNet
                        TH = TheNet
                        RN = ROSE/FPAC
                        TN = ThenetNode
                        KN = Kam-Node
                        WA = Wampes
                        OE = OE5DXL-Node
                        BC = BayCom-Node
                        BM = BayCom-Mailbox
                        DW = DigiWare
                        SN = SNet
                        G8 = G8BPQ-Switch
                        DB = DieBox
                        FB = FBB-Server
                        AK = AK1A
                        DP = Digipoint
                        NL = TCP/IP NETCHL
                        NS = NOS
                        SU = SuperVozelj
                        WN = WX-NET
                        UX = UNIX

                      Fonie, ATV, EME und Baken: leer
                      Fr Benutzer-Software werden keine Abkrzungen vergeben.

Hardware 2 Zeichen  Abkrzungen:
                      TN = TNC
                      RM = RMNC
                      FA = FALCON
                      SE = SEPRAN

                      PC = PC
                      ST = Atari-ST
                      T3 = TNC3
                      KA = KAM

                      Fonie, ATV, EME und Baken: leer
                      Fr Benutzer-Hardware werden keine Abkrzungen vergeben.

QRG     9 Zeichen   QRG-Angabe des Benutzerzugangs in MHz mit DezimalPUNKT.
                    Maximal drei Stellen rechts vom Dezimalpunkt (zustzliche
                    Stellen werden weggelassen: 145.6875 als 145.687 eingeben).
                    Bei Duplex SENDEfrequenz des Digis.
                    Kein Benutzerzugang : -1.0
                    Beispiel: 438.425
                    Falsch:   438,425  (Komma statt Punkt)


Baud    6 Zeichen   Baudrate des Benutzerzugangs (Bits/sec):
                    Nur ganze Zahlen (z.B. 45.45 als 45 eingeben).
                    Baudraten ber 999999: als 999999 angeben
                    Kein Benutzerzugang : leer
                    Fonie, ATV, EME und Baken: leer
                    Beispiel: 1200


Sysop   6 Zeichen   Rufzeichen des Verantwortlichen/Sysops.

Locator 6 Zeichen   IARU-WW-Locator.
                    Beispiel: JN49HI

QTH     36 Zeichen  Genauere Bezeichnung des QTH's (ggf. mit Hhenangabe)
                    Beispiel: Moeninger Berg 561 m

Info    48 Zeichen  Hinweis auf Besonderheiten.



Beispiel:

DJ6FM ,0,OK,9212,UN,  ,PC,438.425,1200,DJ6FM,JN49HI,Sandhausen  ,HAMMAP-Autor
DB0CPU,0,OK,9212,DI,FN,RM,438.425,1200,DJ6II,JN49FL,Ludwigshafen,AG Mikrocomputer



3. Linkdatei:
=============

Fr jeden Link gibt es eine Zeile.

Zeilensyntax:
-------------
call1,call2,[status],[datum],[baud],[typ]


Bei einem alpanumerischen Vergleich mu Call1 < Call2 sein.
  Richtig:   DB0AAA,DB0AAB,OK,9301,1200,UF
  Falsch:    DB0AAB,DB0AAA,OK,9301,1200,UF

Sortierung: Zuerst nach Call1. Bei gleichem Call1 dann nach Call2.
  Beispiel:  DB0AAA,DB0AAB,OK,9301,1200,UF
             DB0AAA,DB0AAC,OK,9301,9600,UF
             DB0AAA,DB0AAI,OK,9301,9600,UF
             DB0AAB,DB0AAC,OK,9301,1200,UF
             DB0AAB,DB0AAI,OK,9301,9600,UF
             DB0AAC,DB0AAI,OK,9301,9600,UF


Felddefinitionen:
-----------------
Call1   9 Zeichen   mit SSID (mit Bindestrich angehngt)
                    Feld darf nicht leer sein.

Call2   9 Zeichen   mit SSID (mit Bindestrich angehngt)
                    Feld darf nicht leer sein.

Status  2 Zeichen   Abkrzungen:
                      OK = in Betrieb
                      IS = Instabil
                      TE = Test
                      DF = Defekt
                      PL = Geplant

Datum   4 Zeichen   Datum von dem die Information stammt
                    Format: JJMM
                    Beispiel: 9212 = Dezember 92

Baud    8 Zeichen   Baudrate des Links (Bits/sec):
                    Beispiel: 9600
                    Parallele Busse(Typ = BU):
                      Transfer-Rate * Busbreite (Bits)

Typ     2 Zeichen   Typ des Links
                      WI = Draht-Link
                      BU = interne Busverbindung
                      NT = Internet-Link
                      HF = HF-Link (Kurzwelle)
                      VF = VHF-Link
                      UF = UHF-Link
                      SF = SHF-Link
                      SL = Satelliten-Link



4. Update-Datei:
================

- Die Befehle werden in der Reihenfolge abgearbeitet, in der sie
  in der Datei stehen.
- Leerzeilen und Kommentarzeilen, die mit '#' beginnen, sind zulssig.
- Zu Beginn jeder Zeile (auer Kommentar) steht ein Befehl
  aus zwei Buchstaben, der von einem ':' gefolgt wird.


Befehlsformate:
===============

Jeder Befehl mu in einer Zeile stehen, auch wenn er hier wegen besserer
Lesbarkeit in zwei Zeilen aufgeteilt ist.


1. Add Station (Station hinzufgen)
--------------
AS: call,zeile,[status],[datum],[typ],[software],[hardware],
      [qrg],[baud],[sysop],[locator],[qth],[info]

Fgt die angegebene Zeile hinzu.


2. Modify Station (Station ndern).
-----------------
MS: call,zeile,[status],[datum],[typ],[software],[hardware],
      [qrg],[baud],[sysop],[locator],[qth],[info]

In der durch 'call' und 'zeile' definierten Zeile, werden alle Felder
(ab Status), die im MS-Befehl nicht leer sind, gendert.


3. Delete Station (Station lschen)
-----------------
DS: call[,,datum]

Lscht alle Zeilen und alle Links der angegeben Station.


DS: call,zeile[,datum]

Lscht die durch 'call' und 'zeile' definierte Zeile.
'DS: call,0' hat die gleich Funktion wie 'DS call'.


4. Add Link (Link hinzufgen)
-----------
AL: call1,call2,[status],[datum],[baud],[typ]

Fgt die angegebene Zeile hinzu.


5.  Modify Link (Link ndern).
---------------
ML: call1,call2,[status],[datum],[baud],[typ]

In der durch 'call1' und 'call2' definierten Zeile, werden alle Felder
(ab Status), die im ML-Befehl nicht leer sind, gendert.


6. Delete Link (Link lschen)
--------------
DL: call1,call2[,datum]

Lscht den durch 'call1' und 'call2' definierten Link.


Fr das Lschen einzelner Felder ist kein besonderer Befehl vorgesehen.
Die gleiche Funktion wird dadurch erreicht, da numerische Felder
(Datum, Baud und QRG) mit dem Wert '0' und alle anderen Felder mit dem
Inhalt '?' gendert werden.



nderungen in Version 1.1:
--------------------------
- Zustzliche Stationstypen:
    FB = Fonie-Box
    TV = ATV-Relais
- Optionale Datums-Angabe fr:
    DS = Delete Station
    DL = Delete Link


nderungen in Version 2.0:
--------------------------
- Neues Feld Typ in Link-Daten.
- Sortierung fr SSID definiert.
- Link-Baudrate maximal 8 Stellen.
- Bei Baken Info in Zusatzzeilen zulssig.
- Zustzliche Stationstypen:
    EM = EME-Station
    MM = Multimode-Relais
- Zustzliche Hardware:
    T3 = TNC3
    KA = KAM
- Zustzliche Software:
    RN = ROSE/FPAC
    AK = AK1A
    DP = Digipoint
    NL = TCP/IP NETCHL
    NS = NOS
    SU = SuperVozelj
    WN = WX-NET
    UX = UNIX
- Gestrichene Software:
    TO = TheNode
