Dodatek A
KOMUNIKATY BŁĘDÓW

Poniżej podana jest lista kodów i komunikatów błędów, które mogą wystąpić podczas użytkowania SpartaDOS X. Niektóre z błędów są sygnalizowane przez większość poleceń SpartaDOS X w formie komunikatów (co wskazano przez cudzysłowy). Inne programy wskazują błędy tylko w formie liczbowych kodów (dziesiętnie lub szesnastkowo). Po każdym kodzie i meldunku błędu znajduje się opis prawdopodobnej przyczyny tego błędu. Wszystkie błędy o kodach mniejszych niż 128 ($80) powstają w programach aplikacyjnych (Basic, Action! itp.) i nie są powodowane przez SpartaDOS X.

128 $80 "User break abort"
Nacisnąłeś klawisz <BREAK>, gdy komputer czekał na informacje lub wysyłał dane na ekran. <BREAK> nie przerywa operacji dyskowych SpartaDOS X, lecz wiele programów jest przerywanych po zakończeniu operacji dyskowej, jeżeli był naciśnięty ten klawisz.

129 $81 "File already open"
Próbowałeś otworzyć do zapisu plik, który jest już otwarty. Może to wystąpić, jeżeli spróbujesz skopiować plik na niego samego. Na przykład: I

COPY MYFILE

Ponieważ standardowym plikiem docelowym jest "*.*", to wystąpi błąd. Poprzednie wersje SpartaDOS nie sprawdzały tego, więc łatwo można było nieodwracalnie zniszczyć plik przy pomocy COPY. Błąd ten może również wystąpić przy otwieraniu pliku przez CIO, jeżeli kanał IOCB nie był poprawnie zamknięty. Problem ten występuje w niektórych programach. Command Processor sprawdza czy IOCB jest zamknięty, więc nie może być w nim takich błędów.

130 $82 (Non existant device)
Użyta przez Ciebie specyfikacja urządzenia nie istnieje. Poprawnymi identyfikatorami są w SpartaDOS X: DSK:, CAR:, CLK:, PRN:, CON:i COM:. W CIO poprawnymi urządzeniami są: D:, E:, C:, S:, K:, R: i P:. Oczywiście, mogą być dodane dalsze urządzenia, lecz tu podane są urządzeniami standardowymi.

131 $83 (Chanel or IOCB not open for input)
Próbowałeś czytać z pliku, który był otwarty do zapisu (tryb 8 lub 9). Błąd ten wskazuje na pomyłkę w programie.

132 $84 "No device handler installed" (Bad CIO command)
Próbowałeś wywołać CIO z niewłaściwym kodem rozkazu. Pamiętaj, że wszystkie kody powyżej 13 są uważane za wywołania XIO i nie sygnalizuje tego błędu, lecz zamiast niego "No function in device handler". Błąd ten świadczy o pomyłce w programie. Możesz także otrzymać taki błąd, gdy wywołasz urządzenie, które nie ma zainstalowanej procedury obsługi, np. COM:.

133 $85 (Channel or IOCB not open)
Próbowałeś wykonać operację zapisu lub odczytu przez IOCB lub kanał SpartaDOS X, który nie został otwarty. Wskazuje to na błąd w programie.

134 $86 (Bad IOCB number)
Wywołałeś CIO z niewłaściwym numerem IOCB w rejestrze X. Użyty numer IOCB musi być pomnożony przez 16. Wskazuje to na błąd w programie.

135 $87 (Channel or IOCB not open for output)
Próbowałeś zapisać do pliku, który był otwarty tylko do odczytu (tryb 4). Błąd ten wskazuje na pomyłkę w programie.

136 $88 (End Of File)
W rzeczywistości nie jest to błąd, lecz wskazanie końca pliku. Status ten może być wskazany tylko przez funkcje odczytu korzystające z CIO. System SpartaDOS X sprawdza status EOF w inny sposób.

