Specification Data Format for Station Datas               G.Berg
===========================================               DJ6FM
Version 2.0                                               21.05.94

Translation by Michael Tauber, DG0MA


The specification describes the data format used by sending via
Packet Radio.


1. General:
===========

1.1 Files:
----------
- Station file   *.STN  (in al medias)
- Link file      *.LNK  (only in PR)
- Update file    *.UPD

The data format of station and link files is data bank compatible and
suitable for in- and output in masks:

- Every line of a file have got the same format.
  (no comments, no header etc.).
- Every line of a file have got the same (fixed) number of fields.
- The fields have got a defined maximum length.

The update file is a stearing file for updating station and link files.
Update files haven't to be processed by all programmes. An other update
programme (e.g. from HAMMAP) can be used.



1.2 Fields:
-----------
- Fields are separated by comma.
- Commas must not be left out (also if empty fields follow).
- Within a field there must not be a comma (also not in the info field).
- Space signs at the biginning or end of a field (for formation) are 
  possible.
- The content must not exceed the maximum length (Space signs at the
  beginning or end of a field do not count).
- Fields do not have to be filled with space signs up to the maximum 
  length.
- The German ,  and  should not be used.
- Capital and small letters are optional in call, locator and all abbre-
  viations. Preferably, capital letters should be used in these fields.
- Sorting must happen independent of capital or small letters.
- Line, date, Baud and QRG are numeric fields. The can only contain
  numbers or must be empty.
- Fields whose content is unknown stay empty. For numeric fields (date,
  Baud and QRG) the value 0 is like an empty field (=unknown), for every
  other fields there is a question mark "?" (not several).
- Ecception: The following fields must not be empty:
        Station File:  Call, Line
        Link File:     Call1, Call2

All abbreviations (status, type, software, hardware) have two letters.
This is a compromise between readability and data ammount. The abbre-
viations are centrally distributed by the data collecters.


2. Station File:
================

For each station one or more lines can be given (same SSID)
(e.g. if the station has got several user QRG's, Baud rates, sysops etc).

- The first line of a station is the main line. It has got line No. 0.
- Additional lines have got line No. 1 ... 9.
- The same content as in the corresponding field of the main line is in
  an additional line of an empty field.
- Status and date should be put in (if known) for each line.
- In each line QRG and Baud rate should be given for combination if there
  are additional user entries and/or Baud rates.
- Several different additional information should be given in separate
  additional lines.
- In additional lines the fields sysop, locator, QTH and info must be 
  empty. (In beacon files the field info has not to be empty)

- Station files are sorted after calls.
- If a station has got different SSID's an alphabetical sorting (1,10 ...,
  15, 2, ..., 9) should be done for the whole call field (incl. SSID).
- In different lines for the same call they are sorted after line No.


Example:

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,      ,      ,            ,



Line Syntax:   (everything in one line)
------------
Main Line:
  call,0,[status],[date],[type],[software],[hardware],
    [qrg],[baud],[sysop],[locator],[qth],[info]

Additional Lines:
  call,line,[status],[date],[type],[software],[hardware],
    [qrg],[baud],,,,[info*]

* = Only for beacon files.


Field Definitions:
------------------
The given sign number is the maximum field length (without space signs
at beginning or end).

Call    9 signs     with SSID (set with hyphen)
                    Example: DB0GE-8
                    Field must not be empty.
                    SSID '-0' can be left.

Line    1 sign      0 = main line for station
                    1...9 = additional lines for station
                    Field must not be empty.

Status  2 signs     Abbreviations:
                      OK = Working
                      IS = Instable
                      TE = Test
                      DF = Defect
                      PL = Planned

Date    4 signs     Date of the information
                    Format: JJMM
                    Example: 9212 = December 92

Type    2 signs     Abbreviations:
                      Packet Radio:
                        DI = Digipeater
                        MB = Mailbox
                        LN = Link-Node (without user entry)
                        GW = Gateway
                        DX = DX-Cluster
                        WX = Weather-Knot
                        TI = TCP/IP-Server (End)
                        UN = User Node (user)

                      Other Services:
                        RR = RTTY-Relais
                        RB = RTTY-Box
                        AR = AMTOR-Relais
                        AB = AMTOR-Box
                        FR = Phonie-Relais
                        FB = Phonie-Box
                        TV = ATV-Relais
                        LT = Linear-Transponder
                        BE = Beacon
                        EM = EME-Station
                        MM = Multimode-Relais

Software 2 signs      Abbreviations:
                      Packet Radio:
                        FN = FlexNet
                        TH = TheNet
                        TO = TheNode
                        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

                      Phonie, ATV, EME and Beacons: empty
                      No abbreviations for user software.

Hardware 2 signs      Abbreviations:
                      TN = TNC
                      RM = RMNC
                      FA = FALCON
                      SE = SEPRAN

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

                      Phonie, ATV, EME and Beacons: empty
                      No abbreviations for user hardware.

