SET ERROR HANDLING MODE(3P) — SUNPHIGS LIBRARY

NAME

SET ERROR HANDLING MODE − set the current error handling mode

SYNOPSIS

C Syntax

void
pseterrorhandmode ( mode )
Perrormodemode;error handling mode

FORTRAN Syntax

SUBROUTINE pserhm ( ERHM )
INTEGERERHMerror handling mode (POFF, PON)

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use SET ERROR HANDLING MODE to enable (ON) or disable (OFF) the PHIGS ERROR HANDING routine.

The default error handling mode is ON.

C Input Parameter

modeAn enumerated variable specifying whether the PHIGS error handling system is on or off. Valid values (defined in phigs.h) for this parameter are:

PERROR_OFF
PERROR_ON

FORTRAN Input Parameter

ERHM
An enumerated variable specifying whether the PHIGS error handling system is on or off. Valid values (defined in phigs77.h) for this parameter are:

POFF
PON

Execution

If the error handling mode is on and an error is detected by a PHIGS subroutine, the subroutine calls the ERROR HANDLING subroutine and performs a built in error reaction (this generally consists of any cleanup operations that are possible).

If the error handling mode is off, the PHIGS subroutine which detects an error performs its built-in error reaction, but does not call ERROR HANDLING.

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

ERRORS

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

Museum