1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
|
.\"##
.\" $XConsortium: p318,v 5.1 91/02/16 09:43:09 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
|
