Error Message Variables

The $DBGLVL Variable

$\textbf{{\char36}DBGLVL}$

The debug level

Type: Numeric, Read/Write

The debug level can be set from levels 0 through 3. A higher level also includes all messages of lower levels.

0:

Turns debug traces to OFF.

1:

Is intended for user-defined debug information issued from macros and must be implemented by the control emulator developer.

2:

Internal debug information that can be useful when investigating issues.

3:

Additional information containing more details.

User implementing their own debug messages using this mechanism should test the $DBGLVL and issue their message if the value is not zero.

The $DIAGLIST Variable

$\textbf{{\char36}DIAGLIST}$

List of diagnostic numbers in the order reported

Type: Sequence, Read/Write

The $DIAGLIST sequence variable contains a list of diagnostic numbers in the order that they have been reported. This informational variable is settable, to simplify testing for diagnostics that occur following an event. Use the $FFIND function to test if a specific diagnostic has occurred.

The $ERRMSG Variable

$\textbf{{\char36}ERRMSG}$

Error message on indicator

Type: Logical, Read/Write

The $ERRMSG variable indicates if error messages are to be output or not. Error messages may be disabled by setting $ERRMSG to $FALSE. To enable error message output set $ERRMSG to $TRUE.

The $ERRNO Variable

$\textbf{{\char36}ERRNO}$

Last I/O status

Type: Numeric, Read-only

The $ERRNO variable contains the I/O status code returned by the system following the last OPEN, READ, WRITE or CLOSE command. I/O status codes are system specific, but most systems use a status of zero for success, negative for warning (like end-of-file) and positive for errors.

The $ERR08 Variable

$\textbf{{\char36}ERR08}$

Number of error diagnostics

Type: Numeric, Read/Write

The $ERR08 variable is a count of the current number of diagnostics at severity levels 8 through 15.

The $FTL16 Variable

$\textbf{{\char36}FTL16}$

Number of fatal error diagnostics

Type: Numeric, Read/Write

The $FTL16 variable is a count of the current number of diagnostics at severity level 16 or higher.

The $MSG00 Variable

$\textbf{{\char36}MSG00}$

Number of informational diagnostics

Type: Numeric, Read/Write

The $MSG00 variable is a count of the current number of diagnostics at severity levels 0 through 3.

The $WRN04 Variable

$\textbf{{\char36}WRN04}$

Number of warning diagnostics

Type: Numeric, Read/Write

The $WRN04 variable is a count of the current number of diagnostics at severity levels 4 through 7.