Polecenia AmigaDOS

1. Failat
2. Fault
3. FF
4. FileNote
5. Format
6. Get
7. GetEnv
8. IconX
9. IF
10. Info
11. Install
12. IPrefs
13. Join
14. Lab
15. List
16. LoadResource
17. LoadWB
18. Lock
19. MagTape
20. MakeDir
21. MakeLink
22. Mount
23. NewCLI
24. NewShell
25. Path
26. Prompt
27. Protect
28. Quit
29. Relabel
30. RemRAD
31. Rename
32. RequestChoice
33. RequestFile
34. Resident
35. Run
36. Search
37. Set
38. SetClock
39. SetDate
40. SetEnv
41. SetFont
42. SetKeyboard
43. SetMap
44. SetPatch (43.4)
45. SetPatch (44.38 - AOS 3.9 BB2)
46. SetPatch (AOS 1.3)
47. Skip
48. Sort
49. Stack
50. Status
51. Type
52. UnAlias
53. UnSet
54. UnSetEnv
55. Version
56. Wait
57. Which
58. Why

---

Failat

Opis:

Pozwala określić wysokość błędu FAIL, przerywającego działanie skryptu AmigaDOS (domyślne wartości błędów zwracane przez polecenia ADOS: 0 - OK, 5 - WARN, 10 - ERROR, 20 - FAIL)

Występuje:

Wszystkie wersje AmigaOS

Format:

Failat RCLIM/A

Parametry:

RCLIM

numer określający przerwanie działania skryptu

Przykład:

Failat 21

---

Fault

Opis:

Wyświetla opis podanego numeru błędu

Występuje:

Wszystkie wersje AmigaOS

Format:

Fault ERROR/N/M

Parametry:

ERROR

numer błędu

Przykład:

Fault 212
"Fault 221: Disk is full" (Dysk pełny)

---

FF

Opis:

Przyśpiesza wyświetlanie tekstu w starszych systemach

Występuje:

AmigaOS 1.3 (i wcześniejsze)

Format:

FF

Parametry:

Brak

Przykład:

FF

---

FileNote

Opis:

Dodaje komentarz do pliku

Występuje:

Wszystkie wersje AmigaOS

Format:

Filenote FILE/A COMMENT ALL/S QUIET/S

Parametry:

FILE

plik, do którego chcesz dodać komentarz

COMMENT

komentarz, który chcesz dodać do pliku

ALL

dodaj komentarz do wszystkich plików

QUIET

nie wyświetlaj komunikatów

Przykład:

FileNote adresy.doc "Adresy ludków"

---

Format

Opis:

Przygotowywanie dyskietek/dysków itd. do pracy z AmigaDOS

Występuje:

Wszystkie wersje AmigaOS

Format:

Format DEVICE=DRIVE/K/A NAME/K/A OFS/S FFS/S INTL=INTERNATIONAL/S NOINTL=NOINTERNATIONAL/S DIRCACHE/S NODIRCACHE/S NOICONS/S QUICK/S:

Parametry:

DEVICE|DRIVE

nazwa napędu do sformatowania

NAME

nazwa którą chcesz nadać dyskietce/partycji

OFS

sformatuj używając Original File System

FFS

sformatuj używając Fast File Systemu

INTL|INTERNATIONAL

tryb FFS International (bezużyteczny w Polsce)

NOINTL|NOINTERNATIONAL

wyłącz tryb International dla FFS

DIRCACHE

włącza obsługę buforowania katalogów

NODIRCACHE

wyłącza obsługę buforowania katalogów

NOICONS

nie założy Trashcanu

QUICK

szybkie formatowanie

Przykład:

Format DRIVE DF0: NAME "Dokumenty" NOICONS FFS

---

Get

Opis:

Pobiera zawartość zmiennych lokalnych

Występuje:

AmigaOS 2.0 i nowsze

Format:

Get NAME/A

Parametry:

NAME

nazwa zmiennej lokalnej

Przykład:

Get RC

---

GetEnv

Opis:

Pobiera zawartość zmiennych globalnych

Występuje:

AmigaOS 1.3 i nowsze

Format:

GetEnv NAME/A

Parametry:

NAME

nazwa zmiennej globalnej

Przykład:

GetEnv Workbench

---

IconX

Opis:

Pozwala na uruchomienie skryptu AmigaDOS w Workbenchu, po dwukliku na ikonę skryptu.
Skrypt musi posiadać ikonę typu Project, ze wpisanym w pole Default Toll poleceniem C:IconX

Występuje:

AmigaOS 1.3 i nowsze

Format:

IconX

Parametry:

Brak

Przykład:

Brak

---

IF

Opis:

Rozpoczyna blok warunkowy IF...ELSE...ENDIF w skrypcie ADOS

Występuje:

Wszystkie wersje AmigaOS

Format:

IF NOT/S WARN/S ERROR/S FAIL/S EQ/K GT/K GE/K VAL/S EXISTS/K

Parametry:

NOT

odwraca znaczenie warunku

WARN

sprawdza czy poprzedzające IF polecenie /komenda ADOS zwróciła kod błędu 5 (Warn)

ERROR

sprawdza czy poprzedzające IF polecenie /komenda ADOS zwróciła kod błędu 10 (Error)

FAIL

sprawdza czy poprzedzające IF polecenie /komenda ADOS zwróciła kod błędu 20 (Fail)

EQ

sprawdza czy dana wartość (np. zmiennej) równa się podanej wartości - porównuje zarówno liczby, jak i ciągi znaków

GT

sprawdza czy wartość jest większa od zadanej wartości

GE

test czy większy lub równy danej wartości

VAL

traktuje wprowadzone/pobrane dane jako liczby

EXISTS

sprawdza, czy dany plik istnieje

Przykład:

IF EXISTS S:User-Startup
  Echo "User Startup już istnieje"
ELSE
  Ed S:User-Startup
ENDIF

---

Info

Opis:

Wyświetla informacje o dyskach

Występuje:

Wszystkie wersje AmigaOS

Format:

Info DEVICE/A

Parametry:

DEVICE

nazwa urządzenia

Przykład:

Info RAM:

---

Install

Opis:

