                              AFTER 3.5
                              ---------
                     autorzy: K.A.Ziembik i Z.Bk
                            ROHAR 1994-96
                          program Freeware

           Ostatnia zmiana w programie: 29 wrzenia 1996 r.
           Ostatnia zmiana w dokumencie: 7 wrzenia 1998 r.



1. Co to jest?
   -----------

     AFTER  (skrt od Atari Files TransfER) to system  dwukierunkowego 
przenoszenia  danych pomidzy Atari XL/XE i Atari ST/STE z  prdkoci 
przewyszajc  modemy dostpne dla maego Atari i to za  uamek  ceny 
nawet najtaszego modemu. W wersji 3.5 osignelimy transmisj 8 KB na 
sekund  przy  przesyaniu  danych i okoo  0.5  KB/s  gdy  przesyany 
program  ma by potem uruchomiony na "maluchu".  Jedyne  wymagania  to 
ST/STE z minimum 0.5 MB RAM i XL/XE z minimum 64 KB RAM.
     Co mona zyska dziki AFTER-owi,  oprcz dobrej zabawy w wymian 
danych  midzy duym i maym Atari?  Mona na przykad  trzyma  pliki 
XL/XE na trwalszych dyskietkach 3.5 cala, albo na twardym dysku, ktry 
jest prostszy do zdobycia dla ST/STE ni dla XL/XE. Mona archiwizowa 
dane wielokrotnie szybciej i wygodniej programami dla duego Atari,  a 
dopiero potem przenosi na XL/XE.  Mona przygotowa  grafik,  muzyk 
czy tekst. Mona zrobi wiele innych rzeczy...
      System AFTER skada si z czci sprztowej i  programowej,  ale 
autorzy  rozpowszechniaj  tylko  t  drug.  Cz  sprztow,  czyli 
interfejs, uytkownik systemu AFTER musi zdoby we wasnym zakresie (w 
dalszej  czci tego dokumentu zawarte s informacje jak go  wykona). 
Autorzy  nie roszcz sobie adnych pretensji do interfejsu,  tak  wic 
moe  on  by  wykonany  w dowolnej  liczbie  kopii,  nawet  w  celach 
komercyjnych.  Jednoczenie  nie bior na siebie adnej  odpowiedzial- 
noci za jego dziaanie.
     Cz programowa jest FREEWARE - mona kopiowa j dowoln  ilo 
razy,  przekazywa kademu,  rozpowszechnia wszdzie, gdzie si da, a 
take  uywa jak i kiedy si chce,  ale zabroniona  jest  jakakolwiek 
interwencja w kod programu i dokumentacj bez zgody grupy ROHAR.



2. Z czego si skada?
   -------------------

     W wersji 3.5 system AFTER bdzie dziaa jeli uytkownik posiada 
wspomniany   interfejs   oraz  dyskietk  przeznaczon   dla   ST/STE, 
zawierajc w kartotece AFTER.3_5 nastpujce pliki:

     AFTER.PRG  - uruchamialny program,    \   pliki
     AFTER.TXT  - dokument, ktry czytasz, / dla ST/STE
     AFTER.COM  - uruchamialny program, \
     AFTER1.INI - uruchamialny program,  \  pliki
     AFTER2.INI - uruchamialny program,   >  dla
     AFTER3.INI - uruchamialny program,  /  XL/XE
     AFTER4.INI - uruchamialny program. /

     Do  prawidowego dziaania programu na ST/STE przydatna jest  te 
nakadka  udostpniajca polskie znaki narodowe w standarcie Klubu  ST 
(np.  MacroFont, Mikoaj Rej, PRO Polonica, Polonus, Polskie znaki). W 
ostatecznoci mona si bez niej oby, ale opcje i komunikaty programu 
mog si sta nieczytelne.



3. Jak przygotowa system?
   -----------------------

     Aby  mie  cay system AFTER naley  najpierw  zdoby  interfejs. 
