BEA Logo BEA Tuxedo Release 7.1

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy


   Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

F_error, F_error32(3fml)


F_error(), F_error32() - print error message for last error


#include stdio.h> 
#include "fml.h"
extern int Ferror;
F_error(char *msg)
#include "fml32.h"
extern int Ferror32;
F_error32(char *msg)


The function F_error() works like perror() for UNIX System errors; that is, it produces a message on the standard error output (file descriptor 2), describing the last error encountered during a call to a system or library function. The argument string msg is printed first, then a colon and a blank, then the message and a newline. If msg is a null pointer or points to a null string, the colon is not printed. To be of most use, the argument string should include the name of the program that incurred the error. The error number is taken from the external variable Ferror, which is set when errors occur but not cleared when non-erroneous calls are made. In the MS-DOS and OS/2 environments, Ferror is redefined to FMLerror.

To immediately print an error message, F_error() should be called on an error return from another FML function. When the error message is FEUNIX. Uunix_err() is called.

F_error32() is used with 32-bit FML.

A thread in a multithreaded application may issue a call to F_error() or F_error32() while running in any context state, including TPINVALIDCONTEXT.

Return Values

F_error() is declared a void and as such does not have return values.

See Also

Introduction to FML Functions

perror(3), Uunix_err(3) in a UNIX system reference manual