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

Fvopt, Fvopt32(3fml)


Fvopt(), Fvopt32() - change flag options of a mapping entry


#include <stdio.h> 
#include "fml.h"

Fvopt(char *cname, int option, char *view)

#include "fml32.h"

Fvopt32(char *cname, int option, char *view)


Fvopt() allows users to specify buffer-to-structure mapping options at runtime. cname is a pointer to the name of an element in a view description, view. option specifies the desired setting for the mapping option. Valid options and their meanings are:


one-way mapping from fielded buffer to structure, flag S in the view description


one-way mapping from structure to fielded buffer, flag F in the view description


no mapping between the fielded buffer and the structure, flag N in the view description


two-way mapping between the fielded buffer and the structure, flag S, F in the view description

Fvopt32() is used for views defined with viewc32 or VIEW32 typed buffers for larger views with more fields.

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

Return Values

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


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


"invalid argument to function"
One of the arguments to the function invoked was invalid (for example, specifying a NULL cname or view parameter or specifying an invalid option).


"cannot find or get view"
The view was not found in the files specified by VIEWDIR and VIEWFILES.


"cname not found"
The C structure field name is not found in the view description.

See Also

Introduction to FML Functions, viewfile(5)