Zamiast kupowa gotowy, mona wykona go we wasnym zakresie, poniewa 
nie  jest  to  skomplikowana  konstrukcja.   Moe  j  wykona   nawet 
niedowiadczona osoba.  Potrzebne s dwa gniazda 9-pin eskie  (DB9), 
jedno   25-pin   mskie  (DB25)  oraz   odpowiednia   ilo   przewodu 
(przynajmniej  szecioyowego),  ktry  najlepiej  podzieli  na  dwa 
odcinki dugoci okoo 1 metra kady.  Przy pomocy zwykego  lutowania 
naley poczy je w nastpujcy sposb:

     +-------------+-------------------+----------------------+
     |  znaczenie  | gniazdo 9-pin (A) |    gniazdo 25-pin    |
     +-------------+-------------------+----------------------+
     |   dana 0    |         1         |          2           |
     |   dana 1    |         2         |          3           |
     |   dana 2    |         3         |          4           |
     |   dana 3    |         4         |          5           |
     |   strobe    |         6         |          1           |
     |    masa     |         8         | dowolnie od 18 do 25 |
     |             +-------------------+                      |
     |             | gniazdo 9-pin (B) |                      |
     |             +-------------------+                      |
     |   dana 4    |         1         |          6           |
     |   dana 5    |         2         |          7           |
     |   dana 6    |         3         |          8           |
     |   dana 7    |         4         |          9           |
     |    masa     |         8         | dowolnie od 18 do 25 |
     +-------------+-------------------+----------------------+

     Po  zakoczeniu  montau  naley wtyk 25-pin  umieci  w  porcie 
Printer,  znajdujcym si oczywicie w ST/STE, a 9-pin (A) i 9-pin (B) 
odpowiednio  w   portach 1 i 2 joystickw Atari  XL/XE.  Od  tej  pory 
strona sprztowa systemu AFTER jest gotowa do pracy.
     Dalej trzeba si zaj programami komunikacyjnymi,  ktre  zapew- 
ni  synchronizacj  komputerw oraz transmisj  danych  midzy  nimi. 
Jeden z tych programw,  AFTER.PRG dla ST/STE,  jest od razu gotowy do 
uycia, poniewa znajduje si na dysku do tego komputera. Jednak drugi 
program,  AFTER.COM  dla XL/XE,  najpierw musi zosta przeniesiony  na 
dysk dla maego Atari.  Aby tego dokona trzeba wpisa i uruchomi  na 
maym Atari nastpujcy programik w Basicu (przed numerami wierszy  s 
kody kontrolne Basica, ktrych nie naley wpisywa):

     (GY) 10 REM *****************
     (VB) 20 REM *   AFTER.BAS   *
     (PL) 30 REM *   ROHAR 1994  *
     (HB) 40 REM *****************
     (ED) 50 DIM A$(16):ADDR=1536
     (MM) 60 FOR I=1 TO 32:READ A$
     (SO) 70 FOR J=1 TO 16 STEP 2:GOSUB 100
     (ZH) 80 POKE ADDR,BAJT:ADDR=ADDR+1
     (JB) 90 NEXT J:NEXT I:X=USR(1768):END
     (PK) 100 BH=ASC(A$(J,J))-48:BH=BH-7*(BH>9)
     (EQ) 110 BL=ASC(A$(J+1,J+1))-48:BL=BL-7*(BL>9)
     (ME) 120 BAJT=BH*16+BL:RETURN
     (TC) 130 DATA A2FF8EE2028EE302
     (PZ) 140 DATA E820B80620960620
     (IJ) 150 DATA C906208506853120
     (WW) 160 DATA 85068530207D0685
     (ME) 170 DATA 32207D0685332532
     (LL) 180 DATA C9FFF0F0207D0685
     (WC) 190 DATA 34207D0685354C3F
     (YP) 200 DATA 06E632D002E63320
     (ZL) 210 DATA 7D06A0009132A535
     (IE) 220 DATA C533D0EDA534C532
     (KI) 230 DATA D0E7ADE2022DE302
     (VU) 240 DATA C9FFF01420AA0620
     (ZB) 250 DATA E206209606A9FF8D
     (MS) 260 DATA E2028DE30220C906
     (UG) 270 DATA A5300531D0A620AA
     (DG) 280 DATA 0620E50660A530D0
     (UN) 290 DATA 02C631C630AD10D0
     (HB) 300 DATA D0FBAD00D38D1AD0
     (TP) 310 DATA AE10D0F0FB6078A5
     (GZ) 320 DATA 108DAB06A9008510
     (XL) 330 DATA 8D0ED28D0ED48D00
     (WE) 340 DATA D460A9FF85108D0E
     (ND) 350 DATA D2A9C08D0ED45860
     (WS) 360 DATA AD02D329FB8D02D3
     (SB) 370 DATA 8E00D309048D02D3
     (FH) 380 DATA 60A2FF20B806A955
     (FS) 390 DATA 8D00D3AD10D0D0FB
     (RR) 400 DATA AD10D0F0FBA2004C
     (VU) 410 DATA B8066CE2026CE002
     (JY) 420 DATA 68A9208DE802A9FF
     (ER) 430 DATA 8DE602A9FF8D01D3
     (KV) 440 DATA 4C0006F0F0F0F0F0

     Nastpnie uruchamiamy na ST/STE program AFTER.PRG, opcj "Odczyt" 
