AmigaDOS - komendy

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 operacy
jny
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 rozka
z 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ą KICKSTAR
TU 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)

ENDSKIP - kończy blok SKIP

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 podany
ch 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)


<

^