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–27
The PSEND_ERROR Error
Handler
If present, the PSEND_ERROR error handler traps errors resulting from the use of the
PSEND verbs. From the PSEND OPEN verb, errors include being unable to access the
specified server class. From the PSEND SEND verb, errors include using incompatible
keywords, that is, using DATA, VARS, or ARGS with MDO, and either or both
PATHSEND and file system errors as described in the Pathway Application
Programming Guide. This error handler is set by the following ON statement:
ON PSEND_ERROR statement
See Section 15, “Working With Pathway Server Classes,” for more information on how
to work with existing Pathway server classes from an NCL process.
The RANGE_ERROR Error
Handler
If present, the RANGE_ERROR error handler traps errors that occur when data is of
the correct type but the value is out of range. This error handler is set by the following
ON statement:
ON RANGE_ERROR statement
Refer to the discussion on expressions and operators in the NonStop NET/MASTER
NCL Reference Manual for more information on acceptable ranges.
The STRING_ERROR Error
Handler
If present, the STRING_ERROR error handler traps the case in which NCL attempts to
construct a string that exceeds the internal data limitations of strings (the limit is 32K).
This error handler is set by the following ON statement:
ON STRING_ERROR statement
The following system variables are set specifically for this error handler:
System Variable Setting of System Variable
&SYS.ERROR.VALUE Contains the first incorrect term in an expression.
&SYS.ERROR.VALUEOK Contains 1 (TRUE) or 0 (FALSE).
&SYS.ERROR.VALUE2 Contains the second incorrect term in an expression.
&SYS.ERROR.VALUE2OK Contains 1 (TRUE) or 0 (FALSE).
Refer to the discussion on expressions and operators in the NonStop NET/MASTER
NCL Reference Manual for more information on strings.
The TYPE_ERROR Error
Handler
If present, the TYPE_ERROR error handler traps the case in which NCL cannot convert
a value of one type to a corresponding value of another type (a type mismatch). This
applies only to the basic underlying types (string, numeric, integral, and logical) rather
than the value of that type.
This error handler is set by the following ON statement:
ON TYPE_ERROR statement