Zapisuje bootblock na dysk. Jeśli masz tylko jedną stację dysków to wpisz w CLI polecenie

Install ?

co uruchomi polecenie, ale go nie wykona, następnie zmień dyskietkę na tą, na którą chcesz nagrać bootblock i wpisz DF0: i naciśnij Enter

Występuje:

Wszystkie wersje AmigaOS

Format:

Install DEVICE/A NOBOOT/S CHECK/S FFS/S

Parametry:

DEVICE

dysk, na którym zainstalowany ma być bootblock

NOBOOT

kasuje bootblock

CHECK

sprawdza, czy na dyskietce znajduje się bootblock

FFS

użyj Fast File Systemu

Przykład:

Install DF1:

---

IPrefs

Opis:

Wczytuje preferencje ustawione przez programy w AmigaOS 2.0 i nowszych

Występuje:

AmigaOS 2.0 i nowsze

Format:

IPrefs

Parametry:

Brak

Przykład:

IPrefs

---

Join

Opis:

Łączy dwa lub więcej plików w jeden

Występuje:

Wszystkie wersje AmigaOS

Format:

Join FILE/M/A AS=TO/K/A

Parametry:

FILE

pliki do połączenia

AS|TO

musi zawsze występować, określa nazwę pliku wynikowego. W ADOS 1.3 i starszych używa się TO - w nowszych systemach używa się AS

Przykład:

Join Supergra_cz1.adf Supergra_cz2.adf Supergra_cz3.adf AS Supergra.adf

---

Lab

Opis:

Określa etykietę (zakładkę) pozwalającą znaleźć dany blok skryptu ADOS. Dzięki temu polecenie SKIP może znaleźć dany blok i skoczyć do niego

Występuje:

Wszystkie wersje AmigaOS

Format:

Lab LABEL

Parametry:

LABEL

nazwa etykiety

Przykład:

LAB petla
  Eval $count + 1 to env:count
  Echo $count
  Echo ""
IF $count EQ 100
  Echo "Zakończyłem pętlę"
ELSE
  SKIP petla BACK
ENDIF

---

List

Opis:

Wyświetla zawartość katalogu

Występuje:

Wszystkie wersje AmigaOS

Format:

List DIR/M P=PAT/K KEYS/S DATES/S NODATES/S TO/K SUB/K SINCE/K UPTO/K QUICK/S BLOCK/S NOHEAD/S FILES/S DIRS/S LFORMAT/K ALL/S

Parametry:

DIR

katalog lub katalogi do wylistowania

P|PAT

wyświetla informacje o podanym pliku/katalogu pod warunkiem, że go znajdzie - w przeciwnym wypadku nie wyświetla niczego, nie zgłaszając błędu (zwraca kod błędu 0)

KEYS

wyświetla numer bloku, w którym znajduje się nagłówek pliku lub katalog

DATES

wyświetla datę utworzenia obiektu

NODATES

nie wyświetla informacji o dacie

TO

plik lub urządzenie, do którego zostanie przekierowany wynik działania polecenia

SUB

wyświetla informacje o plikach/katalogach, które zawierają w swojej nazwie fragment podanego ciągu znaków (np. polecenie

List DH0: SUB .i

wyświetli informacje o wszystkich plikach i katalogach zawierających w swojej nazwie ciąg znaków '.i' - czyli m.in. o disk.info itd.)

SINCE

wyświetli informacje o obiektach, które zostały utworzone/ostatnio aktualizowane po podanej dacie lub ich data pokrywa się z podaną datą (format daty DD-MMM-RR, można też użyć określeń typu TODAY [DZIŚ w polskiej wersji] YESTERAY [WCZORAJ], MONDAY [PONIEDZIAŁEK] itd.)

UPTO

podobnie jak SINCE - z tym że wyświetla informacje o plikach utworzonych/zmodyfikowanych przed daną datą

QUICK

wyświetla informacje w formie skróconej - same nazwy plików i katalogów

BLOCK

podaje rozmiar plików w blokach, a nie bajtach

NOHEAD

nie wyświetla linii nagłówkowej oraz podsumowania

FILES

wyświetla tylko informacje o plikach (katalogi są ignorowane)

DIRS

wyświetla tylko informacje o katalogach (pliki są ignorowane)

ALL

wyświetli zawartość katalogu i podkatalogów

LFORMAT

zaawansowane formatowanie wyświetlanych informacji, podanie samego LFORMAT jest równoznaczne z włączeniem QUICK i NOHEAD, oprócz tego można stosować opcje wyświetlające:

%A - atrybuty
%B - rozmiar w blokach
%C - komentarze
%D - datę
%E - samo rozszerzenie pliku
%F - tylko ścieżkę (bez nazwy pliku/katalogu)
%K - numer/adres bloku zawierającego nagłówek pliku/katalogu
%L - rozmiar w bajtach
%M - nazwę pliku z pominięciem rozszerzenia
%N - nazwę
%P - ścieżkę
%S - ścieżkę
%T - czas utworzenia/ostatniej modyfikacji

Przykład:

List RAM: ALL FILES LFORMAT "Plik o nazwie *"%M*", na rozszerzenie *"%E*" - a jego rozmiar wynosi %Lb"

---

LoadResource

Opis:

Ładuje pliki typu resource - zasoby (biblioteki, device itp.) do listy poleceń rezydentnych (w pamięci RAM) by można je było szybciej wywoływać/uruchamiać bezpośrednio z pamięci - a nie dysku. Użyty bez parametrów wyświetla listę załadowanych i zablokowanych zasobów

Występuje:

AmigaOS 3.1 i nowsze

Format:

LoadResource NAME/M LOCK/S UNLOCK/S:

Parametry:

NAME

nazwa pliku/plików do umieszczenia na liście poleceń rezydentnych

LOCK

blokuje plik i uniemożliwia jego usunięcie z pamięci. Przydatne szczególnie w przypadku bibliotek, które chcemy zabezpieczyć przed usunięciem z pamięci np. przy wywołaniu polecenia
Avail FLUSH

UNLOCK

zdejmuje blokadę z podanego zasobu

Przykład:

LoadResource Libs:muimaster.library LOCK

---

LoadWB

Opis:

Polecenie uruchamia Workbench

Występuje:

