GPEXIT - Specify an Error Exit and Error Threshold

Purpose

Use GPEXIT to specify a second-level error handler to receive control at the end of a graPHIGS API subroutine call if an error of at least the specified severity is encountered.

The severity of an error can be assigned by the first-level error handler (see Define Error Handling [GPEHND] [page GPEHND - Define Error Handling Subroutine]) subroutine, which receives control before the second-level error handler.

If a value of zero or less is specified for the severity parameter of this subroutine, the error exit is invoked after every call to the graPHIGS API If a severity level of 17 or more is specified, the error exit is never invoked.

When the error severity threshold is zero, your second-level error exit routine should perform the following steps to prevent infinite loops:

The default error exit can be reset by specifying an error exit address consisting of a fullword binary zero.

Control is returned to the application statement following the one which invoked the graPHIGS API A second-level error handler can call any graPHIGS API subroutine except the Error Logging (GPELOG) subroutine.

Parameters