M u d r . L e n k a   v 1 . 1  -  návod k použití
      =================================================
                   SCOPWARE COPYRIGHT 1989
1. ZÁKLADNÍ INFORMACE
---------------------
   Mudr. Lenka je univerzální výkonný programový prostředek pro
opravu a manipulaci se soubory na magnetofonovém pásku. Umožňuje
zejména:
              - opravovat poškozené soubory
              - nahrávat soubory i jejich části
              - vytvářet nové soubory
              - spojovat více souborů do jednoho a naopak
              - libovolně měnit typ souboru
              - editovat soubory včetně jejich hlaviček
   Program funguje při těchto konfiguracích systému:
         KONFIGURACE                 PAMĚOVÁ KAPACITA
         -----------                 -----------------
   32kB, BF+32kB, BI+32kB     128 bloků po 256 byte ... 32kB
     64kB, 64kBI, 64kBF       208 bloků po 256 byte ... 52kB
64kB s HW úpravou (viz kap.7) 256 bloků po 256 byte ... 64kB
2. ZAVEDENÍ A SPUŠTĚNÍ PROGRAMU
-------------------------------
   Program do počítače zavádíme nejlépe bezprostředně po zap-
nutí nebo po hardwarovém RESETu, abychom zajistili
jeho bezchybnou funkci. Je-li v počítači zasunut modul Basicu,
nahrajeme program příkazem TAPE ; při samotném paměťovém modulu
se spustí nahrávání automaticky. Pokud dojde během nahrávání
k chybě nebo se program nespustí, pokusíme se ho po vypnutí
a zapnutí počítače nebo hardwarovém RESETu nahrát znovu.
   Upozornění: Z důvodu ochrany autorských práv nelze
program kopírovat pomocí existujících kopírovacích programů
(ani sám sebou). Kopie z magnetofonu na magnetofon je nespole-
hlivá a za škody, které může způsobit, neručíme.
3. STRUKTURA MAGNETOFONOVÉHO SOUBORU SORD M5
--------------------------------------------
   Každý magnetofonový soubor pořízený počítačem Sord M5 se
skládá z bloků, které jsou odděleny krátkými úseky zaváděcího
signálu. Každý blok může mít délku 1-256 byte. Rozlišujeme bloky
typu H,D,F a E.
   Blok typu H se nazývá hlavička (HEAD), bývá zaznamenán
jako první v souboru a obsahuje údaje o souboru - typ, jméno,
umístění v paměti, délku a adresu autostartu. Zaváděcí signál
před hlavičkou bývá mnohem delší, než mezi jednotlivými bloky.
   Za blokem typu H následuje většinou řada bloků typu D nebo
F. Pokud je soubor tvořen souvislými (sekvenčními) daty, pak je
složen z bloků typu D (DATA). Takový soubor vytvářejí basicové
příkazy SAVE a VSAVE. Bloky typu D mívají délku 256 bytů (s vý-
jimkou posledního bloku).
   Soubor tvořený nesouvislými (nesekvenčními) daty se skládá
z bloků typu F (FILE). Tyto soubory vytvářejí basicové příkazy
LIST, PRINT #n a PUT #n. Bloky typu F bývají kratší než bloky
typu D a mají delší zaváděčku. Poslední blok souboru nesouvis-
lých dat je typu E (EOF), který pouze označuje konec souboru.
4. PRÁCE S PROGRAMEM
--------------------
   Po zavedení do počítače se program sám spustí. Na obrazovce
se objeví čelní panel se základním menu.
   V horní třetině obrazovky je místo pro zobrazení nahraného
souboru v podobě bloků. V levém horním rohu je kurzor, kterým
lze pohybovat pomocí  kurzorových  šipek  se  současným  stiskem
klávesy CTRL. Tento kurzor ukazuje na aktuální blok, jehož obsah
je zobrazen v dolní třetině obrazovky, a to buď v ASCII nebo
v hexadecimální podobě. Obě podoby zobrazení lze přepínat
současným stiskem CTRl A.
   V prostřední třetině obrazovky je vlevo nahoře místo pro
hlášení programu (je v něm název, verze programu a copyright).
Vpravo od něj jsou údaje o čísle aktuálního bloku (BLK:) a jeho
délce (LEN:). Délka může být 1-256 byte, délka 256 byte se zob-
razí jako 00. Zcela vpravo se nachází místo pro informace
z hlavičky - jméno souboru, jeho typ, umístění v paměti, délka
a autostart.
   Veškeré  číselné  údaje v programu jsou zobrazovány
