NAME

DsSetErrorVars − Specify an error file and error handler

SYNOPSIS

C:

void DsSetErrorVars(errorfile, errorhandler)
DtInt errorfile;
DtPFI errorhandler;

Fortran:

CALL DSSEV(ERRFIL, ERRHND)
INTEGER∗4 ERRFIL
EXTERNAL ERRHND

DESCRIPTION

DsSetErrorVars installs an application error file descriptor and error handler.  The parameter errorfile specifies the file descriptor to which any error messages should be sent. The value 2 is usually standard error, i.e., the terminal, and is also the default error file. 

The parameter errorhandler specifies the error handling procedure to be called when errors are detected.  If this parameter is DcNullPtr <DCNULL>, the default error handler prints the error information to errorfile and, if the error is fatal, it exits the program. 

A user supplied error handling procedure in C should have the following format:

 MyErrorFunction(errorfile, errornumber, funcname, errorstring)
DtInt errorfile;
DtPtr funcname;
DtInt errornumber;
DtPtr errorstring;

FORTRAN SPECIFIC

A user supplied error handling procedure in Fortran should have the following format:

 ERRFUN(ERRFIL, ERRNUM, FCNNAM, FCNNML, ERRSTR, ERRSTL)
INTEGER∗4 ERRFIL
INTEGER∗4 ERRNUM
INTEGER∗4 FCNNML
INTEGER∗4 ERRSTL
CHARACTER∗FCNNML FCNNAM
CHARACTER∗ERRSTL ERRSTR
 

Where FCNNAM is a function name FCNNML characters long and ERRSTR is an error string ERRSTL characters long. 

SEE ALSO

DsInqErrorMessage(3D)

September 29, 2021