FailAt
| Formát: | FAILAT [<n>] |
| Šablona: | RCLIM/N |
| Účel: | Nastavuje mez hodnoty návratového kódu, po které se přeruší zpracování dávkového souboru. |
| Cesta: | Vnitřní příkaz |
Příkazy AmigaDOS informují o svém úspěchu či neúspěchu pomocí návratového kódu. To je celé číslo, jehož hodnota říká, jak příkaz pochodil.
Návratový kód 0 znamená, že příkaz byl úspěšný. Vyšší hodnoty signalizují problémy. Hodnota 5 je záporný výsledek zjištění nebo ne tak závažná chyba. Tato hodnota se často označuje kódem WARN. Kód 10 je již vážnější chyba a číslo 20 je jakýsi "červený" poplach.
Když se zpracovává posloupnost příkazů (obvykle v dávkovém souboru, ale můžete to být také sled příkazů zapsaných za příkaz RUN) a dojde k chybě, zpracování posloupnosti se zastaví, je-li překročena určitá hodnota návratového kódu.
Implicitně je touto mezí hodnota 10. Někdy je však vhodné ji zvýšit (nebo naopak snížit). A právě k tomu slouží příkaz FAILAT. Jeho argument <n> je nová mez návratového kódu (označení v šabloně je zkratka z Return Code Limit, tedy mez návratového kódu). Toto číslo musí být celé a nezáporné (což je logické, protože záporné návratové kódy také neexistují). Když tento argument nezadáte, vypíše se aktuální mez.
Příklad
| 1.System2.0:> FAILAT 21 |
Zpracování dávkového souboru se nezastaví ani při nejvážnějších chybách (jež vracejí kód 20).