wczytujemy do pamici plik AFTER.COM,  potem ustawiamy opcj "Do  uru- 
chomienia"  w  menu "Parametry",  a na  koniec  wybieramy  "Wysanie". 
Transmisja  potrwa krtk chwil.  Po jej zakoczeniu uruchomi si  na 
XL/XE program AFTER.COM,  o ktry nam chodzio.
     Naley jednak zadba,  by AFTER.COM na stae zagoci na  jakiej 
dyskietce  dla XL/XE.  Dlatego trzeba wybra w nim  opcj  "Odebranie" 
(klawisz  O,  potem  wpisa nazw AFTER.COM  i  potwierdzi  klawiszem 
Return), na ST/STE ustawi "Do przesania", a pniej ponownie wczy 
"Wysanie".  Znowu  odbdzie si transmisja pliku AFTER.COM,  ale  tym 
razem zostanie on zapisany na dysku XL/XE.
     Nastpny krok to zresetowanie maego Atari i wczytanie  AFTER.COM 
z  dyskietki  (uwaga - jest to wane,  bo  AFTER.BAS,  z  ktrego  by 
odpalany  AFTER.COM,  troch miesza w wektorach systemowych i  dlatego 
potrzebna  jest ponowna inicjalizacja).  Po uruchomieniu  AFTER.COM  z 
dysku nie bdzie ju adnych kopotw i mona przesya,  co si tylko 
spodoba,  cho wskazane bdzie przesanie najpierw plikw  AFTER1.INI, 
AFTER2.INI, AFTER3.INI i AFTER4.INI.
     UWAGA!!!  Jeli  uytkownik  posiada ju AFTER.COM  lub  pliki  z 
rozszerzeniem  INI  na  swoim XL/XE (na  przykad  dosta  od  kolegi, 
cign z BBS-u czy Internetu) to oczywicie nie musi ich przenosi.



4. Opis programu na ST/STE
   -----------------------

     AFTER  dla  ST/STE  nie jest  skomplikowany  w  uyciu,  poniewa 
wykorzystuje GEM.  Po uruchomieniu, w grnej czci ekranu pojawia si 
listwa, ktra udostpnia wszystkie opcje:

Atari
-----
     AFTER     - najwaniejsze informacje o programie.

