Addebuffers Ask
Assign Avail
Binddrivers Break
Changetaskpri Cd
Conclip Copy
Cpu Date
Delete Dir
Diskcopy Diskchange
Ed Edit
Else
Endcli Endif
Endshell Endskip
Eval Execute
Failat Fault
Fault Filenote
Get Getenv
Iconx If
Info Install
Iprefs Join
Lab Loadwb
List Lock Makedir Makelink
Mount Newcli
Newshell Path
Prompt Protect
Quit Relabel
Remrad Resident
Run Search
Set Setclock
Setdate Setenv
Setfont Setpatch
Skip Sort
Stack Status
Type Version Wait Which
Why
Do
komunikacji z użytkownikiem AmigaDos używa się programu SHELL lub CLI, który
znajduje się w katalogu System Workbencha. Zasada obsługi przypomina trochę
obsługę MS-DOS używanego w komputerach klasy PC i na tym kończą
się podobieństwa tych dwóch systemów.

Kody urządzeń
AmigaDos posiada swój własny system nazewnictwa urządzeń wejścia/wyjścia.
CON: - okno (np. okno SHELL)
DF0: - wewnętrzna stacja dyskietek
DF1: - kolejna, dołączona do systemu stacja dysków
DF2: - kolejna, dołączona do systemu stacja dysków
DF3: - kolejna, dołączona do systemu stacja dysków
SYS: - dysk, z którego został załadowany system operacyjny
PAR: - dowolne urządzenie podłączone do złącza równoległego
SER: - dowolne urządzenie podłączone do złącza szeregowego
PRT: - podłączona do dowolnego złącza drukarka
RAM: - dostęp do pamięci jako dysku - RamDisk
* : - aktywne okno
NIL: - urządzenie pełniące rolę śmietnika na bezużyteczne dane. Wszelkie dane przesłane do
niego są likwidowane
Praca
z konsolą SHELL
Okno Shell jest urządzeniem, w którym następuje komunikacja użytkownika z systemem DOS. Okno to jest specjalnego rodzaju - nie mogą być w nim wyświetlane ikony. Po otwarciu tego okna zostaje w pamięci utworzony bufor o wielkości 20 kB, w którym przechowywane są użyte przez użytkownika polecenia. Aby powtórzyć użytą wcześniej komendę, wystarczy nacisnąć klawisz kursora "w górę".
Parametry, z jakimi otwiera się okno Shell mogą być zmienione przy pomocy opcji Information z rozwijanego menu Workbencha. Po wybraniu ikony Shell uruchom Information. W polu Tool types wpisz:
WINDOW=CON:x/y/wys/szer/tytuł/OPCJE
CON: - kod okna w nazewnictwie AmigaDos
x - współrzędna x górnego, lewego rogu okna Shell
y - współrzędna y górnego, lewego rogu okna
wys - wysokość okna (mierzona w punktach)
szer - szerokość okna (mierzona w punktach)
tytuł - tytuł okna - dowolny ciąg znaków o długości do 30 znaków
OPCJE
dodatkowe parametry pracy okna Shell
AUTO
okno otworzy się automatycznie, jeżeli któryś z pracujących
programów będzie wymagał wprowadzenia lub wyświetlenia danych
CLOSE
okno będzie posiadać wszystkie standardowe gadżety (okno dysku
- gadżet zamknięcia, głębokości, skalowania itp.)
BACKDROP
okno będzie otwierać się jako tło pod wszystkimi innymi
otwartymi oknami
NOBORDER
okno nie będzie posiadać żadnej ramki
NODRAG
okno nie może być przesuwane
NOSIZE
okno nie będzie posiadać gadżetu skalowania wielkością okna
SIMPLE
powoduje, że po zmianie wielkości okna tekst zawarty w nim
pozostanie w niezmienionej postaci - nie dopasuje się do nowych
rozmiarów okna
WAIT
spowoduje, że okno będzie mogło zostać zamknięte tylko gadżetem
zamknięcia okna, nie poleceniem Endcli lub Endshell
Inną cechą okna Shell jest komenda ALIAS, która umożliwia przypisanie nowej nazwy poleceniu AmigaDos
Składnia:
ALIAS nazwa polecenia
Parametr:
nazwa - nowa nazwa polecenia AmigaDos
polecenie - rozkaz AmigaDos ujęty w cudzysłów
Przykład:
ALIAS D1 "DIR DF1:"
powoduje, że każdorazowe wpisanie D1 będzie traktowane jako
rozkaz DIR DF1:
Polecenia AmigaDOS
COPY źródło cel - tworzy kopię pliku lub katalogu o podanym tytule
DELETE nazwa [ALL] - kasuje pliki lub katalogi. Z opcją ALL kasuje całą zawartość katalogu
DIR napęd - wyświetla zawartość dyskietki lub dysku twardego. Sama komenda DIR wyświetla listing plików w aktualnie używanym katalogu - najczęściej SYS: (zobacz kody urządzeń)
DISKCOPY źródło TO cel - kopiuje całą dyskietkę
ED nazwa - uruchamia edytor tekstu. Wpisanie ED bez nazwy nie uruchomi edytora, należy w tedy zastosować ED cyfra
EDIT nazwa - uruchamia edytor liniowy. Edytor liniowy EDIT jest nieco zmutowaną wersją edytora ED.
FILENOTE
plik komentarz - dopisuje
komentarz do nazwy
pliku. Komentarz ten wyświetlany jest podczas wykonywania
na przykład polecenia DIR, które powoduje wyświetlenie listy
zbiorów katalogu
JOIN
nazwa1
nazwa2 AS nazwa3 - łączy kilka plików w jeden, nazwa1,2 to
pliki które mają zostać połączone, a nazwa3
to plik końcowy
LIST katalog - wyświetla informacje o podanym katalogu i zawartych w nim plikach
LOCK napęd ON/OFF - zabezpiecza dysk przed zapisem
MAKEDIR nazwa - tworzy nowy katalog
MAKELINK tytuł1 tytuł2 - tworzy połączenie pomiędzy plikami. Umożliwia komunikację dwóch plików np. dwóch skryptów AmigaDos
PROTECT tytuł +/- bit - ustala rodzaj zabezpieczenia dla zbioru
+/- - wyłączenie lub włączenie danego bitu
bit - określenie bitu zabezpieczenia
R - bit odczytu pliku
W - bit zapisu do pliku
E - bit określający, czy plik jest plikiem wykonywalnym
D - bit określający, czy plik może zostać skasowany
RELABEL napęd nazwa - zmienia tytuł dysku - nadany podczas formatowania
SEARCH nazwa łańcuch - poszukuje łańcucha znaków w podanym pliku lub katalogu
SORT
nazwa1
nazwa2 - sortuje alfabetycznie linie pliku tekstowego. Sortuje
według pierwszych liter każdej linii. Jeżeli pierwsze litery są
takie same, to o kolejności decyduje druga litera i tak dalej.
Linie rozpoczynające się cyframi znajdują się
na początku posortowanego tekstu. Nazwa1 to plik do sortowania,
a nazwa2 to plik posortowany.
TYPE
tytuł - wyświetla
zawartość pliku tekstowego w oknie AmigaDos. Gdy tekst nie mieści
się w oknie jest przewijany,
aby to zatrzymać należy nacisnąć prawy klawisz myszy
WHICH plik - podaje ścieżkę dostępu (pełny tytuł) pliku
Komendy
sterujące systemem
ADDEBUFFERS napęd
bufor - tworzy podaną ilość buforów cache przyśpieszających
pracę z dyskiem. Instrukcja ta w zasadzie powinna być
umieszczona na początku każdego pliku rozkazowego ponieważ zwiększa
szybkość pracy z
napędem. Niestety każdy z buforów to pewien obszar pamięci,
który zostaje zarezerwowany i w związku z tym "wyłączony"
z powszechnego użytku. Jeden bufor
to 256 bajtów, lecz dodanie do każdego
napędu kilku buforów powoduje już spore spustoszenie w pamięci
komputera. Należy więc stosować tę instrukcję biorąc pod
uwagę pojemność pamięci komputera,
na którym jest używana.
ASSIGN urządzenie katalog - przypisuje urządzenie logiczne konkretnemu katalogowi.
AVAIL - wyświetla ilość dostępnej aktualnie pamięci
BINDDRIVERS -
odczytuje sterowniki dołączonych do systemu urządzeń i ustala
konfigurację systemu. Umieszcza się ją zwykle w pliku STARTUP-SEQUENCE
ponieważ ten plik wykonywany jest podczas uruchomienia systemu.
Po wykonaniu polecenia BINDDRIVERS system "pamięta"
konfigurację aż do oczyszczenia pamięci - Reset.
CHANGETASKPRI priorytet
[numer_procesu] -
zmienia priorytet wybranego procesu AmigaDos. System operacyjny Amigi umożliwia pracę w tzw.
multitastingu, czyli daje możliwość działania wielu programom
jednocześnie w różnych rozdzielczościach i osobnych ekranach Workbencha. Procesy AmigDos (uruchamiane
poleceniem RUN) mają swoje priorytety. Dzięki temu np. sprawdzenie przez system, czy w napędzie
znajduje się dyskietka nie przerywa pracy
działającego programu - proces, na którym pracuje program ma
wyższy priorytet niż proces, który powoduje sprawdzenie obecności
dyskietki w napędzie (wartość priorytetu: od -127 do
128)
CONCLIP - umożliwia kopiowanie zawartości jednego okno SHELL do innego
CPU - rozpoznaje zainstalowany w komputerze mikroprocesor i dopasowuje do niego pracę systemu.
DATE [data] [czas] [TO plik] - wyświetla lub ustawia aktualną datę i czas systemowy
data - data w formacie dd-msc-rr:
dd - numer dnia miesiąca
msc - trzyliterowe określenie nazwy miesiąca:
jan - styczeń
feb - luty
mar - marzec
apr - kwiecień
may - maj
jun - czerwiec
jul - lipiec
aug - sierpień
sep - wrzesień
oct - październik
nov - listopad
dec - grudzień
rr - dwie ostatnie cyfry roku
czas - godzina w formacie gg:mm:
gg - godzina (w systemie 24-godz.)
mm - minuty
TO plik - określa tytuł pliku przy którym ma być ustawiona data. Pominięcie tego
parametru powoduje wyświetlenie daty na ekranie i ustawienie w zegarze
systemowym
DISKCHANGE napęd - informuje system o zmianie dyskietki w stacji 5.25 cala (tylko w wypadku jej dołączenia). Jest to konieczne tylko podczas pracy bezpośrednio z AmigaDos.
INFO - wyświetla informacje o dostępnych dyskach
INSTALL napęd [FFS] - instaluje w bootblocku (pierwszych dwóch sektorach dyskietki) bloki niezbędne do startu systemu z tej dyskietki (cztery pierwsze bajty bootblocku ustawione jako DOS0)
IPREFS - ustawia konfigurację Workbencha według konfiguracji zapisanej w katalogu ENV-ARC. Konfiguracja zapisywana jest w katalogu przez programy z katalogu PREFERENCES. Tymi też programami może ona zostać zmieniona.
LOADWB - rozpoczyna pracę Workbencha
MOUNT urządzenie - informuje Amigę o przyłączeniu nowego urządzenia do systemu. Urządzenie to musi być jednak opisane w pliku MOUNTLIST znajdującym się w katalogu DEVS i mieć swój sterownik, również w tym katalogu.
REMRAD - usuwa z pamięci ramdysk RAD
RESIDENT [rozkaz] - odczytuje z katalogu C rozkaz AmigaDos i umieszcza go w pamięci jako polecenie rezydentne. Dzięki temu nie musi on być odczytywany z dysku
SETCLOCK load/save/reset - ustawia lub odczytuje stan zegara czasu rzeczywistego.
load - ustawia czas systemowy zgodnie z zegarem czasu rzeczywistego
save - ustawia zegar czasu rzeczywistego zgodnie z zegarem systemowym
reset - kasuje aktualne ustawienie zegara czasu rzeczywistego
SETDATE plik data czas - zmienia datę przy nazwie pliku
SETPATCH - likwiduje błędy w różnych wersjach ROM różnych
systemów operacyjnych. Poszczególne wersje
systemów operacyjnych KICKSTART różniły się od siebie
kilkoma parametrami. W związku z tym niektóre programy napisane
np. na KICKSTARCIE 1.2 nie pracują pod kontrolą KICKSTARTU 2.0. Polecenie SETPATCH likwiduje różnice
pomiędzy różnymi wersjami systemów operacyjnych.
VERSION - wyświetla numer wersji Workbencha i Kickstartu.
Komendy
sterujące procesami SHELL
BREAK proces [all] [c] [d] [e] [f] - pozwala na ustalenie jakimi kombinacjami klawiszy będzie można przerwać dany proces Dosa.
proces - numer procesu
all - ustawia wszystkie znaczniki
c - przerwanie przez CTRL-C
d - przerwanie przez CTRL-D
e - przerwanie przez CTRL-E
f - przerwanie przez CTRL-F
CD katalog - ustala podany katalog jako aktualny (powrót do poprzedniego katalogu: CD / )
ENDCLI, ENDSHELL - kończą proces Dos
FAULT n - wyświetla komunikat błędu o podanym kodzie
GET zmienna - podaje wartość lokalnej zmiennej środowiskowej. Lokalna zmienna środowiskowa to zmienna, która występuje tylko w jednym procesie AmigaDos, np. w pliku STARTUP-SEQUENCE. Może być liczbą, tytułem pliku lub nazwą jakiejś operacji, którą wykonuje proces AmigaDos.
GETENV zmienna - podaje wartość globalnej zmiennej środowiskowej
NEWCLI, NEWSHELL - rozpoczyna pracę nowego procesu Dos
PATH [ADD ścieżka] [RESET] - sprawdza, kasuje lub dodaje katalogi do aktualnej ścieżki dostępu do plików (RESET - kasuje ścieżki)
PROMPT wzór - zmienia wskaźnik gotowości Dosa
RUN polecenie - wykonuje podane polecenie jako jeden z procesów Dos
SET nazwa opis - definiuje zmienną lokalną
nazwa - nazwa, pod którą ma występować zmienna
opis - pojęcie, które ma być przyporządkowane zmiennej
SETENV nazwa opis - definiuje zmienną globalną (znaczenie parametrów takie jak w SET)
SETFONT czcionka wielkość [ITALIC] [BOLD] [UNDERLINE] - ustala czcionkę używaną przez SHELL
STACK [rozmiar] - wyświetla lub ustawia rozmiar stosu. Stos jest rejestrem procesora, na którym odkładane są dane wysłane przez kod programu
STATUS
- podaje
informacje o procesach Dosa. Polecenie wyświetla informacje o
priorytecie procesu, rozmiarze
dostępnej dla procesu pamięci, nazwach sekcji w liście segmentów
procesu i wielkości wektorów globalnych procesu
WHY - podaje komunikat błędu wyjaśniając jego przyczynę
Polecenia
w plikach rozkazowych
ASK pytanie - czeka na wprowadzenie przez użytkownika odpowiedzi na pytanie podane jako argument polecenia. Umożliwia odpowiedzi: Y - po tej odpowiedzi sekwencja rozkazów będzie wykonywana nadal i N - wykonywanie pliku rozkazowego zostanie przerwane
ELSE - wyznacza alternatywny warunek w bloku warunkowym (zobacz IF)
ENDIF - kończy blok warunkowy IF (zobacz IF)
EVAL działanie - oblicza proste działania matematyczne i podaje wynik
EXECUTE plik - powoduje uruchomienie pliku rozkazowego (skryptu)
FAILAT kod - umożliwia ustawienie "granicy błędu" dla procesu CLI. W razie wystąpienia błędu o kodzie równym lub wyższym niż podany w argumencie rozkazu działania procesu
kod - kod błędu procesu AmigaDos
5 - ostrzeżenie o możliwości wystąpienia błędu
10 - instrukcja nie wykonania do końca
20 - wykonanie instrukcji nie możliwe na przykład z powodu błędnych parametrów
FAULT - drukuje komunikat błędu przerywając pracę procesu
ICONX - umożliwia uruchomienie pliku rozkazowego (skryptu) za pomocą ikony z poziomu Workbencha. Powinna być wpisana na początku sekwencji rozkazów przeznaczonej do uruchamiania w ten sposób
IF funkcja - sprawdza warunek podczas wykonywania pliku rozkazowego
IF funkcja
.
.
[ELSE]
.
.
[ENDIF]
Funkcja:
NOT - neguje wynik porównania EQ
WARN - spełnia warunek w razie wystąpienia błędu o kodzie większym lub równym 5
(ostrzeżenie o możliwości wystąpienia błędu)
ERROR - spełnia warunek przy wystąpieniu błędu, którego kod jest większy lub
równy 10 (instrukcja nie wykonana do końca)
FAIL - spełnia warunek jeżeli kod zaistniałego błędu jest większy lub równy 20
(wykonanie instrukcji niemożliwe np. z powodu błędnie podanych parametrów)
txt1 EQ txt2 - warunek jest spełniony, gdy pliki TXT1 i TXT2 są identyczne (do
stosowania w przypadku plików tekstowych)
EXISTS nazwa - warunek jest spełniony jeżeli istnieje plik nazwa
ELSE - po tym poleceniu następują polecenia alternatywne wykonywane w razie, gdy
warunek po IF jest niespełniony
ENDIF - koniec pętli warunkowej
LAB nazwa - ustala etykietę dla skoku wykonywanego po instrukcji SKIP
QUIT n - przerywa pracę procesu generując błąd o podanym kodzie (patrz Komunikaty o błędach)
SKIP etykieta - powoduje skok do etykiety określonej przez LAB
WAIT [n] [SEC/MINS] [UNTIL czas] - zatrzymuje na podany czas działanie komputera
n - ilość sekund lub minut. WAIT bez parametrów czeka 1 sekundę
SECS lub SEC - określa, że n oznacza sekundy
MINS lub MIN - określa, że n oznacza minuty
UNTIL czas - powoduje czekanie do określonej godziny (zapis w formacie gg:mm)