HAMMAP Stationsdaten                                            HAMMAP V5.0b
====================                                            Gerhard Berg
Datei: STATION.TXT                                              DJ6FM


1. Stationsdateien

    Auf der HAMMAP-Diskette befinden sich folgende Gruppen von Stationsdateien:

    DIGI     - Digipeater-Daten
    FONE     - Fonie-Relais-Daten
    BEACON   - Baken-Daten
    ATV      - ATV-Relais (Amateurfunk-Fernsehen)
    EME      - EME-Stationen (Erde-Mond-Erde)

    Die Dateien werden im Verzeichnis HM50\STN installiert.
    Die Daten entsprechen dem Update 08.


2. Dateiformate

    Fr die Stations-Daten verwendet HAMMAP unterschiedliche Formate.


2.1 Stations-Textdateien

    In diesem Format werden die Stationsdaten ber das Packet-Radio-
    Netzwerk bertragen. Das Format wurde von mehreren Programmautoren
    fr unterschiedliche Programme standardisiert und ist in der Datei
    DATAFORM.TXT beschrieben. Die Daten sind im ASCII-Code gespeichert
    und knnen mit einem Texteditor bearbeitet werden.

    Stationsdaten im Textformat haben die Erweiterung '.STN'. Bei
    Packet-Radio-Daten gibt es zustzlich noch die Datei mit den
    Link-Daten. Sie hat die Erweiterung '.LNK'. In allen Befehlen
    braucht nur die Erweiterung '.STN' angegeben werden. Falls
    vorhanden, wird die Link-Datei automatisch mit verwendet.


2.2 Update-Textdateien

    Update-Dateien enthalten Befehle zum ndern vorhandener Stations-
    daten. Durch die Verwendung von Update-Dateien mu bei nderungen
    nicht immer die komplette Stationsdatei bertragen werden. Das
    Format der Update-Dateien ist in der Datei DATAFORM.TXT beschrieben.
    Die Daten sind im ASCII-Code gespeichert und knnen mit einem
    Texteditor bearbeitet werden.

    Update-Dateien haben die Erweiterung '.UPD'.


2.3 Stations-Binrdateien

    Da die Verarbeitung von Textdateien beim Betrieb von HAMMAP zu
    lange dauern wrde, werden die Textdateien einmalig mit dem
    Konvertierungsprogramm in ein Binrformat bersetzt. Diese
    Binrdateien knnen dann von HAMMAP sehr schnell verarbeitet
    werden. Eine Rckbersetzung des Binrformats in das Textformat
    ist ebenfalls mglich. Da die Binrdateien weniger Platz als die
    Textdateien bentigen, sind auf Diskette und Festplatte zunchst
    nur die Binrdateien gespeichert.

    Fr jede Stationsdatei wird ein Satz von fnf Binrdateien mit
    folgenden Erweiterungen erzeugt:

    .BSD  =  Binary Station Data
    .BSI  =  Binary Station Index
    .BST  =  Binary Station Text
    .BLD  =  Binary Link Data
    .BLI  =  Binary Link Index

    In allen Befehlen braucht nur die Erweiterung '.BSD' angegeben
    werden. Die anderen Dateien werden automatisch mit verwendet.

    Die Binrdateien von HAMMAP 4.0 und HAMMAP 5.0 haben unter-
    schiedliches Format. Wenn Sie Daten zwischen den verschiedenen
    Versionen austauschen wollen, mssen Sie zunchst in der einen
    Version die Binrdateien in Textdateien umwandeln und dann in
    der anderen Version die Textdateien wieder in Binrdateien.
    Beachten Sie dabei die Unterschiede im Datenformat (siehe
    Datei DATAFORM.TXT).

    Wenn Sie mit HAMMAP 5.0 eine Textdatei von HAMMAP 4.0 einlesen
    wollen, sollten Sie den Parameter 'DataFormat = 1' setzen
    (siehe Kapitel 5.). Wenn Sie eine Textdatei fr HAMMAP 4.0
    ausgeben wollen, setzen Sie den Parameter 'DataFormat = 40'