Wszystkie wersje AmigaOS

Format:

Loadwb -DEBUG/S DELAY/S CLEANUP/S NEWPATH/S

Parametry:

-DEBUG

włącza dodatkowe menu na belce tytułowej WB zawierające polecenia dla developerów

DELAY

krótkie (ok. 3s) opóźnienie uruchomienia Workbencha pozwalające na mniejsze mielenie dyskiem przy uruchamianiu programów z katalogu WBStartup itp.

CLEANUP

odpowiednik wciśnięcia skrótu [Prawa Amiga] + [.] lub wybranie z menu pozycji Cleanup dla blatu WB

NEWPATH

pozwala zmienić domyślną ścieżkę dla WB, CLI, Shell - domyślną ścieżką zwykle jest partycja, z której uruchomiony został system, ten parametr pozwala zmienić ją na inną

Przykład:

LoadWB DELAY

---

Lock

Opis:

Blokuje dysk przed zapisem/kasowaniem danych. Odczyt nadal jest możliwy

Występuje:

AmigaOS 1.3 i nowsze

Format:

Lock DRIVE/A ON/S OFF/S PASSKEY

Parametry:

DRIVE

urządzenie do zablokowania

ON|OFF

włącza/wyłącza blokadę

PASSKEY

hasło - rozpoznaje wielkość liter, w systemie 1.3 przyjmuje hasła o dowolnej długości przy blokowaniu i odblokowywaniu, ale i tak czyta wyłącznie pierwsze 4 znaki, w nowszych systemach czytane są wszystkie znaki

Przykład:

LOCK DH1: ON

---

MagTape

Opis:

Służy do kontroli urządzeń taśmowych

Występuje:

AmigaOS 2.0 i nowsze

Format:

MagTape DEVICE/K UNIT/N/K RET=RETENSION/S REW=REWIND/S SKIP/N/K

Parametry:

DEVICE

określa kontroler (jeżeli nazwa kontrolera nie została podana, MagTape odwołuje się do scsi.device)

UNIT

numer urządzenia (domyślny 4)

RET|RETENSION

przewija taśmę do końca, a następnie z powrotem do początku - operacja wymagana przy pamięciach taśmowych, mająca na celu uniemożliwienie samoistnej migracji danych w obrębie zwiniętej taśmy (jeżeli taśma długo nie jest przewijana, to istnieje ryzyko, że kolejne warstwy będą się nawzajem magnesować - w przypadku taśm audio powoduje to powstawanie "echa", przy taśmach z danymi powoduje to zakłócenia prowadzące w skrajnych przypadkach do utraty danych)

REW|REWIND

przewinięcie taśmy do początku

SKIP

przewinięcie taśmy (przeskoczenie) o podaną liczbę plików

Przykład:

Magtape UNIT 3 SKIP 5

---

MakeDir

Opis:

Zakłada katalog(i)

Występuje:

Wszystkie wersje AmigaOS

Format:

MakeDir NAME/M

Parametry:

NAME

nazwa katalogu/katalogów. Jeżeli nie podasz ścieżki, założy w katalogu bieżącym

Przykład:

MakeDir RAM:Env RAM:T

---

MakeLink

Opis:

Tworzy na dysku plik, który jest linkiem do jakiegoś pliku. Stworzony w ten sposób link jest widziany przez AmigaOS jako rzeczywisty plik, do którego prowadzi link - AmigaOS wyświetla np. rozmiar takiego pliku taki, jaki ma prawdziwy plik, do którego prowadzi link (choć w rzeczywistości link zajmuje tylko jeden blok). MakeLink tworzy linki w obrębie jednej partycji (nie można stworzyć linka na innej partycji niż plik, do którego prowadzi), tzn. że MakeLink tworzy wyłącznie hardlinki i nie radzi sobie z softlinkami (link znajdujący się na innej partycji niż plik, do którego prowadzi)

Występuje:

AmigaOS 2.0 i nowsze

Format:

MakeLink FROM/A TO/A HARD/S FORCE/S

Parametry:

FROM

ścieżka i nazwa dla linka

TO

rzeczywisty plik, na który wskazuje link

HARD

nie jest wymagany - ponieważ (jak pisałem już wyżej) MakeLink potrafi tworzyć wyłącznie hardlinki. Informuje polecenie, że link ma być typu hardlink

FORCE

tworzy link nie do pliku a do katalogu

Przykład:

MakeLink FROM SYS:C/View TO SYS:Utilities/MultiView

---

Mount

Opis:

Ładuje i montuje urządzenia z mountlist

Występuje:

Wszystkie wersje AmigaOS

Format:

Mount DEVICE/M FROM/K

Parametry:

DEVICE

urządzenie do załadowania

FROM

mountlista

Przykład:

