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

Fname(), Fname32() - map field identifier to field name

#include <stdio.h> 
#include "fml.h" 
 
char * 
Fname(FLDID fieldid) 
 
#include "fml32.h" 
 
char * 
Fname32(FLDID32 fieldid)

Fname() provides a runtime translation of a field identifier, fieldid, to its field name and returns a pointer to a character string containing the name corresponding to its argument. The first invocation causes space to be dynamically allocated for the field tables and the tables to be loaded. The table space used by the mapping tables created by Fname() may be recovered by a call to the function Fidnm_unload().

Fname32() is used with 32-bit FML.

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

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

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

[FBADFLD]

"unknown field number or type"
A field number is specified for which a field name cannot be found or is invalid (0).

[FMALLOC]

"malloc failed"
Allocation of space dynamically using malloc() failed.

Introduction to FML Functions, Ffprint, Ffprint32(3fml), Fidnm_unload, Fidnm_unload32(3fml), Fldid, Fldid32(3fml), Fprint, Fprint32(3fml)