137 $89 (Truncated record error)
Wskazuje, że odczytany rekord był dłuższy niż przeznaczony dla niego bufor. Status ten może być wskazany tylko przez funkcje odczytu korzystające z CIO. System SpartaDOS X sprawdza go w inny sposób.

138 $8A "Drive not present"
Próbowałeś użyć stacji dysków, która nie istnieje, jest wyłączona lub odłączona. Przyczyną może być także zmiana numeru Twojej stacji (patrz opis polecenia SWAP). Sprawdź przewody zasilające i połączeniowe oraz menu Multi I/O (jeśli jest zainstalowane).

139 $8B "Drive NAK"
Ten błąd może wystąpić w następujących przypadkach:

140 $8C (Serial framing error)
Błąd ten wskazuje nieprawidłową komunikację między komputerem i stacją dysków. Najprawdopodobniej konieczne będzie oddanie komputera lub stacji do serwisu. Możliwe jest także sygnalizowanie tego błędu, po napotkaniu wadliwego sektora, lecz zdarza się to bardzo rzadko.

142 $8E (SIO Serial bus overrun error)
Błąd ten wskazuje nieprawidłową komunikację między komputerem i stacją dysków. Najprawdopodobniej konieczne będzie oddanie komputera lub stacji do serwisu. Możliwe jest także sygnalizowanie tego błędu, po napotkaniu wadliwego sektora, lecz zdarza się to bardzo rzadko.

143 $8F (SIO Checksum error)
Błąd ten wskazuje nieprawidłową komunikację między komputerem i stacją dysków. Najprawdopodobniej konieczne będzie oddanie komputera lub stacji do serwisu. Możliwe jest także sygnalizowanie tego błędu, po napotkaniu wadliwego sektora, lecz zdarza się to bardzo rzadko.

144 $90 "Write protected or bad sector"
Podczas odczytu z dyskietki błąd ten wskazuje wadliwy sektor. Natomiast podczas zapisu sygnalizuje, że dyskietka jest zabezpieczona przed zapisem lub nie istnieje sektor, który SpartaDOS X próbował zapisać (zarówno z powodu złej konfiguracji przy formatowaniu jak i z powodu złego nagłówka sektora). Jeżeli dyskietka będzie zabezpieczona przez Multi I/O, to będzie sygnalizowany błąd "Drive NAK".

146 $92 "No function in device handler"
Próbowałeś wykonać polecenie przez urządzenie, które nie potrafi tego zrealizować. Na przykład: nie można zmieniać nazwy pliku w urządzeniu CAR: lub odczytywać katalogu z PRN:. Na poziomie CIO wskazuje to, że nakazana instrukcja XIO nie istnieje w podanym urządzeniu.

148 $94 "Unrecognized diskette format"
SpartaDOS nie rozpoznaje formatu dyskietki. Jeżeli jest to dyskietka w formacie Atari DOS 2, to sprawdź, czy zainstalowałeś w systemie procedurę ATARIDOS.SYS. Jest on standardowo instalowany, jeśli w stacji numer 1 nie ma dyskietki z plikiem CONFIG.SYS. Jeżeli masz taki plik, to sprawdź, czy zawiera on wiersz "DEVICE ATARIDOS".

150 $96 "Directory not found"
Podałeś katalog, który nie istnieje na dyskietce. Sprawdź podany szlak. Możesz wykonać polecenia kolejno dla każdego katalogu lub zastąpić katalog przez plik.

151 $97 "File exists"
Próbowałeś zapisać plik zabezpieczony, zastąpić plik przez katalog lub zastąpić katalog przez plik.

152 $98 "Not binary file"
Próbowałeś odczytać lub uruchomić plik, który nie jest plikiem binarnym. Może być kilka przyczyn wystąpienia tego błędu:

