NAME

SET ERROR HANDLING MODE − set the current error handling mode

SYNOPSIS

C Syntax

void
pset_err_hand_mode ( mode )
Perr_modemode;error handling mode

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

SET ERROR HANDLING MODE enables (ON) or disables (OFF) PHIGS error reporting. 

The default error handling mode is ON. 

C Input Parameter

modeAn enumerated value specifying whether PHIGS error reporting should be enabled or disabled.  Valid values (defined in phigs.h) for this parameter are:

PERR_OFF
PERR_ON

Execution

If the error handling mode is on when an error is detected by a PHIGS function, the function calls ERROR HANDLING.  If the error handling mode is off, the PHIGS function detecting the error does not call ERROR HANDLING. 

When the ERROR HANDLING function is called, it accepts the identification of the error condition, the identification of the subroutine calling it, and the name of the error file.  The default PHIGS ERROR HANDLING routine simply calls the ERROR LOGGING function to write this information to the error file. 

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

SEE ALSO

ERROR HANDLING (3P)
INQUIRE ERROR HANDLING MODE (3P)
OPEN PHIGS (3P)

September 02, 1992