NET/MASTER Network Control Language (NCL) Programmer's Guide

System-Defined Error Handlers for Specific Conditions
Run-Time Error Handling
106160 Tandem Computers Incorporated 7–23
System-Defined Error
Handlers for Specific
Conditions
This subsection lists and then describes the system-defined error handlers that are
available to trap specific conditions, including the system variables that are set
specifically when the error handler is raised. Table 7-3 lists the available error
handlers.
Table 7-3. System-Defined Error Handlers for Specific Conditions
Error Handler Description
ARITH_ERROR Traps overflow, underflow, and division-by-zero errors that occur when
performing arithmetic operations.
FILE_ERROR Traps errors resulting from the use of FILE verbs.
FLUSH_ERROR Traps the FLUSH command.
LABEL_ERROR Traps errors that occur when NCL cannot find a label, the label is found
but is an illegal name, the label is in an illegal position, the label is too
long, and so on.
LOADFAIL_ERROR Indicates a failure to find or load an external NCL procedure or function.
LOOPING_ERROR Traps the case in which the looping protection mechanism has been
triggered.
PANEL_END Traps the case when NCL detects a request to move one level up in a
hierarchy of panels (the END function).
PANEL_ERROR Traps panel validation processing errors by Panel Services.
PANEL_RETURN Traps the case when NCL detects a request to move up to the top level
panel in a hierarchy of panels (the RETURN function).
PANEL_SKIP_PMENU Traps the case when a panel skip string is entered for moving to another
panel through the top-most panel in a hierarchy (a primary menu).
PSEND_ERROR Traps errors resulting from the use of the PSEND verbs.
RANGE_ERROR Traps errors that occur when data is of the correct type for an operation
but the value is out of range.
STRING_ERROR Traps the case in which NCL attempts to construct a string that exceeds
the internal data limitations of strings.
TYPE_ERROR Traps the case in which NCL cannot convert a value of one type to a
corresponding value of another type.
VARIABLE_ERROR Traps errors that occur when NCL detects an illegal variable name or a
variable name used within an illegal context.
VERB_ERROR Traps errors that occur when a verb detects a logical error condition.
Note The general error handler—ERROR—is discussed earlier in this section.