FAILAT

Syntaxe

Paramètres

Description

Cette commande permet d'envoyer un code d'erreur au système d'exploitation.

Remarques

• La commande FAILAT permet de demander à une séquence de commandes d'échouer si un programme renvoie un code d'erreur supérieur ou égal à ce nombre.
• Les commandes indiquent qu'elles ont échoué d'une manière ou d'une autre en définissant un code de retour. Un code de retour différent de zéro indique que la commande a trouvé une erreur quelconque. Un code de retour supérieur ou égal à une certaine limite (la limite d'échec) met fin à une séquence de commandes non interactives (c'est-à-dire les commandes que vous spécifiez après RUN ou dans un fichier EXECUTE). Le code de retour indique la gravité de l'erreur et est normalement de 5, 10 ou 20.
• Vous pouvez utiliser la commande FAILAT pour modifier ce niveau d'échec par rapport à sa valeur initiale de 10. Si vous augmentez le niveau, vous indiquez que certaines classes d'erreur ne doivent pas être considérées comme fatales et que l'exécution des commandes suivantes peut se poursuivre après une erreur. Le paramètre doit être un nombre positif. Le niveau d'échec est réinitialisé à la valeur initiale de 10 à la sortie de la séquence de commandes.
• Vous devez utiliser FAILAT avant des commandes telles que IF pour tester pour voir si une commande a échoué; sinon, la séquence de commandes se termine avant d'exécuter la commande IF.
• Si vous omettez le paramètre, la valeur actuelle du niveau d'échec s'affiche.

Exemple

L'exemple suivant permet d'indiquer que la séquence de commandes ne se termine pas avant la fin que si une commande s'arrête avec un code retour supérieur ou égal (>=) à 25 :