3. Konvertierung

   Bei der Konvertierung wird das Format der Eingabedatei(en)
   in das gewnschte Format der Ausgabedatei(en) umgesetzt.

   Zur Eingabe bestehen folgende Mglichkeiten:

   - eine Stations-Textdatei
   - eine Binrdatei
   - eine Binrdatei und zustzlich eine oder mehrere Stations-
     und/oder Update-Textdateien

   Das HAMMAP-Konvertierungprogramm setzt nicht voraus, da
   die Eingabe-Daten in den Stations-Textdateien sortiert sind.
   Die Daten in den Update-Dateien werden in der Reihenfolge
   verarbeitet, in der sie in der Datei enthalten sind.

   Die Ausgabe kann in eine Binr- und/oder Textdatei erfolgen.
   Die Daten in den Ausgabe-Textdateien sind immer sortiert.

   Zustzlich kann eine LOG-Datei erzeugt werden. Die LOG-Datei
   hat die Erweiterung '.LOG'. Die LOG-Datei enthlt eine Liste
   der verwendeten Parameter, der Dateien und evtl. Fehlermeldungen.

   Wenn die erste Eingabedatei eine Binrdatei ist, so darf die
   Ausgabe-Binrdatei mit dieser identisch sein. In diesem Fall
   wird die Datei um den Inhalt der weiteren Dateien ergnzt.

   Bei der Aktualisierung von Binrdateien werden Stationen und
   Links nicht physikalisch gelscht, sondern nur als gelscht
   markiert. Das bedeutet, da die Dateien nicht um die Zahl
   der gelschten Stationen bzw. Links krzer werden. In solchen
   Fllen wird bei der Konvertierung die Gesamtzahl (aktuelle und
   gelschte Stationen bzw. Links) in Klammern angezeigt. Wenn Sie
   die Dateien um die gelschten Stationen bzw. Links verkrzen
   wollen, mssen Sie die Dateien erst ins Textformat und dann
   wieder ins Binrformat konvertieren.

   Wenn keine Ausgabedatei definiert wird, erfolgt nur eine
   berprfung der Eingabedaten.

   Die Definition der Ein-/Ausgabedatei(en) kann wahlweise in
   der Kommandozeile oder ber eine Eingabemaske erfolgen.

   Wenn bei der Konvertierung Fehler auftreten, so mssen Sie
   die Fehler korrigieren und dann die Konvertierung erneut
   durchfhren. Binr-Dateien, bei deren Konvertierung Fehler
   aufgetreten sind oder bei denen die Konvertierung abgebrochen
   wurde, werden von HAMMAP nicht akzeptiert.

   Beachten Sie, da bei der Konvertierung die in der Initiali-
   sierungsdatei definierten Einstellungen verwendet werden.
   Um eine neu konvertierte Datei in HAMMAP zu verwenden, mssen
   Sie mit dem Befehl 'Stations-Datei' im Men 'Datei' diese
   Datei auswhlen.


