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

Fchgs, Fchgs32(3fml)


Fchgs(), Fchgs32() - change field occurrence - caller presents string


#include <stdio.h> 
#include "fml.h"
Fchgs(FBFR *fbfr, FLDID fieldid, FLDOCC oc, char *value)
#include "fml32.h"
Fchgs32(FBFR32 *fbfr, FLDID32 fieldid, int oc, char *value)


Fchgs(), is provided to handle the case of conversion from a user type of FLD_STRING. fbfr is a pointer to a fielded buffer. fieldid is a field identifier. oc is the occurrence number of the field. value is a pointer to the string to be added. The function calls its non-string-function counterpart, CFchg(), providing a type of FLD_STRING, and a len of 0 to convert from a string to the field type of fieldid.

Fchgs32() is used with 32-bit FML.

A thread in a multithreaded application may issue a call to Fchgs() or Fchgs32() 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, Fchgs() fails and sets Ferror to:


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


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


"no space in fielded buffer"
A field value is to be added or changed in a fielded buffer but there is not enough space remaining in the buffer.


"unknown field number or type"
A field identifier is specified which is not valid.


"invalid field type"
A field identifier is specified which is not valid.

See Also

Introduction to FML Functions, CFchg, CFchg32(3fml), Fchg, Fchg32(3fml)