HAMMAP Stationsdata                                             HAMMAP V5.0b
====================                                            Gerhard Berg
Fil: STATION.TXT                                                DJ6FM


1. Stationsfiler

    P HAMMAP disketten finns fljande filer med stationsdata:

    DIGI     - Digipeatrar
    FONE     - FM repeatrar
    BEACON   - Fyrar
    ATV      - ATV reapeatrar (amatr TV)
    EME      - EME stationer

    Filerna installeras i katalog HM50\STN.
    
    Data motsvarar uppdatering nr 08.


2. Filformat

   HAMMAP anvnder olika format fr filer med stationsdata.


2.1 Textfiler

    I detta format verfrs stationsdata ver paketradio nten. Formatet
    har standardiserats av olika programutvecklare fr diverse program.
    Formatet beskrivs i filen DATAFORM.TXT. Stationsdata lagras som
    ASCII kod och kan redigeras med en texteditor.

    Stationsfiler i textformat har efternamnet '.STN'. Fr paketradio
    finns dessutom filer med lnkdata. De har efternamnet '.LNK'. 
    Endast efternamnet '.STN' behver anges i de olika kommandona. Finns
    motsvarande lnkdata s hanteras dessa filer automatiskt.


2.2 Textfiler fr uppdatering

    Updateringsfiler innehller kommandon fr att ndra stationsdata. 
    Genom att anvnda uppdateringsfiler s behver inte en komplett 
    stationsfil verfras. Formatet fr dessa filer beskrivs i filen 
    DATAFORM.TXT. Uppdaterings data lagras i ASCII kod och kan redigeras 
    med en texteditor.

    Uppdateringsfiler har efternamnet '.UPD'.


2.3 Binra stationsfiler

    D anvndandet av textfiler skulle bli alltfr lngsam verstts
    textfilen till binrformat med konverteringsprogrammet. Dessa binrfiler 
    anvnds sedan i HAMMAP. Man kan ocks konvertera tillbaka till 
    textformat. Eftersom binrfiler tar mindre plats n textfiler finns
    endast binrfilerna p diskett och hrddisk.

    Fr varje stationsfil finns en uppsttning av fem binrfiler:

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

    Fr samtliga kommandon behver endast efternamnet '.BSD' anges.
    De vriga filerna hanteras automatiskt.

    HAMMAP 4.0 och HAMMAP 5.0 anvnder olika filformat fr stationsdata.
    Vill man anvnda samma stationsdata fr de olika programmen mste frst
    binrfilen omvandlas till textfil. Sedan mste textfilen omvandlas 
    till en binrfil fr resp programversion. Vg beakta de olika filformaten. 
    (Se filen DATAFORM.TXT).

    Om man vill lsa in en textfil till HAMMAP 5.0 frn HAMMAP 4.0 ska 
    parametern 'DataFormat = 1' anvndas. (Se kapitel 5.). Om man vill
    generera en textfil fr HAMMAP 4.0 stts parametern 'DataFormat = 40'.


3. Konvertering

   Vid konverteringen omvandlas formatet fr indatafilens/filernas till 
   nskat format fr utdatafilen/filerna.

   Indata kan best av fljande alternativ:

   - en textfil 
   - en binrfil
   - en binrfil plus en eller flera textfiler med stations- eller 
     uppdateringsdata.

   HAMMAP konverteringsprogramm frutstter inte att indata i textfilerna
   r sorterade. Data i uppdateringsfilerna behandlas i den turordning de
   r listade.

   Utdata kan best av en binr- och/eller textfil. Utdata r alltid
   sorterade.

   Dessutom kan en logfil skapas. Denna har efternamnet '.LOG'. Logfilerna
   innehller en lista ver anvnda parametrar och ev felmeddelanden.
   
   Om den frsta indatafilen r en binrfil s fr en binr utdatafil 
   ges samma namn. Utdatafilen kommer d att kompletteras.

   Vid uppdatering av binrfiler tas gamla data ej bort utan markeras
   som borttagna. Detta innebr att filen ej minskar i storlek motsvarande
   t.ex. borttagna stationsdata. I sdana fall visas totala antalet stationer
   (aktuella plus "borttagna") inom parentes. Vill man minska filens
   storlek mste den frst konverteras till textformat och sedan ter till
   binrformat.

   Om ingen utdatafil anges s kontrolleras endast indata.

   Val av in/utdatafiler kan gras antingen genom en kommandorad eller
   genom att anvnda ett speciellt fnster.

   Om fel upptrder vid konverteringen s mste dessa korrigeras
   och konverteringen upprepas. Om fel upptrtt eller konverteringen
   avbrutits kommer berrda binrfiler ej att lsas in av HAMMAP.

   Vg beakta att initieringsfilens parametrar anvnds vid konverteringen.
   
   Vill man anvnda en nykonverterad stationsfil mste den frst lsas in
   genom kommandot 'Stationsfil...' i menyn 'Arkiv'.