4. Start des Konvertierungsprogramms

   Bei HAMMAP fr DOS wird das Konvertierungsprogramm normaler-
   weise mit dem Befehl HAMMAP und danach der Ziffer 2 gestartet.
   Bei HAMMAP fr Windows erfolgt der Start normalerweise durch
   Doppelklick auf das Programmsymbol 'STATIONEN' in der HAMMAP-
   Programmgruppe. Nach dem Start erscheint dann eine Maske zur
   Definition der Ein- und Ausgabedateien.

   In Sonderfllen kann das Konvertierungsprogramm auch direkt
   gestartet werden. Dabei ist folgendes zu beachten:

   - Bei HAMMAP fr DOS befindet sich das Konvertierungsprogramm
     SCDOS.EXE im Verzeichnis HM50\DOS. Zur Ausfhrung wird die
     Laufzeitbibliothek HMDRT40E.EXE im Verzeichnis HM50 bentigt.
     HMDRT40E.EXE mu sich im aktuellen Verzeichnis befinden
     oder in einem Verzeichnis, das in dem DOS-Befehl 'PATH'
     enthalten ist.

   - Bei HAMMAP fr Windows befindet sich das Konvertierungsprogramm
     SCWIN.EXE im Verzeichnis HM50\WIN.

   - Alle im Programm verwendeten Nachrichten und Texte sind nicht
     im Programm enthalten, sondern in einer getrennten Nachrichten-
     datei der jeweiligen Landessprache mit der Erweiterung '.MSG'.
     Die Hilfetexte befinden sich in einer getrennten Datei mit
     der Erweiterung '.HLP'. Fr die deutsche Version heien die
     Dateien DEUTSCH.MSG und DEUTSCH.HLP. Die Dateien befinden sich
     im Verzeichnis HM50.

   - Die fr die Konvertierung verwendeten Einstellungen sind in
     einer Parameterdatei definiert. Die Parameterdatei hat die
     Erweiterung '.INI'. Normalerweise wird die Datei HAMMAP50.INI
     im Verzeichnis HM50 verwendet.


   - Die Syntax fr den Start-Befehl ist folgendermaen:

     HAMMAP fr DOS:
     [pfad]SCDOS [nachrichten] { /? | [parameter] [eingabe [ausgabe]] }

     HAMMAP fr Windows:
     [pfad]SCWIN [nachrichten] { /? | [parameter] [eingabe [ausgabe]] }

     pfad
       Definiert ggf. Laufwerk und Pfad fr das Programm SCDOS.EXE
       bzw. SCWIN.EXE.

     nachrichten
       Definiert Laufwerk, Pfad und Name der Nachrichten- und
       Hilfe-Datei. Die Erweiterung '.MSG' mu mit angegeben
       werden. Wenn keine MSG-Datei angegeben ist, benutzt HAMMAP
       die in der Datei HM-SPEAK.INI angegeben Sprache als Dateiname
       und die Erweiterung ".MSG". Die Hilfedatei hat den gleichen
       Dateinamen wie die MSG-Datei, jedoch die Erweiterung ".HLP".

     /?
       Bei Angabe der Option '/?' wird eine Hilfe zum Programmstart
       ausgegeben.

     parameter
       Definiert Laufwerk, Pfad und Name der Parameter-Datei.
       Die Erweiterung '.INI' mu mit angegeben werden. Wenn
       keine Parameterdatei definiert ist, wird die Datei
       HAMMAP50.INI im aktuellen Verzeichnis verwendet.

     eingabe
       Definiert eine oder mehrere Eingabedateien. Jede Datei-
       Definition kann eine Angabe des Laufwerks und Pfads enthalten.
       Als Erweiterungen sind '.STN', '.UPD' und '.BSD' zulssig.
       Wenn keine Eingabedatei angegeben ist, erfolgt die Definition
       der Dateien ber eine Maske. Wenn mehrere Eingabedateien
       verwendet werden sollen, so werden sie mit '+' aneinanderge-
       hngt. Zwischen den Dateiangaben und dem '+' drfen keine
       Leerzeichen stehen. Die Dateien werden in der Reihenfolge
       verarbeitet, in der sie in der Kommandozeile stehen.

     ausgabe
       Definiert ein oder mehrere Ausgabedateien. Die Definition
       kann eine Angabe des Laufwerks und Pfads enthalten. Als
       Erweiterungen sind '.STN', '.BSD' und '.LOG' zulssig.
       Wenn eine Eingabedatei aber keine Ausgabedatei mit der
       Erweiterung '.STN' oder '.BSD' angegeben ist, erfolgt
       nur eine berprfung der Eingabedatei(en). Wenn mehrere
       Ausgabedateien erzeugt werden sollen, so werden sie mit
       Leerzeichen aneinandergehngt. Die Reihenfolge, in der die
       Ausgabedateien angegeben werden, ist beliebig.


   - Beispiele

     Alle Beispiele gelten fr HAMMAP fr DOS. Bei HAMMAP fr
     Windows mu nur der Programmaufruf DOS\SCDOS durch WIN\SCWIN
     ersetzt werden.

     Bei allen Beispielen wird vorausgesetzt, da die Dateien
     DEUTSCH.MSG, DEUTSCH.HLP und HAMMAP50.INI im Verzeichnis
     HM50 und alle Stations-Dateien in Verzeichnis HM50\STN stehen.

     Bei HAMMAP fr DOS wird weiter vorausgesetzt, da HM50 das
     aktuelle Verzeichnis ist. Ggf. mu mit dem DOS-Befehl CD bzw.
     CHDIR dorthin umgeschaltet werden. Die Datei HMDRT40E.EXE
     mu im Verzeichnis HM50 stehen.


     DOS\SCDOS /?
       Gibt die Hilfe zum Programmstart aus.

     DOS\SCDOS
       Startet das Konvertierungsprogramm. Die Dateien werden ber eine
       Maske definiert. Informationen zur Bedienung der Maske erhalten
       Sie ber die On-Line Hilfe.

     DOS\SCDOS STN\DIGI.BSD+STN\DIGI01.UPD STN\DIGI.BSD STN\DIGI01.LOG
       Aktualisiert die Binrdatei DIGI.BSD mit der Update-Datei DIGI01.UPD.
       Eventuelle Fehler werden in der Datei DIGI01.LOG aufgezeichnet.

     DOS\SCDOS STN\DIGI.BSD STN\DIGI.STN
     DOS\SCDOS STN\FONE.BSD STN\FONE.STN
     DOS\SCDOS STN\BEACON.BSD STN\BEACON.STN
     DOS\SCDOS STN\ATV.BSD STN\ATV.STN
     DOS\SCDOS STN\EME.BSD STN\EME.STN
       Die fnf Befehle konvertieren alle Binrdateien in Textdateien.