Plik
----
     Odczyt    - odczyt pliku  z dysku do pamici. Plik moe mie mak- 
                 symalnie  360  kilobajtw  (256 kilobajtw na  ST/STE 
                 z 0.5 MB),  niezalenie od pojemnoci  pamici RAM  w 
                 maym Atari.

     Zapis     - zapis pliku z pamici na dysk.  Opcja jest nieaktywna 
                 jeli w pamici nie ma adnego pliku.

     Odebranie - odebranie  pliku przesyanego  interfejsem  z  XL/XE. 
                 Plik  moe mie do 360 KB (256),  jeli  jednak  jest 
                 duszy ni 32 KB to transmisja przebiega na raty  (w 
                 blokach  po 32 KB).  Podczas  przesyania  danych  na 
                 ekranie migaj kolorowe paski.  Opcja jest  wyczona 
                 gdy plik jest przeznaczony do uruchomienia na XL/XE.

     Wysanie  - wysanie pliku z pamici przez interfejs.  Opcja jest 
                 nieaktywna,  gdy nie ma pliku w  pamici.  Transmisj 
                 sygnalizuj paski, mona j przerwa naciskajc spac- 
                 j.  Rwnie tutaj przesyanie pliku duszego ni 32 
                 KB odbywa si w blokach po 32 KB.

    Informacje - pokazuje nazw pliku  w pamici,  jego dugo  dzie- 
                 sitnie i szesnastkowo.

     Wolne  KB - pokazuje  ilo wolnej pamici RAM i wolnego  miejsca 
                 na aktualnie uywanym dysku.

     Dugo   - pokazanie dugoci wybranego pliku w bajtach.

     Kasowanie - kasowanie wybranego pliku.

     Wyjcie   - wyjcie z programu.

Parametry 
---------
-Rodzaj pliku-
     Do przesania  - standardowo  ustawiony sposb transmisji.  W tym 
                      trybie  plik  moe by przesyany  z  ST/STE  do 
                      XL/XE lub odwrotnie. 

    Do uruchomienia - Po ustawieniu tego trybu transmisja bdzie prze- 
                      biega  tylko w jednym  kierunku,  z  ST/STE  do 
                      XL/XE,  ale po przesaniu plik zostanie  automa- 
                      tycznie uruchomiony na XL/XE (o ile jest to mo- 
                      liwe,  to znaczy plik jest uruchamialnym progra- 
                      mem  o standardowej strukturze).  W tym celu  na 
                      XL/XE naley uruchomi nie AFTER.COM, lecz jeden 
                      z  plikw o rozszerzeniu INI - w dalszej  czci 
                      dokumentu wyjanione jest czym si one rni.

-Maska-
     Przezroczysta  - przezroczysta  maska (*.*)  dla operacji  dysko-
                      wych.

     Ostatnio uyta - maska  z rozszerzeniem ostatnio uytym przy  ko- 
                      rzystaniu z dysku.



5. Opis programu na XL/XE
   ----------------------

     O  ile  na  ST/STE wystarczy uruchomi  AFTER.PRG  i  gotowe,  po 
stronie maego Atari sytuacja jest nieco bardziej  skomplikowana.  Nie 
wystarczy   jeden  program  by  zarwno  przesya  pliki  jak  i   je 
uruchamia  (ze wzgldu na ilo RAM-u).  Std podzia  na  AFTER.COM, 
ktry  suy  do transmisji danych,  oraz pliki z  rozszerzeniem  INI, 
ktre   maj  za  zadanie  uruchamianie  przesyanych   plikw.   Przy 
dziaajcym AFTER.PRG na ST/STE naley wybra na XL/XE: albo AFTER.COM 
jeli pliki maj by przesyane,  albo ktry z programw  INI,  jeli 
plik ma by uruchomiony.
     Program  AFTER.COM  jest  bardzo  prosty  w  obsudze.  Najlepiej 