4. Start av konverteringsprogrammet

   I HAMMAP fr DOS startas konverteringsprogrammet normalt
   med kommandot HAMMAP och sedan siffran 2. I HAMMAP fr Windows startar
   man genom att dubbelklicka p programsymbolen 'Stationer' i HAMMAP 
   programmgruppen. Efter start syns ett fnster fr att vlja filer.
   

   Undantagsvis kan konverteringsprogrammet ocks startas separat.
   Drvid br fljande beaktas:

   - I HAMMAP fr DOS finns konverteringsprogrammet SCDOS.EXE 
     i katalog HM50\DOS. Fr exekvering behvs HMDRT40E.EXE i 
     katalog HM50.
     HMDRT40E.EXE mste finnas i aktuell katalog eller i en katalog
     som angivits i 'PATH'
    

   - I HAMMAP fr Windows finns konverteringsprogrammet SCWIN.EXE 
     i katalog HM50\WIN.

   - Alla programmets meddelanden och texter ligger i separata filer
     p resp sprk. De har efternamnet '.MSG'. Hjlptexterna finns
     ocks i separata filer p resp sprk. De har efternamnet '.HLP'. 
     Fr den svenska versionen heter de SVENSKA.MSG resp SVENSKA.HLP 
     och befinner sig i katalog HM50.

   - Parametrarna som styr konverteringen finns i en parameterfil. Denna
     har efternamnet '.INI'. Normalt anvnds filen HAMMAP50.INI i katalog
     HM50.


   - Syntaxen fr startkommandot r fljande:

     HAMMAP fr DOS:
     [skvg]SCDOS [meddelanden] { /? | [parameter] [indata [utdata]] }

     HAMMAP fr Windows:
     [skvg]SCWIN [meddelanden] { /? | [parameter] [indata [utdata]] }

     skvg
       Definierar resp skivenhet och skvg fr programmet SCDOS.EXE
       resp SCWIN.EXE.

     meddelanden
       Definierar skivenhet, skvg och namn p meddelande- och 
       hjlpfilerna. Efternamnet '.MSG' mste anges. Om ingen MSG-fil 
       angivits anvnder HAMMAP det sprk som angivits i filen HM-SPEAK.INI 
       som filnamn och lgger till efternamnet  ".MSG". Hjlpfilen har 
       samma namn som MSG-filen men efternamnet ".HLP".

     /?
       Om option '/?' anges visas en hjlptext.

     parameter
       Definierar skivenhet, skvg och namn p parameterfilen.
       Efternamnet '.INI' mste anges. Om ingen parameterfil anges 
       kommer filen HAMMAP50.INI i aktuell katalog att anvndas.

     indata
       Definierar en eller flera indatafiler. Skivenhet och skvg kan anges.
       Tilltna efternamn r '.STN', '.UPD' och '.BSD'. Om ingen indatafil 
       anges grs det senare i ett speciellt fnster. 

       Om flera indatafiler ska anvndas stts ett '+'tecken mellan 
       filnamnen. Inga mellanslag fr finnas mellan filnamnen och 
       '+' tecknen.

     utdata
       Definierar en eller flera utdatafiler. Skivenhet och skvg kan anges.
       Tilltna efternamn r '.STN', '.BSD' und '.LOG'. Om en indatafil men
       ingen utdatafil med efternamnet '.STN' eller '.BSD' angivits grs
       bara en kontroll av indatafilen/filerna. Om flera utdatafiler ska
       skapas anges mellanslag mellan resp filnamn. Godtycklig turordning.


   - Exempel

     Alla exempel gller HAMMAP fr DOS. I HAMMAP fr Windows erstts
     DOS\SCDOS med WIN\SCWIN.
    
     I alla exempel frutstts att filerna SVENSKA.MSG, SVENSKA.HLP 
     och HAMMAP50.INI ligger i katalog HM50 och att alla stationsfilerna
     ligger i HM50\MAP.

     I HAMMAP fr DOS frutstts vidare att HM50 r aktuell katalog. 
     Filen HMDRT40E.EXE mste ligga i katalog HM50.
    
     
     DOS\SCDOS /?
       Visar en hjlptext.

     DOS\SCDOS
       Startar konverteringsprogrammet. Filerna anges i ett speciellt 
       fnster. Hjlptexter finns on line.

     DOS\SCDOS STN\DIGI.BSD+STN\DIGI01.UPD STN\DIGI.BSD STN\DIGI01.LOG
       Uppdaterar binrfilen DIGI.BSD med uppdateringsfilen DIGI01.UPD.
       Ev fel samlas i DIGI01.LOG.

     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.BSD

       Dessa fem kommandon konverterar binrfilerna till 
       textfiler.

     