v hexadecimální soustavě!
   Ve spodní části prostřední třetiny je zobrazena
nabídka funkcí - menu. Požadovanou funkci zvolíme stisknutím
prvního písmene příslušného klíčového slova z menu. Menu je
uspořádáno hierarchicky. Do předchozího menu se vrátíme stisknu-
tím klávesy SPACE, do základního menu pomocí klávesy RETURN.
   Současným stisknutím levého SHIFTu, CTRL a RESET dojde
k inicializaci programu a vymazání všech nahraných bloků.
Práci s programem lze ukončit pouze vypnutím počítače nebo
hardwarovým RESET.
5. FUNKCE PROGRAMU
------------------
5.1 FUNKCE LOAD
---------------
   Tento příkaz slouží k nahrání souboru do počítače. Po
stisknutí klávesy L se  příkaz aktivuje a vypíše se nová
nabídka: LOAD  HOLD-N  SYNC-N.
   LOAD - spustí magnetofon a nahrává jednotlivé bloky do pamě-
ti. Typy nahraných bloků se zobrazují v horní třetině obrazovky.
Je-li v bloku chyba, je jeho typ označen malým písmenem, ale
nahrávání se nezastaví. Obsah nahrávaného bloku je průběžně
zobrazován ve spodní třetině obrazovky. Při nahrávání se obje-
vují tato hlášení:
                    OKAY ... blok je správný
                   ERROR ... v bloku je chyba
                   DIFER ... blok je jiný než ten, který byl
                             na jeho místě
                  ACCEPT ... nahraný blok je přijat a přepíše
                             blok, který byl na jeho místě
                  IGNORE ... nahraný blok není přijat a na
                             místě zůstává původní blok
                    WAIT ... program čeká, až bude nahrán blok
                             shodný s blokem, který byl na jeho
                             místě - viz níže funkce SYNC
Je-li blok natolik poškozen, že nelze přečíst ani jeho typ, je
zcela vynechán a ani kurzor se neposune. Na to je třeba dát
při nahrávání pozor. Funkci LOAD lze zrušit stisknutím klávesy
RESET.
   HOLD - je-li zapnuto (Y), pak původní blok, pokud byl nahrán
bez chyby (velké písmeno typu), není přepsán nově nahraným
blokem. Byl-li původní blok s chybou (malé písmeno typu), pak
přepsán je. Je-li HOLD vypnuto (N), pak nově nahraný blok vždy
přemaže původní. Tato funkce se používá při opravách programů,
abychom si nepřemazali bloky, které se nám už podařilo jednou
nahrát správně.
   SYNC - má vliv tehdy, je-li původní blok bez chyby. Je-li
přitom zapnuto (Y), pak nahrávání nepokračuje, dokud není nově
nahrávaný blok shodný s původním, tj. dojde k synchronizaci
starého a nového souboru. Využívá se při opravách, viz příklad
6.1.
5.2 FUNKCE EDIT
---------------
   Tato funkce slouží pro editaci souboru. Po jejím zvolení se
objeví nová nabídka: RECORD  BLOCK  HEAD.
   RECORD - editace celého souboru na úrovni bloků
   BLOCK  - editace bloku
   HEAD   - editace hlavičky
5.2.1 FUNKCE RECORD
-------------------
   Tato funkce slouží k úpravám souboru po jednotlivých blocích.
Má následující nabídku: DEL  INS  COPY  TO  PACK  LABEL
   DEL - vymaže aktuální blok (na nějž ukazuje kurzor) a ostatní
         zprava přisune
   INS - vloží na místo kurzoru prázdný blok, bloky vpravo od
         kurzoru posune
   TO  - na místě kurzoru se objeví pomocný kurzor TO
   COPY- zkopíruje aktuální blok na místo pomocného kurzoru TO
         a posune kurzor i pomocný kurzor TO na další blok
   PACK- provede komprimaci souboru do 256-ti bytových bloků,
         která se provede od aktuálního bloku až po první blok
         rozdílného typu nebo prázdný blok.
   LABEL-umožňuje měnit typ bloku - zobrazí nabídku HEAD  DATA
         FILE  EOF a podle volby změní typ aktuálního bloku
