NAME

ERROR HANDLING − default PHIGS error handling routine

SYNOPSIS

C Syntax

void
perr_hand ( errnum, funcnum, fname )
Pinterrnum;error number
Pintfuncnum;Number of function that detected the error
char∗fname;name of error file

Required PHIGS Operating States

(∗, ∗, ∗, ∗)

DESCRIPTION

Purpose

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 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

errnum
The number of the error detected. The error numbers and corresponding error messages are listed with each function description in this reference.

funcnum
The identification of the function that detected the error.

fnameA pointer to a character string containing the name of the error file.  The error file is specified in the call to OPEN PHIGS. 

Execution

ERROR HANDLING is called by a PHIGS function that has deteced an error.  The default ERROR HANDLING function performs no other processing than to call ERROR LOGGING. 

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

ERRORS

No Errors

SEE ALSO

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

September 02, 1992