D-Filer v1.1¢ kodowanie Jager/Dial¢¢¢ HISTORIA BIBLIOTEKI¢ -------------------¢¢ D-Filer v1.0¢¢ Pierwsza publiczna wersja zainstalowa-¢ na w programie D-Font View v1.0¢¢¢ D-Filer v1.1¢¢ zmiany w stosunku do wersji 1.0¢¢ - poprawne rozpoznanie SpartaDOS X¢¢ - kasowanie flagi BrkKey¢¢ MO⑧LIWO⇦CI¢ ----------¢¢ - obsuga podkatalogw dla MyDOS'a¢ (100%), BW-DOS'a, SpartaDOS (70%)¢¢ - wygodny sposb wskazywania pliku lub¢ podkatalogu¢¢ - zapis z uwzgl❎dnieniem ③cieəki do-¢ st❎pu¢¢ - podstawowe funkcje DOS'u w tym two-¢ rzenie, kasowanie podkatalogu¢¢ - moəliwo③⇨ podania wzoru dla odczytu¢ katalogu¢¢ - moəliwo③⇨ ustawienia kolejno③ci wy-¢ ③wietlania plikw i podkatalogw¢¢ - zainstalowana funkcja OVERWRITE¢¢ - poprawna wsppraca z wi❎kszo③ci⇧¢ DOS'w¢¢¢ WYMAGANIA¢ ---------¢¢ - Atari XL/XE¢¢ - stacja dyskw¢¢ - nie zawysokie MemLo¢¢¢¢¢¢¢¢ OBS{UGA¢ -------¢¢ Po wej③ciu do Filer'a ukazuje si❎¢ nam jego ekran gwny (i jedyny :-) ).¢ Patrz⇧c od gry widzimy:¢¢ 1. ⇦cieək❎ dost❎pu (SOURCE)¢¢ 2. Okno dla nazw plikw i podkatalogw¢ (to najwi❎ksze :-) ) w jego dolnej¢ cz❎③ci znajduj⇧ si❎ mniejsze:¢¢ a) FREE SECTORS - pokazuje ilo③⇨ wo-¢ lnych sektorw¢¢ b) S-DIR - ilo③⇨ podkatalogw w da-¢ nym katalogu/podkatalogu¢¢ c) FILES - ilo③⇨ plikw w danym ka-¢ talogu/podkatalogu¢¢ d) ustawienie opcji d♪wi❎ku podczas¢ transmisji¢¢ 3. Okno SOURCE pokazuje numer stacji¢ ♪rdowej¢¢ 4. Okno TARGET pokazuje numer stacji¢ docelowej¢¢ 5. Okno SUB-DIR pokazuje numer aktual-¢ nego podkatalogu¢¢ 6. Okno MEMLO pokazuje MemLo :-)¢¢ 7. Okno BUFFER pokazuje wielko③⇨ bufo-¢ ra, ktry wykorzystuje opcja COPY¢¢ 8. Okno DISPLAY pokazuje aktualne us-¢ tawienie tej opcji¢¢ 9. Okno (bez nazwy), w ktrym znaj-¢ dziemy informacje o rozpoznanym¢ przez D-Filer'a DOS'ie. Moəliwe s⇧¢ cztery informacje: MyDOS, BW-DOS,¢ SpartaDOS, Atari DOS - czyli kaədy¢ inny¢¢ 10. Na samym dole znajduje si❎ linia¢ komunikacji z uəytkownikiem. W tej¢ linii takəe pojawia⇨ si❎ b❎d⇧¢ wszystkie komunikaty, pytania i¢ informacje¢¢ Aby nie powtarza⇨ za kaədym razem¢ sposobu wprowadzania danych, potwie-¢ rdzania operacji itp. spraw opisz❎ je¢ teraz.¢¢ Wpis danych¢ -----------¢¢ czyli np. podawanie nazwy pliku/pod-¢ katalogu, ③cieəki dost❎pu, podkatalogu¢ do stworzenia itp.¢¢ Aktywne klawisze to:¢¢ DELETE - kasowanie ostatniego znaku¢¢ SHIFT+DELETE, CONTROL+DELETE, CLEAR-¢ kasowanie caej linii¢¢ RETURN - akceptacja¢¢ ESC - wyj③cie (rezygnacja)¢¢ Dost❎pne znaki: 0-9, A-Z, *_?.:>¢¢¢ Potwierdzenie operacji [OK]¢ -----------------------------¢¢ RETURN lub Y - wykonaj¢ inny klawisz - przerwij¢¢¢ Przy komunikatach¢ -----------------¢¢ RETURN, ESC, Y - wyj③cie¢¢ inne nie s⇧ aktywne¢¢¢ Przy odpowiedziach na pytania¢ -----------------------------¢¢ ESC - przerwij (wyj③cie)¢ Y - tak¢¢ inny to wybranie odpowiedzi NIE¢¢¢ Wybr nazwy¢ -----------¢ Operacje t⇧ umoəliwiaj⇧ klawisze , .¢¢¢ ⇦cieəki dost❎pu¢ ---------------¢ Dla stacji ♪rdowej bufor wynosi 256¢ bajtw. Nie jest on ustawiony "na¢ sztywno", a wi❎c ilo③⇨ moəliwych do¢ odczytania podkatalogw uzaleəniona¢ jest od dugo③ci nazwy danego podkata-¢ logu. W praktyce moəliwe jest wej③cie¢ do ok. 20-22 podkatalogw. My③l❎ əe¢ powinno wystarczy⇨? W przypadku gdy¢ bufor zostanie zapeniony, wej③cie do¢ kolejnego podkatalogu, lub (UWAGA)¢ odczyt pliku nie zostanie wykonany!¢ Odpowiedni komunikat ukaəe si❎ w linii¢ komunikacyjnej.¢¢ ⇦cieəka na ekranie pokazywana jest tak¢ aby zawsze bya widoczna jak najwi❎-¢ ksza ilo③⇨ OSTATNICH podkatalogw. Tak¢ wi❎c na pocz⇧tku (po np. D1:) mog⇧ wy-¢ st⇧pi⇨ trzy kropki informuj⇧ce o tym¢ iə widoczna jest tylko cz❎③⇨ ③cieəki.¢¢ ⇦cieəka docelowa to tylko to co moəna¢ b❎dzie wpisa⇨ po np. D1:. Tak wi❎c ma-¢ my jedynie moəliwo③⇨ wpisania 20 zna-¢ kw. W wi❎kszo③ci wypadkw zupenie to¢ wystarczy, cho⇨ w przyszo③ci by⇨ moəe¢ ulegnie to zmianie (na gorsze :-) ).¢¢ Jeəeli program uzna iə po dodaniu na-¢ zwy pliku ③cieəka b❎dzie duəsza to¢ odpowiednio zredukuje j⇧ do postaci¢ Dx:xxxxxxxx.xxx¢¢¢¢ OPCJE FILERA¢ -------------¢¢ Odczyt katalogu gwnego¢ ------------------------¢ Wywoanie: õ-¨¢¢ Opcja umoəliwia odczyt (lub natychmia-¢ stowy powrt) gwnego katalogu dysku,¢ ktry znajduje si❎ w stacji ♪rdowej¢ (SOURCE).¢¢¢ Od③wierzenie katalogu/podkatalogu¢ ---------------------------------¢ Wywoanie: צסIJבד¢¢ Opcja podobna do poprzedniej z t⇧ rə-¢ nic⇧ iə pod uwag❎ brana jest ③cieəka¢ dost❎pu.¢¢ Wzr dla odczytu katalogu/podkatalogu¢ -------------------------------------¢ Wywoanie: ס lub ¬¢¢ Opcja umoəliwia podanie wzoru, ktry¢ zostanie wzi❎ty pod uwag❎ podczas¢ odczytu katalogu/podkatalogu. Standa-¢ rdowy wpis to: *.*, ktry oznacza iə¢ zostan⇧ odczytane i wy③wietlone wszy-¢ stkie pliki znajduj⇧ce si❎ w danym ka-¢ talogu/podkatalogu. Naleəy zwraca⇨ na¢ to uwag❎ aby unikn⇧⇨ niepotrzebnego¢ stresu - pliki byy... i zniky :-).¢¢ Wej③cie do podkatalogu/Odczyt pliku¢ -----------------------------------¢ Wywoanie: פדקרפמ¢¢ Program automatycznie rozpozna co¢ chcemy zrobi⇨ i jeəeli naci③niemy ten¢ klawisz na podkatalogu to zostanie¢ automatycznie wywoana opcja odczytu¢ katalogu/podkatalogu. W przypadku pli-¢ ku nast⇧pi jego odczyt.¢¢ Wyj③cie z danego podkatalogu¢ ----------------------------¢ Wywoanie: דצב¢¢ Opcja umoəliwia powrt do poprzednie-¢ go podkatalogu lub powrt do katalogu¢ gwnego (w kaədym przypadku zostanie¢ on odczytany ponownie z dysku).¢¢ Szybka zamiana stacji ♪rd. na docel.¢ -------------------------------------¢ Wywoanie: חמשדפצד¢¢ Krtko mwi⇧c stacja SOURCE otrzyma¢ numer stacji TARGET, ponowne naci③ni❎-¢ cie klawisza odwraca sytuacj❎ (chyba¢ logiczne). Naleəy pami❎ta⇨ o tym iə¢ zamieniony zostaje tylko numer stacji,¢ a wi❎c ③cieəka dost❎pu pozostaje bez¢ zmian! Umoəliwia to automatyczne wej-¢ ③cie do tego samego podkatalogu (o ile¢ istnieje) w stacji docelowej (jeəeli¢ go tam nie b❎dzie to ukaəe si❎ komu-¢ nikat z b❎dem i naleəy wtedy przy po-¢ mocy klawiszy 1-9 "r❎cznie" wywoa⇨¢ gwny katalog).¢¢ Sposb wy③wietlania nazw¢ ------------------------¢ Wywoanie: בכדIJפ, חמצדפק, גדכדקד¢¢ Przy pomocy tych trzech klawiszy de-¢ cydujemy o tym co chcemy aby pierwsze¢ byo pokazywane (bez wzgl❎du na to jak¢ jest zapisane w VTOC). Informacja o¢ ustawieniu pokazana jest w oknie¢ DISPLAY. Oto trzy moəliwe kombinacje:¢¢ 1. SUB-DIRS - pierwsze w oknie nazw¢ b❎d⇧ pokazane podkatalogi, a nast❎-¢ pnie pliki (klawisz CLEAR).¢¢ 2. FILES - pierwsze b❎d⇧ pokazane pli-¢ ki, a po nich podkatalogi (klawisz¢ INSERT).¢¢ 3. NO CHANGE - bez zmian, wszystko zo-¢ stanie pokazane tak jak jest zapi-¢ sane w VTOC (klawisz DELETE) - ka-¢ kalog/podkatalog zostanie ponownie¢ odczytany.¢¢ Tworzenie nowego podkatalogu¢ ----------------------------¢ Wywoanie: ל¢¢ Opcja "mwi" chyba wszystko. Po wywo-¢ aniu wpisujemy nazw❎ podkatalogu i¢ potwierdzamy to RETURN'em. Klawisz ESC¢ umoəliwia przerwanie tej operacji.¢¢ Kasowanie pliku/podkatalogu¢ ---------------------------¢ Wywoanie: ג¢¢ Przed wywoaniem opcji naleəy wskaza⇨¢ nazw❎ pliku/podkatalogu! Po wywoaniu¢ opcji program poprosi o potwierdzenie¢ naszej decyzji i o ile b❎dzie to od-¢ powied♪ pozytywna nast⇧pi kasowanie.¢¢ רתIJוIJí Przed skasowaniem podkatalogu¢ naleəy si❎ upewni⇨ czy jest on pusty,¢ gdyə tylko taki moəe by⇨ skasowany! W¢ innym przypadku ukaəe si❎ b⇧d!¢¢ Zmiana nazwy pliku/podkatalogu¢ ------------------------------¢ Wywoanie: פ¢¢ Podobnie jak w poprzedniej opcji,przed¢ wywoaniem naleəy wskaza⇨ nazw❎, ktr⇧¢ chcemy zmieni⇨. Po wywoaniu podajemy¢ now⇧ nazw❎ (lub poprawiamy star⇧) i¢ potwierdzamy to RETURN'em. Wyj③cie z¢ opcji umoəliwia ESC. Funkcja nie jest¢ "idioto-odporna", a wi❎c potwierdzenie¢ STAREJ nazwy jako NOW① spowoduje...¢ zamian❎ starej... na now⇧ :-)¢¢ רתIJוIJí W przypadku podkatalogw opc-¢ ja dziaa w 100% pod MyDOS'em! Nieste-¢ ty w przypadku BW-DOS'a i SpartaDOS¢ s⇧ problemy (przeczytaj י√נסנקך).¢¢¢ Zabezpiecz/Odbezpiecz plik/podkatalog¢ -------------------------------------¢ Wywoanie: כ-Lock, ר-UnLock¢¢ Opcja chyba nie wymaga əednego opisu!¢ Kopiowanie pliku¢ ----------------¢ Wywoanie: ב¢¢ Przed wywoaniem naleəy wskaza⇨ plik i¢ potwierdzi⇨ to klawiszem RETURN. Po¢ tej operacji w dolnej cz❎③ci ekranu¢ (linia komunikatw) ukaəe si❎ nam¢ docelowa ③cieəka dost❎pu. Jeəeli odpo-¢ wiada nam ona to ponownie naciskamy¢ RETURN, a jeəeli nie to moəemy wpisa⇨¢ j⇧ od nowa (lub poprawi⇨ tylko nazw❎).¢ Jeəeli chcemy zmieni⇨ stacj❎ docelow⇧¢ to moəna skorzysta⇨ z kombinacji¢ SHIFT+1-9. ESC umoəliwia wyj③cie.¢¢ Jeəeli stacja ♪rdowa i docelowa maj⇧¢ ten sam numer to program wy③wietli py-¢ tanie czy b❎dzie to ten sam dysk (umo-¢ əliwia to kopiowanie z jednego podka-¢ talogu do drugiego). Ukaəe si❎ pytanie¢ SAME DISK? Jeəeli tak jest to naciska-¢ my ך jeəeli nie (chcemy skopiowa⇨ plik¢ na inny dysk) to naciskamy inny kla-¢ wisz (najlepiej מ). Nast❎pnie rozpo-¢ cznie si❎ odczyt pliku do bufora. Po¢ odczytaniu caego pliku lub zapenie-¢ niu bufora moəe pojawi⇨ si❎ kolejny¢ komunikat: INSERT TARGET DISK, o ile¢ na pytenie SAME DISK odpowiedzieli③my¢ negatywnie. Po zmianie dysku naciska-¢ my RETURN i rozpocznie si❎ zapis. W¢ pierwszej kolejno③ci program sprawdzi¢ czy aby plik o podanej nazwie juə nie¢ istnieje. Jeəeli tak b❎dzie to ukaəe¢ si❎ kolejny komunikat: FILE ALREADY¢ EXISTS. RETURN spowoduje iə stary plik¢ zostanie skasowany i w jego miejsce¢ nagrany zostanie aktualnie kopiowany,¢ natomiast ESC umoəliwi przerwanie za-¢ pisu. Po nagraniu caego bufora (o ile¢ cay plik nie zosta odczytany) ukaəe¢ si❎ pro③ba o woəenie dysku ♪rdowego¢ i po potwierdzeniu rozpocznie si❎ po-¢ nownie odczyt. Oczywi③cie pro③by o¢ zmian❎ dysku nie b❎d⇧ wyst❎powa⇨ gdy¢ stacje b❎d⇧ miay inne numery.¢¢ W przypadku wyst⇧pienia b❎du odpowie-¢ dni komunikat ukaəe si❎ na ekranie.¢¢ D♪wi❎k podczas transmisji w⇧cz/wy⇧cz¢ --------------------------------------¢ Wywoanie: צ¢¢ Literka S informuje əe d♪wi❎k b❎dzie¢ w⇧czony, brak jej əe wy⇧czony.¢¢ Informacja o wersji D-Filer'a¢ -----------------------------¢ Wywoanie: ח¢¢ Warto w przyszo③ci zwrci⇨ na to uwa-¢ g❎ gdyə D-Filer napewno b❎dzie jeszcze¢ modyfikowany, a to moəe wprowadzi⇨ pe-¢ wne zmiany w jego obsudze i zasad¢ pracy.¢¢ Powrt do programu gwnego¢ ---------------------------¢ Wywoanie: קIJא, בנמקפנכ½דצב¢¢ Jak wspomniaem D-Filer to biblioteka,¢ a wi❎c b❎dzie on wykorzystywany w rə-¢ nych programach. Powrt (bez əadnej¢ reakcji ze strony Filera) umoəliwiaj⇧¢ wymienione wyəej klawisze.¢¢ K{OPOTY¢ -------¢¢ Wyst❎puj⇧ one w momencie gdy pracu-¢ jemy pod kontrol⇧ BW-DOS'a oraz¢ SpartaDOS i usiujemy zmieni⇨ nazw❎¢ podkatalogu. Krtko mwi⇧c NIE moəemy¢ tego zrobi⇨! Przy kaədorazowej prbie¢ wykonania tej operacji D-Filer wy③wie-¢ tli nam komunikat o b❎dzie 170 (plik¢ nie istnieje). Prawd❎ mwi⇧c nie mam¢ poj❎cia dlaczego tak si❎ dzieje. By⇨¢ moəe uəywam zej komendy (innej nie-¢ stety nie znam). W dokumentacji do¢ BW-DOS'a oraz SpartaDOS X nikt o tym¢ nie wspomina! Oczywi③cie jest sposb¢ na realizacj❎ tego zadania inn⇧ metod⇧¢ (omijaj⇧c procedury DOS'u - mao ele-¢ ganckie, ale skuteczne). Moim zdaniem¢ nie jest to jednak opacalne (bufor¢ napewno by si❎ zmniejszy). Z tego teə¢ powodu zrezygnowaem z tej metody.¢¢ Druga sprawa to sama obsuga pod-¢ katalogw. Jak wszyscy wiedz⇧ DOS'y¢ Sparto-podobne po wpisaniu komendy¢ DIR wy③wietlaj⇧ znacznie wi❎cej info-¢ rmacji o danym pliku niə standardowa¢ komenda Atari DOS. Oczywi③cie w Spa-¢ rtaDOS moəna uzyska⇨ TAKI SAM "wydruk"¢ katalogu jak w Atari DOS uəywaj⇧c ko-¢ mendy DIRS. Jak si❎ okazuje nie jest¢ to tak do koca prawd⇧. Wszystko jest¢ w porz⇧dku do momentu gdy w danym ka-¢ talogu/podkatalogu nie ma kolejnych¢ podkatalogw, ktre oprcz nazwy po-¢ siadaj⇧ takəe rozszerzenie. W takim¢ wypadku wygl⇧da to tak: odczytuj⇧c ka-¢ talog poleceniem DIR wszystko jest w¢ porz⇧dku tz. pokazywana jest nazwa¢ oraz rozszerzenie danego katalogu. Po¢ uəyciu komendy DIRS wy③wietlana zosta-¢ je tylko nazwa, natomiast w miejsce¢ rozszerzenia wpisywane jest גחפ w in-¢ wersji.¢¢ D-Filer (i inne programy, ktre nie s⇧¢ pisane spacjalnie dla SpartaDOS) wy-¢ korzystuj⇧ standardowe wywoanie pro-¢ cedury odczytu katalogu tz. do aux1=6,¢ a do aux2=0. Otrzymany w ten sposb¢ katalog NIE zawiera rozszerze dla¢ podkatalogw. Aby uzyska⇨ peny kata-¢ log naleəy wpisa⇨ do aux2 warto③⇨ 128¢ lub wi❎ksz⇧. Niestety wi⇧əe si❎ to z¢ tym iə trzeba zupenie inaczej napisa⇨¢ procedurk❎ "obrabiaj⇧c⇧" tak otrzymany¢ katalog! Moim zdaniem sposb informo-¢ wania o tym iə dana nazwa to nazwa¢ katalogu nie zosta odpowiednio prze-¢ my③lany. Wystarczyo przecieə zastoso-¢ wa⇨ metod❎ podobn⇧, a nawet tak⇧ sam⇧¢ jak⇧ stosuje MyDOS (przecieə w Sparcie¢ ten bajt i tak pozostaje pusty). By⇨¢ moəe w przyszo③ci ten "kopocik" zo-¢ stanie usuni❎ty w D-Filer'ku.¢¢ Podsumowuj⇧c. Poza ZMIAN① NAZWY POD-¢ KATALOGU reszta operacji na podkatalo-¢ gach jest moəliwa pod warunkiem iə da-¢ ny podkatalog nie zawiera rozszerze-¢ nia!¢¢ ⑧aden z opisanych problemw NIE doty-¢ czy MyDOS'a!¢¢ autor biblioteki¢ Jager/Dial¢