Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy
	http://www.oracle.com/technology/documentation/index.html   |   Site Map   |   Search   |   PDF Files   |   Contact   |   Glossary
Tuxedo Doc Home   |   Reference   |   Topic List   |   Previous   |   Next   |   Contents

   BEA Tuxedo FML Function Reference

Fwrite(), Fwrite32() - write fielded buffer

#include <stdio.h> 
#include "fml.h" 
 
int 
Fwrite(FBFR *fbfr, FILE *iop) 
 
#include "fml32.h" 
 
int 
Fwrite32(FBFR32 *fbfr, FILE *iop)

Fielded buffers may be written to streams by Fwrite(). (See stdio(3S) in a UNIX System reference manual for a discussion of streams). Fwrite() discards a buffer's index.

fbfr is a pointer to a fielded buffer. iop is a pointer of type FILE to the output stream.

For the FLD_PTR field type, only the pointer, not the data being pointed to, is written to the output stream. For the FLD_VIEW32 field type, only the FVIEWFLD structure, not the data in the VIEW32 buffer, is written to the output stream.

Fwrite32() is used with 32-bit FML.

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

This function returns -1 on error and sets Ferror to indicate the error condition.

Under the following conditions, Fwrite() fails and sets Ferror to:

[FALIGNERR]

"fielded buffer not aligned"
The buffer does not begin on the proper boundary.

[FNOTFLD]

"buffer not fielded"
The buffer is not a fielded buffer or has not been initialized by Finit().

[FEUNIX]

"UNIX system call error"
The write system call failed. The external integer errno should have been set to indicate the error by the system call, and the external integer Uunixerr (values defined in Uunix.h) is set to the system call that returned the error.

This function is not supported using the BEA Tuxedo system Workstation DLL for OS/2 and Microsoft Windows.

Introduction to FML Functions, Findex, Findex32(3fml), Fread, Fread32(3fml)

stdio(3S) in a UNIX system reference manual