154 $9A "Loader: symbol not defined"
Loader SpartaDOS X nie możne odczytać programu, ponieważ napotkał symbol, który nie został zdefiniowany. Wskazuje to na konieczność odczytania najpierw odpowiedniej procedury dla uruchomienia programu. Na przykład, polecenie TD.COM wymaga zainstalowania procedury CLOCK.SYS lub JIFFY.SYS. Procedury te definiują symbol o nazwie I-GETTD, który jest wykorzystywany przez TD do odczytu aktualnego czasu i daty.

156 $9C "Bad Parameter"
W poleceniu został podany nieprawidłowy parametr. Sprawdź w opisie, jaka powinna być prawidłowa składnia polecenia.

158 $9E "Out of memory"
Próbowałeś odczytać lub uruchomić polecenie SpartaDOS X, dla którego nie ma wystarczającego obszaru pamięci. Upewnij się czy nie ma programów "zatrzymanych" w pamięci (patrz polecenie LOAD). Jeżeli stale brak pamięci, to uruchom system z mniejszą liczba procedur.

161 $A1 (Too many channels open)
SpartaDOS X pozwala na równoczesną otwarcie do 16 plików, lecz każde urządzenie ma własne ograniczenia. Procedura DSK: pozwala na użycie maksymalnej ustalonej liczby kanałów (standardowo jest to 5, co powinno wystarczyć dla wszystkich programów). Urządzenie CAR: ma tylko jeden kanał, czyli że nie można kopiować plików z CAR: przy pomocy polecenia COPY. Copy wykorzystuje dwa kanały urządzenia źródłowego i jeden docelowego, ponieważ jeden kanał jest otwierany dla katalogu, a drugi dla kopiowania. Ograniczenie to można ominąć przez użycie polecenia TYPE i skierowanie wyjścia do pliku dyskowego ,np.:

TYPE CAR:COMMAND.COM >>NEWCO"

162 $A2 "Disk full"
Została całkowicie zapełniona dyskietka lub jej katalog. Katalogi SpartaDOS X mieszczą do 1423 plików, więc bardziej prawdopodobne jest zapełnienie dyskietki. Jeżeli nastąpiło to podczas kopiowania, to plik dla którego zabrakło miejsca, jest usuwany z dyskietki.

163 $A3 "Illegal vildcard in name"
Nie możesz użyć jokerów przy modyfikowaniu lub tworzeniu pliku oraz przy tworzeniu podkatalogów. Jokery są dozwolone przy otwieraniu pliku do odczytu i w szlaku katalogu.

165 $A5 "Bad filename"
Wpisana przez Ciebie nazwa pliku zawiera niedozwolony znak. Najczęściej występuje to przy użyciu niewłaściwego znaku w szlaku katalogu lub w poleceniu RENAME.

166 $A6 (Position range error)
Próbowałeś ustawić głowice (POINT) poza końcem pliku, gdy plik został otwarty tylko do odczytu. Wskazuje to błąd w programie lub zbyt dużą wartość parametru w poleceniu DUMP.

167 $A7 "Can't delete directory"
Katalog, który próbowałeś skasować zawiera pliki lub podkatalogi. Musisz skasować wszystkie pliki i podkatalogi włącznie z ukrytymi. UWAGA: Plik otwarty do zapisu lub wymiany, lecz nie zamknięty poprawnie, pozostaje jako "widmowy" wpis w katalogu i uniemożliwia skasowanie tego podkatalogu. Do usunięcia takiego wpisu trzeba użyć programu CLEANUP z zestawu SpartaDOS ToolKit.

170 $AA "File not found"
Poszukiwany przez Ciebie plik nie istnieje na dyskietce. Jeżeli użyłeś polecenia X, to pamiętaj że szlak PATH nie jest teraz stosowany; musisz dopisać szlak do nazwy pliku, jeśli nie znajduje się on w bieżącym katalogu. Błąd ten jest także sygnalizowany, gdy spróbujesz skasować lub zmienić nazwę pliku zabezpieczonego.