ERROR LOGGING(3P) — SUNPHIGS LIBRARY

NAME

ERROR LOGGING − log SunPHIGS errors on error file

SYNOPSIS

C Syntax

void
perrorlog ( err_num, func_num, err_file )
Pinterr_num;error number
Pintfunc_num;Number of function that detected the error
Pchar∗err_file;name of error file

FORTRAN Syntax

SUBROUTINE perlog ( ERRNR, FCTID, ERRFIL )
INTEGERERRNRerror number
INTEGERFCTIDfunction identification
INTEGERERRFILerror file

Required PHIGS Operating States

(∗, ∗, ∗, ∗)

DESCRIPTION

Purpose

ERROR LOGGING is called to write an error message and the identification of the PHIGS function detecting the error to the error file. The error file is specified in the OPEN PHIGS function. See OPEN PHIGS for a description of the PHIGS interaction with the error file. ERROR LOGGING is always called by ERROR HANDLING but may also be called by the application.

C Input Parameters

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

func_num
The identification of the function which detected the error.

err_file
A pointer to the character string containing the name of the error file specified in the OPEN PHIGS function.

FORTRAN Input Parameters

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

FCTID
The identification of the function which detected the error.

ERRFIL
The FORTRAN Logical Unit Number (LUN) of the error file specified in the OPEN PHIGS function. See OPEN PHIGS for a description of valid values.

Execution

When ERROR LOGGING is called it writes to the error file: the error number, a description of the error, and the function number of the function that detected the error.

ERROR LOGGING produces error messages of the form:

SunPHIGS error <number> in <function name>: <error message text>

ERRORS

No Error

Museum