.\"##
.\" $XConsortium: p318,v 5.2 94/04/17 20:58:08 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "SET ERROR HANDLING MODE" 3P "29 February 1991"
.SH NAME
SET ERROR HANDLING MODE \- set the current error handling mode
.IX "Errors" "SET ERROR HANDLING MODE"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pset_err_hand_mode ( mode )
Perr_mode	mode;	\fIerror handling mode\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, *, *)
.SH DESCRIPTION
.SS Purpose
\s-2SET ERROR HANDLING MODE\s+2 enables (\s-2ON\s+2)
or disables (\s-2OFF\s+2) \s-2PHIGS\s+2 error reporting.
.LP
The default error handling mode is \s-2ON\s+2.
.SS C Input Parameter
.IP \fImode\fP
An enumerated value specifying whether \s-2PHIGS\s+2 error reporting
should be enabled or disabled.
Valid values (defined in phigs.h) for this parameter are:
.sp
.ta .3i
.nf
	PERR_OFF
	PERR_ON
.fi
.SS Execution
If the error handling mode is on when an error is detected by a
\s-2PHIGS\s+2 function, the function calls \s-2ERROR HANDLING\s+2.
If the error handling mode is off, the \s-2PHIGS\s+2 function
detecting the error does not call \s-2ERROR HANDLING\s+2.
.LP
When the \s-2ERROR HANDLING\s+2 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 \s-2PHIGS ERROR HANDLING\s+2 routine simply calls the \s-2ERROR
LOGGING\s+2 function to write this information to the error file.
.SH ERRORS
.IP 002
Ignoring function, function requires state (\s-2PHOP, *, *, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "ERROR HANDLING (3P)"
.SM "INQUIRE ERROR HANDLING MODE (3P)"
.SM "OPEN PHIGS (3P)"
.fi