5. Einstellungen des Konvertierungsprogramms

   Die fr die Konvertierung benutzten Einstellungen sind in der
   Parameterdatei (normalerweise HAMMAP50.INI) definiert. Sie stehen
   zwischen den Zeilen '[STNCVT]' und '[MAPCVT]'. Fr Parameter, die
   nicht angegeben sind, verwendet das Programm Standard-Werte. In den
   folgenden Erluterungen sind die Standardwerte als Beispiel angegeben.


   MaxStations = 0

     Definiert die maximale Anzahl von Stationen fr die Konvertierung.
     Der angegebene Wert mu grer als die (oder gleich der) tatsch-
     liche(n) Zahl von Stationen sein. Wenn eine zu hohe Zahl angegeben
     wird, reicht evtl. der vorhandene Speicher nicht aus.

     Bei der Einstellung MaxStations = 0 wird der bentigte Speicherplatz
     automatisch vom Programm ermittelt.


   MaxLinks = 0

     Definiert die maximale Anzahl von Links fr die Konvertierung.
     Der angegebene Wert mu grer als die (oder gleich der) tatsch-
     liche(n) Zahl von Links sein. Wenn eine zu hohe Zahl angegeben
     wird, reicht evtl. der vorhandene Speicher nicht aus.

     Bei der Einstellung MaxLinks = 0 wird der bentigte Speicherplatz
     automatisch vom Programm ermittelt.


   LoadMode = 0

     Definiert, welche Dateien in den Speicher geladen werden.
     Folgende Werte sind mglich:

     LoadMode     datei.BSD       datei.BLD
     ------------------------------------------
        0            nein            nein
        1             ja             nein
        2            nein             ja
        2             ja              ja

     Die Dateien xxx.BSI und xxx.BLI werden immer in den Speicher
     geladen. Die Dateien xxx.BST werden nie in den Speicher geladen.

     Dateien, die nicht in den Speicher geladen werden, werden direkt
     auf Disk verarbeitet.


   TextFormat = 1

     Definiert das Format fr die Ausgabe-Textdatei. Folgende Werte sind
     mglich:

     0  - Die Felder werden nicht mit Leerzeichen aufgefllt. Die Ausgabe-
          dateien haben minimale Lnge, sind aber unbersichtlich, da die
          Ausgabe nicht in Spalten angeordnet ist.

     1  - Alle Felder mit Ausnahme von QTH, Info und Link-Baud werden
          mit Leerzeichen auf die maximale Lnge aufgefllt (siehe Datei
          DATAFORM.TXT). Wenn das QTH krzer als 8 Zeichen ist, wird
          es auf 8 Zeichen aufgefllt. Wenn die Link-Baudrate krzer
          als 6 Zeichen ist, wird sie auf 6 Zeichen aufgefllt.

     2  - Alle Felder werden mit Leerzeichen auf die maximale Lnge
          aufgefllt.


   DataFormat = 0

     Mit diesem Parameter knnen unterschiedliche Optionen bei
     Ein- und Ausgabe von Textdateien gewhlt werden. Die
     Einstellungen dienen zum grten Teil zur Kompatibilitt
     mit HAMMAP V4.0.

     Dieser Parameter besteht aus einzelnen Bits. Jedes einzelne
     Bit kann gesetzt oder gelscht sein. Die Werte der gesetzten
     Bits werden addiert.

     1  - Beim Einlesen einer Textdatei wird Baud = 999999 in
          Link-Typ = WI (wired Link) und Baud = 0 umgewandelt.
          Falls das Bit nicht gesetzt ist erfolgt eine Fehlermeldung.

     2  - Beim Einlesen einer Textdatei wird Link-Status = WI (wired
          Link) in Link-Typ = WI und Link-Status = Ok umgewandelt.
          Falls das Bit nicht gesetzt ist erfolgt eine Fehlermeldung.

     4  - Bei Ausgabe einer Textdatei werden SSID's alphabetisch
          sortiert (0,1,10...15,2,...9) statt numerisch.

     8  - Bei Ausgabe einer Textdatei wird LinkTyp = WI (wired Link)
          in Baud = 999999 umgewandelt.

    16  - Bei Ausgabe einer Textdatei wird LinkTyp = WI (wired Link)
          in Link-Status = WI umgewandelt.

    32  - Bei Ausgabe einer Textdatei wird der LinkTyp nicht ausgegeben.

    64  - Bei Ausgabe einer Textdatei werden Baudwerte ber 999999
          in Baud = 999998 umgewandelt.



   AddLines = -1

     Dieser Parameter besteht aus einzelnen Bits. Jedes einzelne
     Bit kann gesetzt oder gelscht sein. Die Werte der gesetzten
     Bits werden addiert. Bei -1 sind alle Bits gesetzt.

     Der Parameter legt fest, welche Felder in Zusatzzeilen gltig
     sind. Bei Eingabe von einer Textdatei bzw. bei Ausgabe in eine
     Textdatei werden ungltige Felder gelscht. Wenn im ErrorLevel
     der Wert 32 gesetzt ist, erfolgt bei der Eingabe fr ungltige
     Felder eine Fehlermeldung.

        1 = status
        2 = datum
        4 = typ
        8 = software
       16 = hardware
       32 = qrg
       64 = baud
      128 = sysop
      256 = locator
      512 = qth
     1024 = info


   ErrorLevel = 0

     Dieser Parameter besteht aus einzelnen Bits. Jedes einzelne
     Bit kann gesetzt oder gelscht sein. Die Werte der gesetzten
     Bits werden addiert. Bei -1 sind alle Bits gesetzt.

     Wenn die folgenden Bits gesetzt sind, erfolgt beim Einlesen
     einer Textdatei bei einem ungltigem (unbekanntem) Feldinhalt
     eine Fehlermeldung. Wenn das Bit gelscht ist, wird das Feld
     als unbekannt (leer) angesehen.

      1 - Stations-Status
      2 - Stations-Typ
      4 - Software
      8 - Hardware
     16 - Link-Status

     32 - Fehlermeldung bei ungltigen Zusatzzeilen


   ErrorExit = OFF

     Mit 'ErrorExit = ON' wird die Konvertierung beim ersten Fehler
     abgebrochen. Mit 'ErrorExit = OFF' werden alle Fehler aufgelistet.


   TempFile = ~HMCVT~~.BSD

     Definiert Laufwerk, Pfad und Namen einer evtl. erforderlichen
     temporren Datei. Wenn Sie eine RAM-Disk installiert haben,
     sollten Sie diese als Laufwerk angegeben, da sich dadurch die
     Konvertierungszeit erheblich verkrzen kann. Nach ordnungs-
     gemem Abschlu des Konvertierungprogramms werden temporre
     Dateien automatisch wieder gelscht.


   3D = ON

     Der Befehl schaltet den 3D-Effekt bei Dialogfeldern ein.
     Bei Verwendung eines Hercules-Adapters ist der Standard-
     Wert '3D = OFF'.