Mount >NIL: Devs:DOSDrivers/~(#?.info)

---

NewCLI

Opis:

Uruchamia nowe okno CLI konsoli CON:. Podobne do NewShell
W AOS 1.3 NewCLI i NewShell różnią się znacznie na korzyść NewShell (więcej funkcji). Od AOS 2.0 polecenia są równoważne (oferują te same możliwości)

Występuje:

Wszystkie wersje AmigaOS

Format:

NewCLI WINDOW FROM

Parametry:

FROM

skrypt z ustawieniami - jeżeli planujesz załadować taki skrypt, to musisz wpisać 'FROM' przed nazwą tego skryptu (nie można pominąć wpisania 'FROM)

WINDOW

określa konfigurację okna, format parametru CON:[odległość okna CLI od lewej krawędzi ekranu w pikselach]/[odległość okna CLI od góry ekranu w pikselach]/[szerokość okna CLI w pikselach]/[szerokość okna CLI w pikselach]/[nazwa okna]/[opcje dodatkowe]
opcje dodatkowe:
Auto - okno otworzy się, dopiero gdy coś zostanie do niego wysłane
Backdrop - okno uruchomi się w tle (pod innymi oknami - o ile są jakieś okna na blacie)
NoBorder - okno bez ramek
NoDrag - okna nie można przesuwać
Simple - proste odświeżanie okna
Smart - inteligentne odświeżanie okna
Wait - okno nie zamknie się po zakończeniu działania programu - żeby je zamknąć, trzeba będzie kliknąć na gadżecie zamknięcia
Close - okno zamknie się po zakończeniu działania programu

Przykład:

Newcli CON:0/10/400/200/Shell/BACKDROP

---

NewShell

Opis:

Uruchamia nowe okno Shell konsoli CON:. Podobne do NewCLI.
W AOS 1.3 NewCLI i NewShell różnią się znacznie na korzyść NewShell (więcej funkcji). Od AOS 2.0 polecenia są równoważne (oferują te same możliwości)

Występuje:

AmigaOS 1.3 i nowsze

Format:

NewShell WINDOW FROM

Parametry:

FROM

skrypt z ustawieniami - jeżeli planujesz załadować taki skrypt, to musisz wpisać 'FROM' przed nazwą tego skryptu (nie można pominąć wpisania 'FROM)

WINDOW

określa konfigurację okna, format parametru CON:[odległość okna CLI od lewej krawędzi ekranu w pikselach]/[odległość okna CLI od góry ekranu w pikselach]/[szerokość okna CLI w pikselach]/[szerokość okna CLI w pikselach]/[nazwa okna]/[opcje dodatkowe]
opcje dodatkowe:
Auto - okno otworzy się, dopiero gdy coś zostanie do niego wysłane
Backdrop - okno uruchomi się w tle (pod innymi oknami - o ile są jakieś okna na blacie)
NoBorder - okno bez ramek
NoDrag - okna nie można przesuwać
Simple - proste odświeżanie okna
Smart - inteligentne odświeżanie okna
Wait - okno nie zamknie się po zakończeniu działania programu - żeby je zamknąć, trzeba będzie kliknąć na gadżecie zamknięcia
Close - okno zamknie się po zakończeniu działania programu

Przykład:

NewShell From S:Shell-Startup

---

Path

Opis:

Ustawia, dodaje lub usuwa domyślną ścieżkę dla programów. Dzięki temu nie trzeba wpisywać pełnej ścieżki do programu, który chcemy uruchomić - wystarczy sama nazwa programu podana w CLI

Występuje:

AmigaOS 1.2 i nowsze

Format:

Path PATH/M ADD/S SHOW/S RESET/S REMOVE/S QUIET/S

Parametry:

PATH

ścieżka do programu/programów

ADD

dodaje ścieżkę do już istniejących ścieżek

SHOW

wyświetla zdefiniowane ścieżki (wpisanie samego polecenia Path, bez żadnych parametrów daje ten sam efekt)

RESET

usuwa ścieżki z listy, na liście pozostają jedynie 2 wpisy aktualny katalog oraz ścieżka do katalogu C

REMOVE

usuwa wskazaną ścieżkę z listy ścieżek

QUIET

nie wyświetlaj komunikatów

Przykład:

Path DH1:Programy/DirectoryOpus/C ADD

---

Prompt

Opis:

Zmienia treść wyświetlaną przez znak zachęty AmigaDOSu

Występuje:

Wszystkie wersje AmigaOS

Format:

Prompt PROMPT

Parametry:

PROMPT

opcje pozwalające na zmianę promptu:
%N - numer procesu CLI
%R - ostatni kod błędu
%S - aktualny katalog

Przykład:

Prompt "%N. %S RC%R> "

---

Protect

Opis:

Dodaje, usuwa lub zmienia bity protekcji pliku lub katalogu. Użycie polecenia bez żadnych bitów protekcji czyści wszystkie flagi danego pliku/katalogu. Podanie jednego lub więcej bitów protekcji bez podawania parametrów ADD lub SUB powoduje włączenie wskazanych flag pliku/katalogu - pozostałe bity protekcji są wyłączane

Występuje:

Wszystkie wersje AmigaOS

Format:

Protect FILE/A FLAGS ADD/S SUB/S ALL/S QUIET/S

Parametry:

FILE

plik/katalog do obróbki

ADD

dodaje (włącza) wskazane bity protekcji nie zmieniając stanu już włączonych

SUB

usuwa (wyłącza) wskazane bity protekcji nie zmieniając innych

QUIET

bez komunikatów

FLAGS

bity protekcji:
h - obiekt powinien być ukryty - AmigaOS i większość programów ignoruje tę flagę. Na Aminecie można znaleźć łatkę o nazwie PatchHidden, aktywującą ukrywanie plików/katalogów za pomocą tej flagi
s - plik jest skryptem ADOS - dzięki temu bitowi, by uruchomić skrypt, wystarczy podać jego nazwę (nie trzeba wpisywać polecenia: Execute nazwa_skryptu_ADOS)
p - ustawienie tej flagi pozwala na dodanie programu do listy poleceń rezydentnych bez podawania parametru PURE lub FORCE w rozkazie Resident
a - obiekt został zarchiwizowany - bit protekcji dodawany m.in. przez archiwizery, AmiagOS usuwa ten bit, jeżeli w pliku nim oznaczonym zaszły jakieś zmiany - co ułatwia backupy przyrostowe - wystarczy ustawić w programie archiwizującym, żeby dodawał pliki wyłącznie bez bitu protekcji 'a' (no i włączał im ten bit po zarchiwizowaniu)
r - można odczytać zawartość obiektu
w - można zmieniać zawartość obiektu
e - plik jest programem
d - gdy włączony plik da się usunąć

Przykład:

Protect mój_skrypt s ADD

---

Quit

Opis:

Pozwala na zwrócenie kodu błędu przez skrypt ADOS

Występuje:

Wszystkie wersje AmigaOS

Format:

Quit RC/N

Parametry:

RC

kod błędu - można użyć jakiejkolwiek wartości, jednak wskazane jest, by (o ile jest to możliwe) używać standardowych numerów błędów:
0 - wszystko OK
5 - ostrzeżenie (Warn)
10 - błąd (Error)
20 - awaria/błąd krytyczny (Failure)

Przykład:

Copy >NIL: nieistniejący_plik RAM:
IF WARN   ; - jeżeli polecenie Copy nie znalazło pliku
  Echo "Nie znaleziono pliku do skopiowania"
  Quit 10
ELSE
  Echo "Plik skopiowany"
  Quit 0
ENDIF

---

Relabel

Opis:

Zmienia nazwę dysku lub partycji

Występuje:

Wszystkie wersje AmigaOS

Format:

Relabel DRIVE/A NAME/A

Parametry:

DRIVE

urządzenie, którego nazwę chcemy zmienić

NAME

nazwa dla urządzenia

Przykład:

Relabel DF0: "Nowa dyskietka"

---

RemRAD

Opis:

Usuwa wirtualny dysk RAD: z pamięci

Występuje:

AmigaOS 1.3 i nowsze

Format:

RemRAD DEVICE FORCE/S

Parametry:

DEVICE

urządzenie RAD do usunięcia

FORCE

wymusza usunięcie urządzenia, nawet gdy jest ono używane w danym momencie (zablokowane)

Przykład:

RemRAD RAD1: FORCE

---

Rename

Opis:

Zmienia nazwę lub przenosi pliki/katalogi

Występuje:

Wszystkie wersje AmigaOS

Format:

Rename FROM/A/M TO=AS/A QUIET/S

Parametry:

FROM

stara nazwa/stara lokalizacja

TO

nowa nazwa/lokalizacja (zamiast 'TO', można użyć równoznacznego parametru 'AS')

QUIET

bez komunikatów

Przykład:

Rename FROM czytaj AS czytaj.to

---

Rename DH1:T/czytaj.to DH1:Program/
; przeniesie plik 'czytaj.to' z katalogu T do katalogu Program, bez zmiany nazwy

---

RequestChoice

Opis:

Wyświetla okienko komunikatu z guzikiem/guzikami wyboru

Występuje:

AmigaOS 3.0 i nowsze

Format:

RequestChoice TITLE/A BODY/A GADGETS/M PUBSCREEN/K

Parametry:

TITLE

tytuł okienka (na górnej belce)

BODY

treść komunikatu

GADGETS

jeden lub więcej guzików

PUBSCREEN

nazwa ekranu publicznego, na którym ma otworzyć się okienko. Jeżeli nie podamy nazwy ekranu, to okienko otworzy się na tym ekranie, na którym otwarty jest Shell/skrypt ADOS (zwykle Workbench)

Przykład:

RequestChoice TITLE "Tytuł okienka" BODY "Pierwsza linijka komunikatu *n druga linijka komunikatu..." GADGETS "Guzik 1" "Guzik 2" "Guzik 0" >Env:RC_Test

---

;Otwarcie okienka RequestChoice na ekranie publicznym o nazwie PPA_PubScreen_Test:
RequestChoice TITLE "PPA_PubScreen_Test" BODY "Sprawdzamy, czy RequestChoice potrafi *n otworzyć się na wskazanym ekranie." GADGETS "Guzik 1" "Guzik 2" "Guzik 0" PUBSCREEN PPA_PubScreen_Test >Env:RC_PS_Test

---

RequestFile

Opis:

Wyświetla okienko pozwalające wskazać (wybrać) plik lub katalog za pomocą myszki

Występuje:

AmigaOS 3.0 i nowsze

Format:

RequestFile DRAWER FILE/K PATTERN/K TITLE/K POSITIVE/K NEGATIVE/K ACCEPTPATTERN/K REJECTPATTERN/K SAVEMODE/S MULTISELECT/S DRAWERSONLY/S NOICONS/S PUBSCREEN/K

Parametry:

DRAWER

katalog startowy dla requestera

FILE

startowa nazwa pliku - przydatne w przypadku używania RequestFile w trybie zapisu (patrz opis opcji SAVEMODE) lub jako podpowiedź dla usera, jakiego pliku powinien szukać

PATTERN

określa pattern pozwalający filtrować zawartość okienka

TITLE

tytuł wyświetlany na górnej belce

POSITIVE

podmienia tekst dla guzika OK

NEGATIVE

podmienia tekst dla guzika Cancel

ACCEPTPATTERN

określa pattern(y) pozwalający(e) filtrować wyświetlaną zawartość okienka (jeżeli użyta jest ta opcja, to wartość parametru PATTERN jest ignorowana)

REJECTPATTERN

określa pattern(y) dla plików, które będą ukryte

SAVEMODE

przestawia polecenie RequestFile z trybu Load (wczytywanie/pobieranie nazwy pliku) na tryb Save (zapis pliku)

MULTISELECT

pozwala na wybranie wielu plików

DRAWERSONLY

wyświetla wyłącznie katalogi

NOICONS

ukrywa pliki ikon (#?.info)

PUBSCREEN

nazwa ekranu publicznego, na którym ma otworzyć się okienko. Jeżeli nie podany nazwy ekranu, to okienko otworzy się na tym ekranie, na którym otwarty jest Shell/skrypt ADOS (zwykle Workbench)

Przykład:

RequestFile >ENV:File TITLE "Wybierz plik" POSITIVE "Wybrałem" NOICONS

---

Resident

Opis:

Ładuje komendy ADOS do pamięci, dzięki czemu mogą być one wykonywane szybciej niż gdybyśmy wczytywali je za każdym razem z dyskietki/dysku. Aby komenda mogła stać się rezydentną, powinna mieć ustawiony bit protekcji 'p' (pure). Komenda Resident użyta bez żadnych parametrów wyświetla listę wszystkich poleceń rezydujących w pamięci

Występuje:

AmigaOS 1.3 i nowsze

Format:

Resident NAME FILE REMOVE/S ADD/S REPLACE/S PURE=FORCE/S SYSTEM/S

Parametry:

NAME

nazwa dla polecenia, pod którą będzie występowało lub występuje na liście poleceń rezydentnych (można używać podobnie do polecenia Alias)

FILE

plik, który ma być rezydentny

REMOVE

usuwa wskazany plik z listy poleceń rezydentnych (usuwa z pamięci)

ADD

dodaje wskazany plik do listy poleceń rezydentnych

REPLACE

podmienia polecenie występujące na liście rozkazów rezydentnych

PURE=FORCE

wymusza umieszczenie na liście rezydentnej polecenia, które nie ma ustawionego bitu 'p' - opcja powinna być używana również w przypadku poleceń, które mają włączony bit protekcji 'p' (tak jak ma to miejsce w przypadku polecenia Assign w Startup-Sequence), by zabezpieczyć się przed wyrzucaniem błędów przez polecenie Resident, gdy z jakiejś przyczyny bit protekcji 'p' zostanie wyłączony w danym pliku

SYSTEM

użycie polecenia Resident tylko z tą opcją wyświetli rozszerzoną listę poleceń rezydentnych - oprócz komend oznaczonych jako wbudowane (INTERNAL) wyświetlana jest również lista komend rezydentnych oznaczonych jako systemowe (SYSTEM), za pomocą tego parametru można dodawać polecenia na listę SYSTEM - jednak nie należy tego robić dla poleceń z C: ponieważ w takim przypadku wiąże się to z różnymi problemami z tymi poleceniami. W AOS 1.3 i starszych polecenie umieszczone na liście rezydentnej SYSTEM staje się nieużywalne - nawet przywołanie takiego polecenia z dysku/dyskietki (np. C:Assign) skończy się komunikatem, że takie polecenie ni istnieje (nawet gdy znajduje się na dysku). W przypadku AOS 2.0 i nowszych polecenia nie da się uruchomić z listy rezydentnej, ale można uruchomić z dysku

Przykład:

Resident C:Assign PURE >NIL:

---

Run

Opis:

Wykonuje program w tle, nie blokując CLI (multitasking dla ADOS).
Pozwala uruchomić kilka programów, które będą uruchomione w oddzielnym tasku jeden po drugim. By uzyskać ten efekt, musimy użyć znaku +

Występuje:

Wszystkie wersje AmigaOS

Format:

Run COMMAND/F

Parametry:

COMMAND

program(y) do uruchomienia

Przykład:

Run Printfiles dokumentacja.txt

---

; uruchomienie kilku poleceń w oddzielnym tasku
Run Ed S:Startup-Sequence +
Printfiles S:Startup-Sequence

---

Search

Opis:

Wyszukuje podanego ciągu znaków w plikach lub pliku na dysku

Występuje:

Wszystkie wersje AmigaOS

Format:

Search FROM/M SEARCH/A ALL/S NONUM/S QUIET/S QUICK/S FILE/S PATTERN/S

Parametry:

FROM

katalog do przeszukania

SEARCH

ciąg znaków, którego ma poszukiwać w plikach

ALL

szukaj w podkatalogach

NONUM

wyświetla same nazwy plików, w których znalazł szukany ciąg znaków bez numeru linii, w której ten ciąg znaków wystąpił

QUIET

nie wyświetla komunikatów

QUICK

ogranicza listę wyników tylko do nazw plików, w których znalazł szukany ciąg znaków (nie wyświetla nazw plików, w których nie znalazł szukanego ciągu znaków)

FILE

szukaj (nazwy) pliku na dysku

PATTERN

traktuje podane w szukanym ciągu znaki specjalne (#, ?) jako pattern - a nie jako znaki, których ma szukać. Np.

Search S: a#?n QUICK - będzie szukało w plikach ciągu znaków 'a#?n' (i zapewne nic nie znajdzie)
Search S: a#?n QUICK PATTERN - powinno wyświetlić m.in., że znalazło słowo 'Assign' w pliku Startup-Sequence

Przykład:

Search S: a#?n QUICK PATTERN

---

Set

Opis:

Tworzy zmienną lokalną (dla danego CLI/Shell) i/lub ustawia jej wartość

Występuje:

AmigaOS 2.0 i nowsze

Format:

Set NAME STRING/F

Parametry:

NAME

nazwa zmiennej

STRING

wartość zmiennej

Przykład:

Set MojeImie "Piotr"

---

SetClock

Opis:

Odczytuje czas z RTC (Real Time Clock - czyli zegar), ustawia RTC lub go resetuje

Występuje:

AmigaOS 1.2 i nowsze

Format:

Setclock LOAD/S SAVE/S RESET/S

Parametry:

LOAD

odczytaj czas z RTC

SAVE

zapisuje czas w RTC (ustawia zegar czasu rzeczywistego)

RESET

resetuje zegar - gdy zegar się 'zawiesi' i ignoruje ustawienie czasu za pomocą tej opcji przywrócisz go do życia

Przykład:

SetClock RESET

---

SetDate

Opis:

Ustawia datę pliku (tzw. datestamp) dla pliku/katalogu

Występuje:

AmigaOS 1.2 i nowsze

Format:

SetDate FILE/A WEEKDAY DATE TIME ALL/S

Parametry:

FILE

nazwa pliku/katalogu, któremu chcemy zmienić datę utworzenia

WEEKDAY

dzień tygodnia - zamiast wklepywać stada cyferek, wystarczy podać nazwę konkretnego dnia tygodnia (jeżeli zmieniana data to data z aktualnego tygodnia)

DATE

data - może mieć format: 19-Jan-11 (19-Sty-11 dla spolszczonego AOS), Friday (Piątek dla AOS PL) albo Today, Yesterday, Tommorrow (Dziś, Wczoraj, Jutro dla AOS PL)

TIME

czas (format GG:MM:SS, GG:MM) - jeżeli przy zmianie datestampu ustawienie czasu zostanie pominięte, to plikowi zostanie ustawiona aktualna godzina

ALL

zastosuj do wszystkich obiektów w danym katalogu

Przykład:

Setdate DEVS: Monday 10:30

---

SetEnv

Opis:

Tworzy zmienną globalną i/lub ustawia jej wartość.

Występuje:

AmigaOS 1.3 i nowsze

Format:

SetEnv NAME STRING/F

Parametry:

NAME

nazwa zmiennej

STRING

wartość zmiennej

Przykład:

SetEnv Workbench "3.1"

---

SetFont

Opis:

Ustawia czcionkę dla okna CLI/Shell. Można używać zarówno czcionek bitmapowych, jak i wektorowych

Występuje:

AmigaOS 2.0 i nowsze

Format:

SetFont NAME/A SIZE/N/A SCALE/S PROP/S ITALIC/S BOLD/S UNDERLINE/S

Parametry:

NAME

nazwa fontu

SIZE

rozmiar czcionki

SCALE

jeżeli czcionka nie posiada kroju o żądanym rozmiarze zostanie użyty krój najbliższy danemu rozmiarowi, który zostanie przeskalowany do tego rozmiaru (jeżeli nie użyjemy opcji SCALE, zaś font nie będzie oferował kroju o żądanym rozmiarze - zostanie użyty rozmiar najbliższy)

PROP

należy użyć, jeżeli wybrana czcionka jest proporcjonalna

ITALIC

czcionka pochylona

BOLD

czcionka pogrubiona

UNDERLINE

czcionka podkreślona

Przykład:

SetFont Boing_ISO 22

---

SetKeyboard

Opis:

Ustawia obłożenie klawiatury przy pomocy pliku mapy klawiatury (keymap)

Występuje:

AmigaOS 2.1 i nowsze

Format:

SetKeyboard KEYMAP/A

Parametry:

KEYMAP

mapa klawiatury

Przykład:

SetKeyboard >NIL: USA-PL_ISO

---

SetMap

Opis:

Ustawia obłożenie klawiatury przy pomocy pliku mapy klawiatury (keymap)

Występuje:

AmigaOS 2.0 i starsze

Format:

SetMap KEYMAP/A

Parametry:

KEYMAP

mapa klawiatury

Przykład:

SetMap >NIL: USA-PL

---

SetPatch (43.4)

Opis:

Łata funkcje systemu

Występuje:

Nie dołączany do żadnej wersji systemu - rozprowadzany jako oddzielna poprawka do AOS

Format:

Setpatch QUIET/S NOCACHE/S REVERSE/S NOAGA/S

Parametry:

QUIET

bez komunikatów

NOCACHE

wyłącza cache procesora

REVERSE

zmienia sposób alokowania pamięci (pamięć jest przydzielana zaczynając od górnych adresów - a nie od dolnych). Opcja powstała z myślą o developerach CDTV i nie należy jej stosować na innych komputerach

NOAGA

nie włącza trybów AGA w chipsecie

Przykład:

SetPatch QUIET

---

SetPatch (44.38 - AOS 3.9 BB2)

Opis:

Łata funkcje systemu, włącza/wyłącza "rom updates", wyłącza tryb pracy NDS dla dysku twardego, wstrzymuje wczytywanie systemu w oczekiwaniu na walidację dysku

Występuje:

AmigaOS 3.9 BB2

Format:

Setpatch QUIET/S NOCACHE/S REVERSE/S NONSD/S NOAGA/S PATCHCONFIGFILE=PCF/K PATCHCONFIGLINE=PCL/K PATCHINFO=PI/S FORCEUPDATE/S KILLUPDATE/S NOROMUPDATE/S DISABLEROMMODULES/S SKIPROMUPDATES=SKIPROMMODULES/K WAITFORVALIDATE/S AVOIDMEMFKICKFORPATCHES/S

Parametry:

QUIET

bez komunikatów

NOCACHE

wyłącza cache procesora

REVERSE

zmienia sposób alokowania pamięci (pamięć jest przydzielana zaczynając od górnych adresów - a nie od dolnych). Opcja powstała z myślą o developerach CDTV i nie należy jej stosować na innych komputerach

NONSD

wyłącza NSD (New Style Device - wsparcie dla dysków o rozmiarze powyżej 4GB)

NOAGA

nie włącza trybów AGA w chipsecie

PATCHCONFIGFILE=PCF

określa plik konfiguracyjny dla łat

PATCHCONFIGLINE=PCL

określa linię pliku konfiguracyjnego

PATCHINFO=PI

wyświetla informacje o łatach

FORCEUPDATE

wymusza łatanie, nie zważając na to czy wcześniej było już coś instalowane w OS

KILLUPDATE

usuwa aktywną łatę

NOROMUPDATE

nie instaluj aktualizacji ROM

DISABLEROMMODULES

usuwa niektóre moduły ROM (może powodować zawieszenie AOS)

SKIPROMUPDATES=SKIPROMMODULES

nie aktywuj wskazanych modułów

WAITFORVALIDATE

czekaj z ładowaniem AOS do czasu aż dysk(i) nie zakończy(ą) walidacji

AVOIDMEMFKICKFORPATCHES

ignoruje MemFKick

Przykład:

Setpatch NONSD QUIET

---

SetPatch (AOS 1.3)

Opis:

Łata funkcje systemu

Występuje:

AmigaOS 1.3

Format:

SetPatch R

Parametry:

R

gdy Amiga z ROM 1.3 jest wyposażona w więcej niż 0.5MB CHIP, wirtualny napęd dyskietek RAD: nie przeżywa resetu - ta opcja usuwa ten błąd i pozwala na startowanie komputera z RAD: na Amigach posiadających 1MB CHIP (i więcej)

Przykład:

SetPatch

---

Skip

Opis:

Skacze do zakładki w skrypcie ADOS (patrz opis polecenia Lab)

Występuje:

Wszystkie wersje AmigaOS

Format:

Skip LABEL BACK/S

Parametry:

LABEL

nazwa etykiety, do której chcemy skoczyć

BACK

należy użyć, jeżeli zakładka znajduje się przed poleceniem Skip (trzeba skoczyć do tyłu)

Przykład:

Skip etykieta2 BACK

---

Sort

Opis:

Sortuje zawartość pliku

Występuje:

Wszystkie wersje AmigaOS

Format:

Sort FROM/A TO/A COLSTART/K CASE/S NUMERIC/S

Parametry:

FROM

plik do posortowania

TO

plik wynikowy

COLSTART

która kolumna tekstu ma być brana pod uwagę przy sortowaniu - sortując będzie brał pod uwagę wskazany numer litery w liniach (domyślnie jest to 1 - pierwsza litera w linii)

CASE

duże litery przed małymi - to oznacza, że linie zaczynające się od dużej litery 'Z' będą przed liniami zaczynającymi się od 'a'

NUMERIC

cyfry będą po literach

Przykład:

Sort lista TO PosortowanaLista NUMERIC

---

Stack

Opis:

Zmienia lub wyświetla rozmiar stosu

Występuje:

Wszystkie wersje AmigaOS

Format:

Stack SIZE/N

Parametry:

SIZE

rozmiar stosu w bajtach

Przykład:

Stack 10000

---

Status

Opis:

Wyświetla status uruchomionych procesów (programów). Uruchomiony bez podania numeru procesu wyświetla listę wszystkich procesów + dodatkowe informacje o nich uzależnione od użytych parametrów

Występuje:

Wszystkie wersje AmigaOS

Format:

Status PROCESS/N FULL/S TCB/S CLI=ALL/S COM=COMMAND/K

Parametry:

PROCESS

numer procesu

FULL

pełna informacja o procesie (jego numer, rozmiar stosu, rozmiar wektora globalnego, priorytet, nazwę uruchomionego w tym procesie programu)

TCB (Task Control Block)

podobnie do FULL, z wyłączeniem nazwy uruchomionego w danym procesie programu

CLI=ALL

wyświetla tylko numer procesu i nazwę uruchomionego w tym procesie programu (odpowiednik uruchomienia polecenia Status bez żadnych parametrów)

COM=COMMAND

szuka numeru procesu, w którym uruchomiony jest podany program

Przykład:

Status FULL

---

Type

Opis:

Wyświetla zawartość pliku na ekranie itp.

Występuje:

Wszystkie wersje AmigaOS

Format:

Type FROM/A/M TO/K OPT H|N/K HEX/S NUMBER/S

Parametry:

FROM

plik do wyświetlenia

TO

plik wynikowy lub urządzenie, na które zostanie wysłana zawartość pliku

OPT H=HEX

wyświetlaj plik w trybie heksadecymalnym

OPT N=NUMBER

numeruj wiersze

Przykład:

Type C:DIR HEX

---

UnAlias

Opis:

Usuwa przypisaną do polecenia nazwę (patrz opis polecenia Alias)

Występuje:

AmigaOS 2.0 i nowsze

Format:

UnAlias NAME

Parametry:

NAME

przypisana do polecenia nazwa

Przykład:

UnAlias Del

---

UnSet

Opis:

Usuwa zmienną lokalną

Występuje:

AmigaOS 2.0 i nowsze

Format:

UnSet NAME

Parametry:

NAME

nazwa zmiennej lokalnej, którą chcemy usunąć

Przykład:

UnSet MojeImie

---

UnSetEnv

Opis:

Usuwa zmienną globalną

Występuje:

AmigaOS 2.0 i nowsze

Format:

UnSetEnv NAME

Parametry:

NAME

nazwa zmiennej globalnej, którą chcemy usunąć

Przykład:

UnSetEnv Workbench

---

Version

Opis:

Wyświetla wersję zapisaną w pliku (programy, biblioteki, filesystemy itd.)

Występuje:

AmigaOS 1.2^* i nowsze

Format:

Version NAME VERSION/N REVISION/N FILE/S FULL/S UNIT/N INTERNAL/S RES/S

Parametry:

NAME

plik, którego wersję chcemy wyświetlić

VERSION

służy do sprawdzania, czy wersja danego pliku odpowiada wersji wymaganej. Dzięki temu można np. w skrypcie ADOS sprawdzić, czy użytkownik posiada wymaganą wersję biblioteki itp. Przykład wykorzystania:

Version diskfont.library VERSION 39

zwróci kod 5 (return code 5 - WARN) jeżeli sprawdzana biblioteka jest starsza lub kod 0 (OK) - jeżeli wersja biblioteki jest równa lub większa od wymaganej 39

REVISION

czasami wersja biblioteki, czy innego sprawdzanego/wymaganego przez nas pliku różni się jednym numerkiem po kropce. Do sprawdzenia tego służy parametr REVISON. Załóżmy, że istnieją 2 wersje biblioteki o zbliżonych numerach 39.10 i 39.11. My wymagamy wersji o numerze 39.11 - żeby sprawdzić, czy użytkownik taką posiada, musimy użyć polecenia:

Version diskfont.library VERSION 39 REVISION 11

jeżeli użytkownik posiada taką lub nowszą bibliotekę, to polecenie Version zwróci kod 0, jeżeli nie - zobaczymy kod 5

FILE

gdy chcemy sprawdzić wersję pliku na dysku - a nie pliku wczytanego do pamięci (przydatne, gdy np. chcemy sprawdzić wersję biblioteki znajdującej się na dysku)

FULL

wyświetla pełną informację (wersja, rewizja, data itp.) o ile znajdzie coś więcej

UNIT

jeżeli urządzenie, które chcemy sprawdzić, posiada przypisane więcej niż jeden unit - a chcemy sprawdzić unit inny niż 0 (domyślny), to musimy użyć tego parametru (uwaga - nazwa parametru 'UNIT' jest wymagana)

INTERNAL

wyświetla wersję dla plików znajdujących się na liście poleceń wbudowanych

RES

wyświetla wersję dla plików znajdujących się na liście poleceń rezydentnych

Przykład:

Version Filesystem INTERNAL

---

^* - nie we wszystkich dystrybucjach AOS 1.2

---

Wait

Opis:

Czeka przez zadany czas lub do zadanego czasu

Występuje:

Wszystkie wersje AmigaOS

Format:

Wait TIME/N SEC=SECS/S MIN=MINS/S UNTIL/K

Parametry:

TIME

wartość czasu

SEC=SECS

podana wartość czasu to sekundy (domyślnie - nie trzeba podawać)

MIN=MINS

podana wartość czasu to minuty

UNTIL

czekaj do podanej godziny (format GG:MM uwaga - nie podajemy sekund)

Przykład:

Wait UNTIL 12:00

---

Which

Opis:

Szuka katalogu, w którym znajduje się podany plik (przeszukuje katalogi ustawione przez polecenie Path)

Występuje:

AmigaOS 1.3 i nowsze

Format:

Which FILE/A NORES/S RES/S ALL/S

Parametry:

FILE

szukany plik

NORES

nie przeszukuje listy poleceń rezydentnych

RES

przeszukuje wyłącznie listę poleceń rezydentnych

ALL

wyświetla wszystkie ścieżki dostępu do pliku, nie zatrzymuje się po znalezieniu pliku na liście poleceń rezydentnych

Przykład:

Which Multiview

---

Why

Opis:

Wyświetla informację, dlaczego poprzednia komenda nie zadziałała

Występuje:

Wszystkie wersje AmigaOS

Format:

Why

Parametry:

Brak

Przykład:

Why

---