NAME

SET ERROR HANDLING − Set the error handling function -- C binding only

SYNOPSIS

C Syntax

void
pset_err_hand ( new_err_hand, old_err_hand )
void(∗new_err_hand) (); application’s error handling function
void(∗∗old_err_hand) (); OUT old error handling function

Required PHIGS Operating States

(∗, ∗, ∗, ∗)

DESCRIPTION

SET ERROR HANDLER sets the error handling function that will be called when PHIGS reports an error.  The default function is perr_hand.  See the ERROR HANDLING man page for a description of the parameters passed to the error handling function. 

Purpose

Use SET ERROR HANDLER is used to set the error handling function to an application’s own error handling function. 

When the error handling mode is ON, ERROR HANDLING is called by PHIGS functions when they detect an error. 

An application may replace the default ERROR HANDLING function, using this function, in order to modify the default response to errors, which is simply to call ERROR LOGGING.  Any such replacement must have the name above and accept the same parameters. 

C Input Parameters

new_err_hand
A function that is to be the new error handling function.

old_err_hand
A pointer to a function pointer where the current error handling function will be returned.

Execution

SET ERROR HANDLER sets the error handling function that will be called when PHIGS reports an error.  The error handling function is called by PHIGS when an error is detected in a non-inquiry function and the error handling mode is ON. 

See OPEN PHIGS for a description of the PHIGS interaction with the error file. 

ERRORS

No Errors

SEE ALSO

ERROR HANDLING (3P)
ERROR LOGGING (3P)
SET ERROR HANDLING MODE (3P)

September 02, 1992