TACL Reference Manual

Built-In Functions and Variables

HP NonStop TACL Reference Manual—429513-018

9-162

#ERRORTEXT Built-In Function

Use #ERRORTEXT with exception handlers to intercept any error text that might have

been written to OUT if there had been no exception handler.

option

is one of these:

CAPTURE variable-level

indicates that the specified variable level is to be cleared and the current error

text, if any, moved into it.

CLEAR

specifies that the current error text is to be discarded.

Result

#ERRORTEXT returns nothing.

Considerations

•

If an error occurs while you are filtering _ERROR (see #EXCEPTION Built-In

Function on page 9-163), TACL stores the resulting error text internally. Previously

stored text is lost, so only the most recent error text is available.

•

The captured error text is not fully formatted and usually contains some internal

representations. It is, therefore, suitable only for output with #OUTPUTV or

OUTVAR.

#ERRORTEXT / option /