|
|
|
|
|
|
Error Handling for FML Functions
When an FML function detects an error, one of the following values is returned:
All FML function call returns should be checked against the appropriate value above to detect errors.
In all error cases, the external integer Ferror is set to the error number as defined in fml.h. Ferror32 is set to the error number for FML32 as defined in fml32.h.
The F_error() (or F_error32()) function is provided to produce a message on the standard error output. It takes one parameter, a string. It prints the argument string, appended with a colon and a blank, and then prints an error message, followed by a newline character. The error message displayed is the one defined for the error number currently in Ferror, which is set when errors occur.
To be of most use, the argument string to the F_error() (or F_error32()) function should include the name of the program that incurred the error. Refer to F_error, F_error32(3fml) in the BEA Tuxedo ATMI FML Function Reference.
Fstrerror, Fstrerror32(3fml) can be used to retrieve the text of an error message from a message catalog; it returns a pointer that can be used as an argument to userlog(3c), or to F_error() or F_error32().
For a description of the error codes produced by an FML function, see the entry for that function in the BEA Tuxedo ATMI FML Function Reference.
|
|
|
|
|
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|