uruchomi  go w MYDOS-ie lub SuperDOS-ie,  bo z tymi systemami  zosta 
przetestowany (powinien dziaa na wszystkich DOS-ach, ale nie zostao 
to sprawdzone. Po uruchomieniu na ekranie pojawia si kilka informacji 
o  programie  oraz  cztery  opcje  wybierane  klawiszami  podanymi   w 
nawiasie:

(W) Wyslanie   - wysanie pliku o podanej nazwie.  Mona pomin ozna- 
                 czenie urzdzenia,  gdy jest to stacja  dyskw.  Plik 
                 moe mie maksymalnie 360 (256) kilobajtw, ale jeli 
                 jest duszy ni 32 KB to bdzie przesyany na raty.

(O) Odebranie  - odebranie  pliku  przez  interfejs i zapisanie go pod 
                 podan nazw.

(*)  Katalog   - pokazanie  katalogu dyskietki (jeli spis nie  mieci 
                 si na ekranie,  naley uy klawiszy Control i 1  do 
                 zatrzymania przewijania).

(Esc) Wyjscie  - wyjcie z programu do DOS-u.

     Jeli jednak celem uytkownika nie jest przesyanie danych i  ich 
zapis  na  dysku,  ale uruchomienie przesyanego  pliku,  to  powinien 
zosta uruchomiony AFTER1.INI,  AFTER2.INI,  AFTER3.INI lub AFTER4.INI 
(nie maj one adnego menu, pojawia si po prostu pusty ekran).
     W czym tkwi rnica midzy tymi inicjalizerami?  AFTER1.INI suy 
do odpalania wszystkich plikw DOS-owych (a wic gry,  demosy, a take 
uytki   nie  korzystajce  z  DOS-u),   a  AFTER2.INI  do   programw 
korzystajcych  z  DOS-u  (gwnie  uytki,   ale  i  niektre   gry). 
Oczywicie w szczeglnych przypadkach pozostaje poeksperymentowa we 
wasnym zakresie.
     AFTER3.INI   i   AFTER4.INI  s   odpowiednikami   AFTER1.INI   i 
AFTER2.INI,  ale  przy transmisji zamiast paskw wywietlaj  normalny 
obraz.  Dziki  temu  mona widzie co si dzieje na  ekranie  podczas 
adowania.



6. Przesyanie plikw
   ------------------

     A. Transmisja z XL/XE na ST/STE
        ----------------------------
     Uruchamiamy  program  AFTER.PRG  na duym Atari, a  AFTER.COM  na 
maym.  Na  XL/XE  wybieramy opcj "Wysanie" (klawisz W)  i  podajemy 
nazw  istniejcego pliku,  ktry chcemy  przesa,  potwierdzajc  na 
koniec  klawiszem  Return.  Na  ST/STE  wybieramy  opcj  "Odebranie". 
Komputery przeprowadz transmisj.  Pozostanie jedynie zapisa plik na 
dyskietce ST/STE.

     B. Transmisja z ST/STE na XL/XE
        ----------------------------
     Analogicznie  jak  wyej,   uruchamiamy  AFTER.PRG  i  AFTER.COM. 
Nastpnie  wybieramy "Odebranie" (O) i podajemy nazw pod jak ma  by 
zapisany  plik  po odebraniu.  Na ST/STE wybieramy  opcj  "Odczyt"  i 
wczytujemy plik do przesania a nastpnie opcj "Wysanie".  Komputery 
przeprowadz transmisj, a XL/XE zapisze plik na dysku.

     Oba  rodzaje  transmisji  (A  i  B)  naley  przeprowadza   przy 
wczonej opcji "Do przesania" w menu "Parametry"!

     C. Transmisja z ST/STE na XL/XE i uruchomienie
        -------------------------------------------
     Uruchamiamy program AFTER.PRG na ST/STE,  a na XL/XE  AFTER1.INI, 
AFTER2.INI, AFTER3.INI lub AFTER4.INI - zaley to od rodzaju programu, 
ktry chcemy uruchomi i od tego,  czy chcemy mie podczas  transmisji 
paski  czy  nie.  Na ST/STE wczytujemy plik do  uruchomienia,  w  menu 
"Parametry"  wybieramy  opcj "Do uruchomienia",  a nastpnie  w  menu 
"Plik" opcj "Wysanie". To wszystko.

     Jeeli  kolejno operacji w ktrymkolwiek z rodzajw  transmisji 
nie zostanie zachowana, to nie ma si czym martwi, bo programy czeka- 
j na siebie wzajemnie,  i dopki jeden z komputerw nie jest  gotowy, 
to  drugi  nie  zacznie  wysya  danych.  W  przypadku  jakichkolwiek 
kopotw naley pamita, e na ST/STE przesyanie danych przerywa si 
spacj, a na XL/XE klawiszem Shift.



7. Kopoty
   -------

     Programy  same  sygnalizuj rnego  rodzaju  bdy,  ale  jeeli 
transmisja  nie przebiega prawidowo lub interfejs w ogle nie  dziaa 
naley sprawdzi czy:

     - interfejs zosta prawidowo wykonany,
     - przewd interfejsu nie jest uszkodzony,
     - ktry z komputerw nie jest uszkodzony,
     - programy nie s uszkodzone,
     - styki w zczach nie s zabrudzone lub wygite,
     - czy zostay wybrane prawidowe opcje w programach,
     - kocwki interfejsu podczone do portw joystickw nie s 
       zamienione.



8. Przyszo
   ----------

     Ju niedugo (niedugo - pojcie wzgldne) bdzie gotowa  kolejna 
wersja  AFTER-a,  o  wiele wygodniejsza,  a jednoczenie  z  wikszymi 
moliwociami. Midzy innymi przewidujemy przesyanie caych kartotek, 
a  nie  tylko pojedynczych plikw,  rozmiary przesyanego  pliku  bd 
ograniczone  jedynie  pojemnoci  dysku  i  pamici  RAM  w  ST/STE, 
zwikszy si szybko transmisji,  a co najwaniejsze,  ST/STE  bdzie 
traktowane  jako dodatkowe urzdzenie do maego Atari (bdzie mona  z 
niego  korzysta  jak  z bardzo szybkiej i pojemnej  stacji  dyskw  i 
ogromnego RAM-dysku).
     System AFTER mona w prosty sposb rozszerzy na inne  komputery, 
np.  na Commodore 64,  Commodore Amiga (oraz wszelkie, ktre posiadaj 
programowalne  porty  joystickw).  Potrzebni s  jednak  programici, 
ktrzy  napisz  programy  komunikacyjne  na  te  maszyny.  Oczekujemy 
propozycji,   moemy  zaoferowa  programy  rdowe  w  GFA   Basicu, 
assemblerze 6502 i 68000 oraz informacje o zasadach dziaania.



9. Podzikowania
   -------------

     Do  powstania AFTER-a przyczyniy si nastpujce  osoby,  ktrym 
grupa ROHAR chciaaby podzikowa:
     - Witek Warczak (monta eksperymentalnego interfejsu),
     - Mr.Q oraz ZBX Virus z grupy Pentagram (entuzjazm motywujcy nas 
       do pracy),
     - Arek Torski (udostpnienie sprztu do DTP).



10. Korespondencja
    --------------

     Wszelk  korespondencj  dotyczc  naszych  programw,   pytania 
dotyczce ich dziaania, informacje o wykrytych bdach, sugestie, jak 
je ulepszy oraz pytania o najnowsze programy ROHAR-u naley  kierowa 
na jeden z poniszych adresw:

     KAZ
     ---
     ul. Wojrowicka 46/26
     54-436 Wrocaw
     e-mail: kziembik@wroc.net
             kaz@online.pl
     Zyga
     ----
     Doboszowice 52
     57-241 Doboszowice
     e-mail: bak@mvax.pwr.wroc.pl

     Pamitaj  jednak  o tym,  by do listu  doczy  zaadresowan  do 
siebie  kopert  i  wany  znaczek.  Tylko  wtedy  moemy  gwarantowa 
odpowied.  Jeli  chcesz otrzyma najnowsz wersj jakiego  programu 
musisz do koperty i znaczka doda dyskietk (3.5 cala jeli ma to  by 
dla ST/STE, a 5.25 cala gdy dla XL/XE).

     Miego korzystania z programu.