QRG      9 signs    QRG of the user entry in MHz with decimal point.
                    Maximum three signs right of the decimal point 
                    (additional numbers will be deleted: 145.6875 as 
                    145.687).
                    For duplex TX frequency of the digi.
                    No user entry: -1.0
                    Example: 438.425
                    Wrong:   438,425  (comma instead point)


Baud    6 signs     Baud rate of the user entry (Bits/sec):
                    only rational numbers (e.g. 45.45 as 45).
                    Parallel Busses: Transfer-Rate * Buswidth (Bits)
                    Baud rates over 999999: as 999999
                    No user antry : empty
                    Phonie, ATV, EME and Beacon: empty
                    Example: 1200


Sysop   6 signs     Responsible Sysop's call.

Locator 6 signs     IARU-WW-Locator.
                    Example: JN49HI

QTH     36 signs    Exact QTH (maybe with hight above sea level)
                    Example: Moeninger Berg 561 m

Info    48 signs    Information of peculiarities.



Example:

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. Link File:
=============

For each link there is one line.

Line Syntax:
------------
call1,call2,[status],[date],[baud],[type]


Within an alphanumeric comparison Call1 < Call2.
  Right:   DB0AAA,DB0AAB,OK,9301,1200,UH
  Wrong:   DB0AAB,DB0AAA,OK,9301,1200,UH

Sorting: First Call1. If Call1 is the same then Call2.
   Example:  DB0AAA,DB0AAB,OK,9301,1200,UH
             DB0AAA,DB0AAC,OK,9301,9600,UH
             DB0AAA,DB0AAI,OK,9301,9600,UH
             DB0AAB,DB0AAC,OK,9301,1200,UH
             DB0AAB,DB0AAI,OK,9301,9600,UH
             DB0AAC,DB0AAI,OK,9301,9600,UH


Field Definitions:
------------------
Call1   9 signs     with SSID (added with hyphen)
                    Field must not be empty.

Call2   9 signs     with SSID (added with hyphen)
                    Field must not be empty.

Status  2 signs     Abbreviations:
                      OK = Working
                      IS = Instable
                      TE = Test
                      DF = Defect
                      PL = Planned

Date    4 signs     Date of information 
                    Format: JJMM
                    Example: 9212 = December 92

Baud    8 signs     Baud rate of the link (Bits/sec):
                    Example: 9600

Type    2 signs     Type of the link
                      WI =  Wire Link
                      BU = intern Bus connection
                      NT = Internet-Link
                      HF = HF-Link (shortwave)
                      VF = VHF-Link
                      UF = UHF-Link
                      SF = SHF-Link
                      SL = Satellite Link



4. Update File:
===============

- The commands are processed in the order of the file.
- Space lines and comment lines which start with '#' are possible.
- At the beginning of each line (eccept comment) there is a command
  made from two letters followed by ':'.


Command Format:
===============

Each command must bi in one line even though it is devided into two lines
here because of better readability.


1. Add Station
--------------
AS: call,line,[status],[date],[type],[software],[hardware],
      [qrg],[baud],[sysop],[locator],[qth],[info]

Adds the given line.


2. Modify Station
-----------------
MS: call,line,[status],[date],[type],[software],[hardware],
      [qrg],[baud],[sysop],[locator],[qth],[info]

In the line defined by 'call' and 'line' all fields (from status on)
which are not empt in MS command are changed.


3. Delete Station
-----------------
DS: call[,,date]

Erases all signs and all links of the selected station.


DS: call,line[,date]

Erases the line defined by 'call' and 'line'.
'DS: call,0' has the same funktion like 'DS call'.


4. Add Link
-----------
AL: call1,call2,[status],[date],[baud],[type]

Adds the given line.


5.  Modify Link
---------------
ML: call1,call2,[status],[date],[baud],[type]

In the line defined by 'call1' and 'call2' all fields (from status on)
which are not empty in the ML command are changed.


6. Delete Link
--------------
DL: call1,call2[,date]

Erases the link defined by 'call1' and 'call2'.


For erasing separate fields there is no special command. The same
function is reached by giving '0' to all numeric fields (date, QRG, Baud)
and changing all fields with the content '?'.



Changes in Version 1.1:
-----------------------
- Additional station types:
    FB = Phonie-Box
    TV = ATV-Relais
- Optional Date for:
    DS = Delete Station
    DL = Delete Link


Changes in Version 2.0:
-----------------------
- New field Type in link datas.
- Sorting for SSID defined.
- Link-Baud rate maximum 8 signs.
- For beacon Info in additional line possible.
- Additional station types:
    EM = EME-Station
    MM = Multimode-Relais
- Additional Hardware:
    T3 = TNC3
    KA = KAM
- Additional Software:
    AK = AK1A
    DP = Digipoint
    NL = TCP/IP NETCHL
    NS = NOS
    SU = SuperVozelj
    WN = WX-NET
    UX = UNIX
