[Guide to AmigaDOS 3\Failat] 
 

FAILAT

Format: FAILAT [<n>] Template: RCLIM/N Purpose: To instruct a command sequence to fail if a program gives a return code greater than or equal to the given value. Path: Internal Specification: Commands indicate that they have failed in some way by setting a return code. A nonzero return code indicates that the command has encountered an error of some sort. The return code, normally 5, 10, or 20, indicates how serious the error was. A return code greater than or equal to a certain limit, the fail limit, terminates a sequence of non-interactive commands (commands you specify after RUN or in a script). You may use the FAILAT command to alter the fail limit RCLIM (Return Code Limit) from its initial value of 10. If you increase the limit, you indicate that certain classes of error should not be regarded as fatal and that execution of subsequent commands may proceed after an error. The argument must be a positive number. The fail limit is reset to the initial value of 10 on exit from the command sequence. If the argument is omitted, the current fail limit is displayed. Example: Assume a script contains the following lines: COPY DF0:MyFile to RAM: ECHO "MyFile being copied." If MyFile cannot be found, the script will be aborted and the following message will appear in the Shell window: COPY: object not found COPY failed returncode 20: However, if you changed the return code limit to higher than 20, the script would continue even if the COPY command fails. For example, if you changed the script to read: FAILAT 21 COPY DF0:MyFile to RAM: ECHO "MyFile being copied." Even if MyFile cannot be found, the script will continue. The following message will appear in the Shell window: COPY: object not found MyFile being copied. See also: ECHO EXECUTE


Converted from AmigaGuide format to basic HTML by Jaruzel.