DERROR C-3

NAME

derror, derrmsg - describe last I/O error

SYNOPSIS

#include <cbase/direr.h>

derror()

char *derrmsg()

DESCRIPTION

Each RMS routine saves an error number and error message when it encounters an error. Derror returns the saved error number from the last RMS error that occurred, and clears the saved error number. Derrmsg returns a pointer to a string that contains the saved error message describing the last RMS error that occurred, and clears the saved error message.

Normally, you should call derror or derrmsg only after an RMS routine fails (e.g. returns BAD or NULL, as appropriate).

The error messages and numbers are symbolically defined in the include file <cbase/direr.h>.

SEE ALSO

Chapter 4,

RMS Programming Guide

DIAGNOSTICS

Derror returns a zero if there have been no RMS errors since the last call to derror, or if there have been no RMS errors and derror has not been previously called.

Derrmsg returns NULL if there have been no RMS errors since the last call to derrmsg, or if there have been no RMS errors and derrmsg has not been previously called.