
                             OM ACTIVITY LOG 1.3



                             ͻ
        		        /\  
        		         ܱ    
        		            
			     ͼ






                             Michal Karas, OM4AA
                           Namestie slobody 1408/58
                                020 01  Puchov

                         MailBox: OM4AA@OM0PBC.SVK.EU
                          E-Mail: om4aa@qsl.net





                             1. POPIS PROGRAMU
     OM ACTIVITY LOG (OMAC) je program sluziaci ako stanicny dennik 
   do zavodu OM Activity (viac info o zavode v subore "OMACpodm.txt"). 
   Ako zaklad programu som pouzil log N6TR a to z toho dovodu, ze tento 
   program je pomerne rozsireny a preto nebude treba si zvykat na nove 
   prostredie, i ked boli pouzite rozdielne klavesove povely. 
   Program je napisany v jazyku C++. Pre kompilaciu bol pouzity prekladac 
   DJGPP-2.03 (gcc-2.95.2), ale mal by to zobrat aj Borland C++ v3.1. 
   Sirenie programu je mozne za podmienok Obecnej verejnej licencie GNU 
   (GNU GPL), ktorej druha verzia(cesky preklad) je uvedena v subore 
   "copying".
     Sucastou programu su aj zdrojove subory (nie su potrebne pre spravnu 
   cinnost programu). Tieto zdrojove subory su v komprimovanom subore 
   "omacsrc.zip".
   OMAC je rieseny na zaklade 32 bitovych instrukcii, chodi pod DOSom v3.0
   a novsi, ale nema problemy ani pod Win95/98 a mozno ani pod WinNT/2000.
   Tiez to mam odskusane aj pod dosemu-1.0.1 v Linuxe, ale tu sa mozu
   vyskytnut nejake problemy.



                           2. INSTALACIA PROGAMU
     Instalacny program bol vytvoreny pomocou RAR SFX archivu, takze ho
   mozno rozbalit aj v RARe v2.0.
     Po spusteni suboru "OMACins.exe" sa na disk c: nakopiruje niekolko
   docasnych suborov (po ukonceni instalacie sa z disku vymazu) a na 
   obrazovke sa zobrazi okno s otazkou ci pokracovat v instalacii. Ak
   bude zvolena moznost ANO, zobrazia sa podmienky licencie programu
   (GNU GPL) a ponuka s volbami "Suhlasim s podmienkami licencie" a
   "Nesuhlasim s podmienkami licencie". Ak bude zvolena volba 
   "Nesuhlasim ..." instalacia sa ukonci. V opacnom pripade sa program
   opyta na cielovy adresar (tj. kam sa OMAC nainstaluje). Povodne je
   nastaveny adresar "C:\OMAC". Po stlaceni ENTERu sa zacne instalacia
   OMAC do zvoleneho adresara. Pokial prebehne instalacia v poriadku,
   zobrazi sa sprava o uspesnosti instalacie a tym je instalacia ukoncena.
   Subory OMAC:
      omac.exe     - program OMAC
      omac.txt     - tento subor
      omacpodm.txt - podmienky zavodu
      omacsrc.zip  - zdrojove subory programu
   ---------- subory, ktore vzniknu po prvom spusteni programu -----------
      LOG.oma      - stanicny dennik zo zavodu
      omac.tmp     - obsahuje cestu k docasnemu suboru
      cw_keyer.cfg - nastavenie cw keyera
   --- dalsie subory (vzniknu po zvoleni niektorej z funkcii programu) ---
      LOG.txt      - ASCII format dennika
      HLASENIE.txt - hlasenie zo zavodu

   *- Hardverove poziadavky: -*
      Procesor: 386SX (486DX2)
      Pamat:    640kB (1MB)
      Disk:     500kB (1MB)




                        3. VYTVORENIE NOVEHO DENNIKA
     Po prvom spusteni programu (alebo v pripade, ak neexistuje subor 
   "LOG.oma") sa na obrazovke vypise zakladne info o programe a otazka 
   ci sa ma vytvorit novy stanicny dennik. Po stlaceni klavesy "n" alebo
   "N" sa program okamzite ukonci. Ak bola stlacena klavesa "a" alebo "A",
   si program vypyta znacku stanice, nasledne cele meno operatora, QTH 
   stanice (tieto informacie nie je potrebne zadavat), rok a mesiac 
   konania etapy zavodu (v hranatych zatvorkach su udaje, ktore sa doplnia
   ak bol stlaceny iba ENTER - nebol zadany udaj). Nakoniec si program 
   vyziada sutaznu kategoriu (cisla: 1 - QRO, 2 - QRP). Po zadani tejto 
   informacie sa otvori dennik pre zavod a program je pripraveny na zapis 
   zavodnych spojeni.




                         4. PROSTREDIE PROGRAMU
     Ako som uz v uvode spominal, prostredie programu je riesene na zaklade 
   LOGu N6TR. Prostredie v OMAC ma vsak niekolko "kozmetickych" uprav.Tieto 
   upravy boli prevedene tak, aby program mal co najlepsie pracovne 
   prostredie pre pracu v zavode OM Activity.
   A teraz k popisu prostredia. Celu obrazovku mozeme rozdelit na 4 celky:
      - Prvy celok (prvy riadok) nazov zavodu (teda "OM Activity Contest"),
        za nim nasleduje znacka stanice, mesiac a rok konania etapy a
        nakoniec sutazna kategoria.
      - Druhy celok (riadky 2 az 6) obsahuje zakladne informacie o skore
        v zavode. Dufam, ze vyznam kazdej polozky je jasny a nie je ho treba 
        rozoberat.
      - Treti celok (cast s modrozelenym pozadim) obsahuje zaznam 
        o poslednych 11-tich spojeniach(jeden riadok=jedno QSO).Kazdy zaznam
        sa sklada z druhu prevadzky, datumu a casu konia spojenia, cisla 
        spojenia, znacky protistanice,odoslaneho RST (automaticky 59(9)),
        prijateho RST (implicitne 59(9)), prijateho cisla - NR, nasobica 
        (ak este nie je), a poctu bodov za spojenie.
      - Stvrty celok(riadky 19 az 24) obsahuje pracovne pole.V tomto poli sa 
        zadava znacka protistanice (policko s fialovym pozadim), prijaty RST
        a NR (policko pre tieto udaje sa vykresli az po zadani znacky 
        protistanice). Dalej sa tu vypisuju rozne kratke napovedy pre 
        tu-ktoru ulohu a taktiez rozne hlasenia pre uzivatela.




                           5. OBSLUHA PROGRAMU
     Pretoze sa jedna o prvu verziu programu, neobsahuje vela funkcii, iba 
   tie najzakladnejsie. 
     Informacie o moznostiach programu sa zobrazia na obrazovku po stlaceni 
   klaves Alt-H. Dalej sa zobrazia zakladne informacie o programe. Napoveda
   sa ukonci stlacenim klavesy ESC. 
     Na ukoncenie prace s programom sluzi kombinacia klaves Alt-X. Program 
   sa nasledne opyta na potvrdenie ukoncenia prace s programom a v pripade 
   stlacenia klavesy "A" sa program ukonci. Ak bude stlacena ina klavesa 
   nez "A", automaticky sa pokracuje v zapise spojeni.
     Pokial boli zadane nespravne udaje do noveho dennika,mozno tieto udaje
   zmenit po stlaceni klaves Alt-C. Po zadani cisla polozky, ktora sa ma 
   zmenit (cislo 1 - 6), poziada program o zadanie novej hodnoty. Pre 
   istotu sa este opyta ci akceptovat zmenu. Navrat z tejto obrazovky do 
   dennika vykona klavesa ESC. 
     Do stanicneho dennika zo zavodu je mozne nazriet pomocou klaves Alt-L.
   Na listovanie dennikom sluzia klavesy PageUp(posun o stranu vyssie), 
   PageDown (posun o stranu nizsie), Home (posun na zaciatok dennika), End
   (posun na koniec dennika). Na ukoncenie prezerania sluzi klavesa ESC. 
   Pocas prezerania sa v spodnej casti obrazovky zobrazuje kratke INFO 
   o obsluhe.
     Pocas zavodu bude zrejme nutne stlacit klavesy Alt-M. Tato kombinacia 
   sluzi na prechod z modu CW do SSB a naopak. Kedy a preco treba tieto 
   klavesy stlacit, dufam nie je potrebne vysvetlovat. 
     Po skonceni zavodu je k dispozicii kombinacia klaves Alt-R, ktora 
   sluzi na vygenerovanie hlasenia zo zavodu do suboru "HLASENIE.txt". 
     Urcite sa raz za cas budeme chciet pozriet do dennika aj bez toho aby
   bolo potrebne spustit program. Preto OMAC umoznuje export dennika do
   ASCII suboru. Tato funkcia sa vyvola stlacenim klaves Alt-T.

     A teraz to najdolezitejsie - Zapis spojeni do dennika.
   Pre kazdeho, kto pracoval s programom N6TR, by nemal zapis spojeni 
   predstavovat problem. V spodnej casti obrazovky sa nachadza pole 
   s fialovym pozadim. Toto pole sluzi na zapis znacky protistanice. 
   Znacka sa zadava automaticky po stlaceni lubovolneho pismena alebo 
   cisla (nie su potrebne niake klavesove kombinacie). Znacka je
   obmedzena na 11 znakov. Po stlaceni ENTERu program skontroluje, 
   ci uz nahodou sa so zadanou stanicou nepracovalo. Pokial ide 
   o duplicitne QSO program pipne a vypise spravu "Duplicitne QSO". 
   Pomocou kurzorovych sipok HORE a DOLU mozno nastavit kurzor do pola 
   znacky a zmenit ju alebo pokracovat v zapise QSO zadavanim prijateho 
   RPRT. Ak zmenena znacka sa akceptuje klavesou ENTER alebo sipkami 
   HORE, DOLE. Po stlaceni jednej z tychto klaves program opat 
   skontroluje ci sa nejedna o duplicitne QSO atd. 
   Ak sa so stanicou este nepracovalo,vykresli sa o riadok nizsie dalsie 
   pole (taktiez s fialovym pozadim). Do tohoto pola sa zadava prijaty 
   report - RST a prijate cislo - NR. Obe polozky su obmedzene na 3 
   cislice (RST + MEDZERA + NR, teda spolu 7 znakov). Ak bola zle zadana 
   znacka mozno ju zmenit tak ako je uvedene vyssie (pomocou kurzorovych
   sipok). Odoslany report je automaticky 59(9). Prijaty RST tiez nie je 
   potrebne zadavat, v takom pripade sa automaticky doplni na 59(9). Inak 
   musime prijate NR oddelit medzerou od prijateho RST. Pokial sa pri 
   prevadzke CW zada dvojcislicovy RST, program to vezme ako RS a za T 
   automaticky doplni 9. Taktiez ak pri prevadzke SSB bude zadany
   jednocislicovy RS, program to vezme ako S a za R doplni 5. 
     Zapis QSO zrusi klavesa ESC. Ak su udaje o QSO v poriadku, zapis 
   spojenia vykona klavesa ENTER. Program automaticky pripise k zadanym 
   informaciam datum a cas spojenia (pricom UTC = systemovy cas), cislo 
   spojenia, odoslany RST (automaticky 59(9)), nasobic (pokial este 
   neexistuje) a pocet bodov za spojenie. Ak sa jedna o duplicitne 
   spojenie, namiesto nasobica sa zapise znak "!" a pocet bodov 0.
   Pri zadavani znacky a prijateho RPRT (RST + NR) su funkcne aj klavesy 
   sluziace na editaciu uz zadanych pismen a cislic.Do tejto skupiny patria 
   teda klavesy:
      sipka do lava (posun kurzora o znak vlavo), 
      sipka do prava (posun kurzora o znak vpravo), 
      DELETE (zmaze znak na pozicii kurzora), 
      BackSpace (zmaze znak pred kurzorom), 
      INSERT (zmena typu vpisovania znakov: VKLADANIE - znak sa zapise na 
         poziciu kurzora a zvysok textu na pravo od kurzora sa posunie 
         o znak vpravo; PREPIS - znak na pozicii kurzora sa prepise zadanym
         znakom),
      HOME (posun kurzora na zaciatok textu),
      END (posun kurzora za koniec textu).




                       6. SUBORY DENNIKA A ICH FORMAT
     Dennik z OMAC tvori subor: "LOG.oma". Nasledne mozu podla vyvolanych 
   funkcii vzniknut subory: "LOG.txt" - Exportovanie dennika do ASCII 
   suboru (Alt - E); "HLASENIE.txt" - Vypis hlasenia zo zavodu (Alt - R).
     Format LOGu - "LOG.oma":
       1. riadok: Znacka
       2.       : Meno OP
       3.       : QTH
       4.       : dd.mm.yyyy - datum zavodu
       5.       : kategoria(1-QRO;2-QRP)~prevadzka(1-CW;2-SSB)  (~ = medzera)
       7.       : "#####..## LOG data ##..#####"
       8. - n.  : Blok dat dennika
   Zmena udajov na prvych piatich riadok - vid stat 5.
   Format bloku dat dennika je zhodny s blokom dat v ASCII subore "LOG.txt".
   Pokial je nevyhnutne vykonat zmenu udajov mimo programu,mozno tuto zmenu
   vykonat iba za predpokladu, ze sa nezmeni postupnost poloziek a ani 
   povodny format celeho suboru. V opacnom pripade by program nemusel 
   spravne pracovat.
   Tento subor sa vytvori ihned po zadani informacii vyziadanych programom 
   po prvom spusteni programu (vid stat 3.).

   Subor "LOG.txt" - ASCII dennik:
   OM Activity Contest~znacka~mesiac~rok~kategoria


   Mod    Datum    Cas  QSO#   Znacka STN    RSTs   RSTr  NRr    Nasob  Bod
   ---    -----    ---  ----   ----------    ----   ----  ---    -----  ---
   Prvy riadok teda obsahuje nazov zavodu, znacku stanice, mesiac a rok 
   konania etapy, sutaznu kategoriu (znak "~" = medzera). Zvysok suboru je 
   rozdeleny do desiatich stlpcov:
      - "Mod" obsahuje druh prevadzky, ktorym sa pracovalo pri spojeni,
      - "Datum" obsahuje datum kedy bolo spojenie naviazane,
      - "Cas" obsahuje cas nadviazania spojenia,
      - "QSO#" obsahuje poradove cislo spojenia,
      - "Znacka STN" obsahuje znacku protistanice, s ktorou sa pracovalo,
      - "RSTs" obsahuje odoslany report - vzdy 59(9),
      - "RSTr" obsahuje prijaty report,
      - "NRr"  obsahuje prijate cislo spojenia,
      - "Nasob" obsahuje nasobic ak este chyba alebo "!" - dupl. spojenie,
      - "Bod"  obsahuje pocet bodov za spojenie (0, 1, 2)
   Tento subor vznikne po exportovani dennika do ASCII formatu. 



                         7. ZAVERECNE USTANOVENIA
     Program dokaze spracovat problizne 500 spojeni, co by mala byt 
   dostatocna rezerva (zatial :-)).
     Vzhladom ktomu, ze sa jedna o takmer prvu verziu programu, bude urcite
   obsahovat niekolko chyb. Preto zistenie akejkolvek chyby programu mi
   mozete oznamit na kontaktoch uvedenych na zaciatku suboru.
   Taktiez uvytam navrhy na zlepsenie programu, alebo otazky, popripade 
   problemy a nazory na program.

                     Prajem mnoho uspechov v zavode OMAC, 73 de Miso/OM4AA

12.05.2000