NET/MASTER Network Control Language (NCL) Reference Manual

RETRY
Core Statements
106126 Tandem Computers Incorporated 2–51
RETRY The RETRY core statement returns to and retries the statement that caused an ON
block to be executed. The RETRY statement terminates any execution environment
established after the start of the most recently executed ON block. (The ON core
statement, described earlier in this section, defines an ON block.) This includes DO
groups and calls to procedures, and functions. Like the RESUME core statement,
RETRY is always located within an ON block.
If you try to issue a RETRY statement outside of an ON block (error handler), NCL
terminates the process with an error message.
RETRY
Considerations
Execution of the RETRY statement might not always be permitted. For example,
you cannot RETRY a SIGNAL statement (it generates the original condition). Use
the &SYS.ERROR.RETRYOK system variable (&SYS.ERROR.RETRYOK = 0 or 1)
to see if it is valid to retry the condition that caused the error. For further
information about system variables, see Section 5, “System Variables.”
If you retry a statement that again causes an ON block to execute, a retry from that
ON block is invalid. An error is displayed on the OCS display window, and the
procedure is flushed. This prevents looping on the same error condition. Correct
the error before attempting to issue a RETRY.
See also ON, RESUME, REVERT, and SIGNAL. These core statements are all
relevant to condition and error handling. The ON core statement defines an ON
block, which determines what you want to do for a specified condition or error.
The RESUME core statement ignores the statement that generated the condition or
error. The REVERT core statement deactivates an ON block. The SIGNAL core
statement generates a condition.