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

System Variables Containing Error Information
Run-Time Error Handling
106160 Tandem Computers Incorporated 7–21
System Variables
Containing Error
Information
NCL provides system variables that you can use to obtain information when a run-
time error occurs during the execution of an NCL process. These variables are listed in
Table 7-2. These variables have the following characteristics:
They begin with the stem and substem, &SYS.ERROR.
They are read-only variables.
They are accessible only from within an error handler. (If you use them outside an
error handler, NCL raises an error.)
For more information on these system variables, refer to the NonStop NET/MASTER
NCL Reference Manual.
Table 7-2. System Variables Containing Error Information
System Variable Description
&SYS.ERROR.CODE Contains the integer setting that indicates the NCL error type.
&SYS.ERROR.COLUMN Contains the column in a line of code in which an error occurred.
&SYS.ERROR.COND Contains the name of the error condition that was issued.
&SYS.ERROR.FILE Contains the name of the source file associated with the NCL
procedure that issued the error.
&SYS.ERROR.KEYWORD Contains the keyword that caused the error.
&SYS.ERROR.LIB Contains the name of the source library associated with the NCL
procedure that issued the error.
&SYS.ERROR.LINE Contains the line number in the source file in which the error
occurred.
&SYS.ERROR.NAME Contains the name specification that caused the error before
substitution.
&SYS.ERROR.PROCNAME Contains the name of the procedure that caused an error to be
raised.
&SYS.ERROR.RESUMEOK Indicates if the procedure can be resumed.
&SYS.ERROR.RETRYOK Indicates if the statement causing the error can be retried.
&SYS.ERROR.STMT Contains the statement number that caused the error to be issued.
&SYS.ERROR.STMT_NAME Contains the name of the statement that caused the error.
&SYS.ERROR.SUBNAME Contains the name specification that caused the error after
substitution.
&SYS.ERROR.TEXT Contains additional information on the nature of an NCL error or
condition.
&SYS.ERROR.VALUE Contains the value that caused the error to be issued.
&SYS.ERROR.VALUEOK Indicates whether &SYS.ERROR.VALUE contains information about
an error.
&SYS.ERROR.VALUE2 Contains a second value that caused the error to be issued.
&SYS.ERROR.VALUE2OK Indicates whether &SYS.ERROR.VALUE2 contains information
about an error.