GERR_CONTROL(3G)

NAME

gerr_control − control the handling of a graphics error.

SYNOPSIS

C SYNTAX

void gerr_procedure(proc);
void (*proc)();
void gerr_defaults();
void gerr_print_control(print_gerr)
int print_gerr;
char *gerr_message(errnumber);
int errnumber;

FORTRAN77 SYNTAX

        subroutine gerr_procedure(proc)
        integer*4 function proc
        subroutine gerr_defaults()
        subroutine gerr_print_control(print_gerr)
        integer*4 print_gerr
        subroutine gerr_message(errnumber, mesg)
        character*(*) mesg
        integer*4 errnumber

PASCAL SYNTAX

procedure gerr_procedure(procedure proc);
procedure gerr_defaults();
procedure gerr_print_control(print_gerr:integer);
procedure gerr_message(errnumber:integer;var mesg:string);

HP-UX COMPATIBILITY

Level: HP-UX/STANDARD

Origin: HP

DESCRIPTION

INPUT PARAMETERS

proc
is a pointer to the user supplied procedure to be called when an error is detected. If the pointer is null then the default procedure will be called.
print_gerr
is an integer value which determines if errors and/or warnings or neither are to be printed.
errnumber
is an error number

DISCUSSION

Gerr_control is used to specify a user supplied procedure to be called when an error is detected. If a null pointer is passed, then the Starbase system procedure will be called. For systems which find it difficult (or impossible) to pass a null procedure pointer, the gerr_defaults procedure is provided which re-instates the default conditions listed below.

Gerr_message returns the text of an error message. The maximum length of a message is 80 characters. The control of error mesage printing is handled by the gerr_print_control procedure.

The values for print_gerr are:

     NO_ERROR_PRINTING
     PRINT_ERRORS
     PRINT_WARNINGS

and may be or’ed together for desired combinations.

DEFAULTS

The Starbase system error procedure is called when an error is detected. Print-gerr = PRINT_ERRORS (only errors are printed, warnings are not printed.)

Museum

Related Articles