BEA Logo BEA Tuxedo Release 8.0

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

 

   Tuxedo Documentation   |   FML Function Reference   |   Local Topics   |   Previous Topic   |   Next Topic   |   Contents

 


Fvopt, Fvopt32(3fml)

Name

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

Synopsis

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

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

#include "fml32.h"

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

Description

Fvopt() allows users to specify buffer-to-structure mapping options at run time. 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:

F_FTOS

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

F_STOF

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

F_OFF

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

F_BOTH

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.

Errors

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

[FEINVAL]

"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).

[FBADVIEW]

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

[FNOCNAME]

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

See Also

Introduction to FML Functions, viewfile(5)

 

back to top previous page next page