$ERR.HEL: Difference between revisions
Content added Content deleted
(added this page which is HELp for the $ERR.REX (REXX) program. -- ~~~~) |
m (corrected some typos.) |
||
Line 1: | Line 1: | ||
This '''$ERR.HEL''' page is the contents of the information displayed when the '''$ERR.REX''' REXX program invokes the '''$H.REX''' program to display the '''help''' documentation for the '''$ERR.REX''' REXX program. |
|||
<pre> |
<pre> |
||
The $ERR command is used to display an error message (or messages) from a |
The $ERR command is used to display an error message (or messages) from a |
||
Line 15: | Line 17: | ||
The format of the $ERR command is: |
The format of the $ERR command is: |
||
╔═════════════════════════════════════════════════════════════════════════════╗ |
|||
╔══════════════════════════════════════════════════════════════════════════════╗ |
|||
║ |
║ ║ |
||
║ $ERR |
║ $ERR errNum EXECname {xxx yyy zzz} {..F=fff} ║ |
||
║ , |
║ , ║ |
||
║ ? |
║ ? ║ |
||
║ ?AUTHOR |
║ ?AUTHOR ║ |
||
║ ?FLOW |
║ ?FLOW ║ |
||
║ ?SAMPLES |
║ ?SAMPLES ║ |
||
║ |
║ ║ |
||
╚═════════════════════════════════════════════════════════════════════════════╝ |
|||
╚══════════════════════════════════════════════════════════════════════════════╝ |
|||
───where: |
───where: |
||
? shows this help file |
? shows this help file (press ESC to quit when viewing). |
||
?AUTHOR shows the author of this program. |
?AUTHOR shows the author of this program. |
||
Line 34: | Line 36: | ||
?FLOW shows the external execution flow of this program. |
?FLOW shows the external execution flow of this program. |
||
?SAMPLES shows some sample uses |
?SAMPLES shows some sample uses (press ESC to quit when viewing). |
||
errNum is the number of the error message(s) (numbered from 1400──►1499), |
|||
or 14.1 (which indicates that the REXX program has been |
or 14.1 (which indicates that the REXX program has been HALTed). |
||
0 exits $ERR. |
0 exits $ERR. |
||
' |
' |
||
EXECname is the name of the invoking EXEC and if not a comma, it's shown |
EXECname is the name of the invoking EXEC, and if not a comma, it's shown |
||
the last error message (see above). |
in the last error message (see above). |
||
xxx yyy zzz are optional arguments that the error message text(s) may require. |
xxx yyy zzz are optional arguments that the error message text(s) may require. |
||
Line 51: | Line 53: | ||
The return code is set to the last two digits of the |
The return code is set to the last two digits of the errNum, except for error |
||
1468, which uses the |
1468, which uses the retCode (error code) from the 3rd argument which is an |
||
code code |
code code received from another command that failed. |
||
Another special case is error 14.1 which signifies that the REXX program has |
Another special case is error 14.1 which signifies that the REXX program has |