Poznámka: Pomocný kurzor TO zrušíme dvojnásobným stisknutím T.
5.2.2 FUNKCE BLOCK
------------------
   Tato funkce slouží k opravám a úpravám obsahu jednotlivých
bloků. Pokud ji zvolíme, objeví se v levém horním rohu spodní
třetiny obrazovky blikající kurzor, který určuje byte v aktuál-
ním bloku, na nějž se budou vztahovat další operace. Tímto
kurzorem lze pohybovat pomocí kurzorových šipek se současným
stiskem SHIFTu. Pokud je aktuální blok typu D nebo F, zobrazí
se navíc v prostoru pro hlášky adresa bytu, na nějž kurzor
ukazuje. Pokud je aktuální blok typu D součástí souboru s plat-
nou hlavičkou, která obsahuje údaj o uložení souboru v paměti,
je tato adresa absolutní adresou onoho bytu v počítači. Jinak
určuje jen pořadí bytu v souboru.
   Za posledním bytem aktuálního bloku je značka EOF (pokud má
soubor délku 256 byte, není vidět).
   Nová nabídka obsahuje tyto funkce: DEL  INS  WRITE  FIND
  DEL  - zruší byte na místě kurzoru a celý blok zkrátí
         o jeden byte
  INS  - vloží na místo kurzoru do bloku nulový byte a blok
         o jeden byte prodlouží
  WRITE- slouží k přímému přepisování obsahu bloku. Podle
         přepínače ASCHEX můžeme psát buď znaky ASCII nebo hexa-
         decimální čísla. Znaky ani čísla ničím neoddělujeme
         a jejich řetězec ukončíme klávesou RETURN. Znaky
         a čísla se zapisují od místa kurzoru.
  FIND - slouží k vyhledávání daného řetězce v souboru, hledá
         od polohy kurzoru až po konec souboru - tj. první
         prázdný blok nebo blok typu H či E. Řetězec zadáváme
         jako u předchozího příkazu. Není-li řetězec nalezen,
         vypíše se hlášení 'NOT FOUND  !'.
5.2.3 FUNKCE HEAD
-----------------
   Po volbě této funkce sloužící k úpravám hlavičky se objeví
 nabídka: NAME  TYPE  fROM  LEN  AUTO  SET.
   NAME - slouží ke změně jména souboru, nové jméno zapíšeme
          jako ASCII řetězec o max. délce 9 znaků (je-li
          kratší, ukončíme ho RETURN)
   TYPE - postupným tisknutím klávesy T se mění údaj v hlavičce
          o typu souboru
   FROM - mění údaj v hlavičce o počáteční adrese pro ukládání
          souboru, nový údaj vložíme čtyřmi hexadecimálními
          číslicemi. Pokud stiskneme jiný znak, zůstane zachován
          původní údaj.
   LEN  - mění údaj v hlavičce o délce souboru, vkládá se stej-
          ným způsobem jako u funkce FROM
   AUTO - mění adresu automatického startu souboru, vkládá se
          obdobně jako u funkce FROM. Stiskneme-li při vstupu
          jiný než hexadecimální znak, autostart se zruší !
          Pokud soubor nemá autostart, nezobrazí se na přísluš-
          ném místě žádné číslo.
   SET  - tato funkce zajistí automatické nastavení údajů TYPE,
          a LEN v hlavičce tak, aby odpovídaly skutečnému sou-
          boru, který následuje za hlavičkou. Jinak tento soulad
          není zaručen ! Používá se zejména po změně délky
          souboru. Viz poznámka.
   Poznámka: Změny údajů v hlavičce lze provést i pomocí funkce
BLOCK. Musíme ovšem znát vnitřní strukturu hlavičky - viz [1].
   Poznámka: Pokud nesouhlasí délka souboru za hlavičkou s úda-
jem v hlavičce, upozorňuje na to blikající "L" u délky souboru.
V tom případě použijeme před příkazem SAVE příkaz SET !
5.3 FUNKCE SAVE
---------------
   Funkce SAVE slouží k zaznamenání souboru (nebo souborů)