5. Parametrar fr konverteringsprogrammet

   Parametrarna som styr konverteringen ligger i parameterfilen
   (normalt HAMMAP50.INI). De str mellan raderna '[STNCVT]' och 
   '[MAPCVT]'. Standardvrden anvnds om inget annat anges. I exemplen
   nedan anvnds standardvrden.

   MaxStations = 0

     Anger max antal stationer fr konverteringen. Vrdet mste vara
     strre n (eller lika med) antalet stationer. Om ett fr stort tal anges
     rcker ev inte minnet till.

     Om MaxStations = 0 anges s anpassas automatiskt ndvndigt minnesbehov.
     

   MaxLinks = 0

     Anger max antal lnkar fr konverteringen. Vrdet mste vara
     strre n (eller lika med) antalet lnkar. Om ett fr stort tal anges
     rcker ev inte minnet till.
     
     Om MaxLinks = 0 anges s anpassas automatiskt ndvndigt minnesbehov.
     

   LoadMode = 0

     Anger vilka filer som laddas in i minnet. Fljande vrden tillts:

     LoadMode      fil.BSD        fil.BLD
     ------------------------------------------
        0            nej            nej
        1            ja             nej
        2            nej            ja
        2            ja             ja

     Filerna xxx.BSI och xxx.BLI laddas alltid. Filerna xxx.BST laddas
     aldrig.

     Filer som ej laddas in i minnet lses frn disk.


   TextFormat = 1

     Anger formatet fr utdatafiler i textformat. Fljande vrden tillts:

     0  - Flten fylls inte med mellanslag. Utdatafilerna fr minimal lngd
          men blir svrlsta d de ej skrivs i spalter.

     1  - Alla flt med undantag av QTH, Info och Lnk baud fylls till
          max lngd med mellanslag (se file DATAFORM.TXT). Om QTH r kortare 
          n 8 tecken fylls det ut till 8 tecken.Om lnk baudrate r kortare
          n 6 tecken fylls det ut till 6 tecken.

     2  - Alla flt fylls till max lngd med mellanslag.


   DataFormat = 0

     Med denna parameter kan olika optioner vljas fr hantering av textfiler.
     Instllningarna grs huvudsakligen fr att f kompatibilitet med 
     HAMMAP V4.0.

     
     1  - Vid inlsning av en textfil ndras Baud = 999999 till
          Lnk typ = WI (trd) och Baud = 0.
          Felmeddelande ges om parametern saknas.

     2  - Vid inlsning av en textfil ndras Lnks status = WI (trd)
          till Lnk typ = WI och Lnk status = Ok.
          Felmeddelande ges om parametern saknas.

     4  - Vid generering av textfil sorteras SSID's alfabetiskt
          (0,1,10...15,2,...9) i stllet fr numeriskt.

     8  - Vid generering av textfil ndras LnkTyp = WI (trd) till
          Baud = 999999.

    16  - Vid generering av textfil ndras LnkTyp = WI (trd) till
          Lnk status = WI.

    32  - Vid generering av textfil utelmnas LnkTyp.

    64  - Vid generering av textfil ndras Baudrate ver 999999 till
          Baud = 999998.



   AddLines = -1

     Denna parameter anger vilka flt som r aktiva i tillggsraderna.
     Inaktiva flt tas bort i textfilen. Om vrdet 32 satts fr
     ErrorLevel ges felmeddelanden om indata anges fr inaktiva flt.

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


   ErrorLevel = 0

     Om fljande parametrar valts s ges felmeddelande om fltet innehller
     ogiltig (oknd) information.

      1 - Stations status
      2 - Stations typ
      4 - Software
      8 - Hardware
     16 - Lnk status

     32 - Felmeddelande fr otillten tillggsrad.


   ErrorExit = OFF

     Om 'ErrorExit = ON' avbryts konverteringen efter frsta felet.
     Med 'ErrorExit = OFF' fortstter konverteringen men felen listas.


   TempFile = ~HMCVT~~.BSD

     Anger skivenhet, skvg och namn fr en ev temporr fil. Om man
     installerat en RAM disk br den anges eftersom konverteringen d
     grs snabbare. Temporra filer tas bort automatiskt efter felfri
     konvertering.


   3D = ON

     Kommandot kopplar in 3D effekt i dialogboxarna. Med Herculeskort
     r normalinstllningen '3D = OFF'.