z paměti na magnetofon. Obsahuje tyto příkazy: SAVE RATE BEEP.
   SAVE - začne ihned nahrávat na magnetofon. Nahrává od
          aktuálního bloku až do prvního prázdného bloku nebo
          do konce paměti. Pozor na to, že údaje v hlavičce
          (zejména délka a typ) by měly být v souladu se
          skutečným souborem ! (viz kap. 5.2.3 - funkce SET)
   RATE - určuje rychlost nahrávání (ACMT baud rate factor),
          při stisku R se údaj cyklicky mění (normálně 21h).
   BEEP - umožňuje nastavit délku zaváděčky u bloků typu H,D,F
          a E. Zobrazí se nabídka HEAD  DATA  FILE.
          HEAD - délka zaváděčky u bloku H (normálně 1Fh)
          DATA - délka zaváděčky u bloku D (normálně 02h)
          FILE - délka zaváděčky u bloků F a E (normálně 0Eh)
          Hodnota se mění obdobně jako u funkce RATE.
5.4 FUNKCE ASCHEX
-----------------
   Tato funkce přepíná zobrazení obsahu aktuálního bloku ve
spodní třetině obrazovky ve formě ASCII znaků nebo hexadecimál-
ních číslic.
5.5 FUNKCE VIDEO
----------------
   Funkce VIDEO slouží k přepínání zobrazení bílé znaky na
černém pozadí - černé znaky na bílém pozadí a naopak.
5.6 ZRYCHLENÉ OVLÁDÁNÍ POMOCÍ CTRL - KDŮ
-----------------------------------------
   Abychom nemuseli neustále složitě přecházet z jednoho menu
do druhého, je možno některé funkce volit přímo stisknutím
kombinace CTRL písmeno. Zde je jejich seznam :
CTRL A ... ASCHEX - přepíná zobrazení
CTRL B ... BLOCK  - editace v bloku
CTRL D ... DEL - vypustí aktuální blok
CTRL F ... FIND  - hledá řetězec
CTRL H ... HEAD  - edituje hlavičku
CTRL I ... INS - vloží prázdný blok
CTRL K ... umístí kurzor na blok č.0
CTRL L ... LOAD - spustí nahrávání z magnetofonu
CTRL P ... PACK  - zhušťuje soubor do 256 byte bloků
CTRL R ... RECORD  - edituje soubor
CTRL S ... SAVE - spustí nahrávání na magnetofon
CTRL V ... VIDEO  - mění barvy zobrazení
6. PŘÍKLADY POUŽITÍ PROGRAMU
----------------------------
6.1 OPRAVA POŠKOZENÉHO SOUBORU
------------------------------
   Stiskneme CTRL L a spustíme magnetofon. Narozdíl od běžných
kopírovacích programů se nahrají všechny bloky, i ty s chybou -
- ty jsou označeny malým písmenem typu. Po nahrání celého soubo-
ru stiskneme RESET. Stiskneme H a S. Nastavíme kurzor na blok
před prvním vadným blokem, nastavíme magnetofon před tento
blok (odhadem) a pomocí opakovaného přehrávání (L spustíme,
RESET zastavíme) se pokusíme nahrát
vadné bloky správně. Máme-li jinou nahrávku souboru, i když
vadnou, použijeme ji, protože je velmi nepravděpodobné, že by
byly oba soubory poškozené na stejných místech.
   Program Mudr Lenka tedy společně se záložní kopií souboru
poskytuje v podstatě 100% bezpečnost proti ztrátě souboru.
   Když se nepodaří opravit některé bloky, můžeme je opravit
nebo zaplnit nulami pomocí CTRL B a W.
   Pak nastavíme kurzor na hlavičku
souboru, spustíme nahrávání a stiskneme CTRL S. Na pásek se
nahrají všechny bloky bez chyb (bez ohledu na velikost písmena).
Tím můžeme zachránit alespoň tu nepoškozenou část souboru.
6.2 PŘEVOD SOUBORU Z EDTASMu DO ASSEMBLERU DUHA
-----------------------------------------------
   Jedná se vlastně o převod souboru s nespojitými daty na spo-
jitý. Nahrajeme soubor ve formátu EDTASMu (pomocí CTRL L). Pak
nastavíme kurzor na poslední blok (E) a stiskneme CTRL D. Dále
nastavíme kurzor na první blok za hlavičkou a stiskneme CTRL P
a L. Potom tisknutím D změmíme všechny bloky na typ D.
  Pak nastavíme kurzor na hlavičku souboru a stiskneme CTRL H.
Stiskneme S. Pomocí F nastavíme počátek souboru na 9000H (není
nutné). Pak spustíme  magnetofon  a  stisknutím  CTRL  S  soubor
nahrajeme.