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

Fldid, Fldid32(3fml)

Name

Fldid(), Fldid32() - map field name to field identifier

Synopsis

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

FLDID
Fldid(char *name)

#include "fml32.h"

FLDID32
Fldid32(char *name)

Description

Fldid() provides a runtime translation of a field-name to its field identifier and returns a FLDID corresponding to its field name parameter. The first invocation causes space to be dynamically allocated for the field tables and the tables to be loaded. To recover data space used by the field tables loaded by Fldid(), the user may unload the files by a call to the Fnmid_unload() function.

Fldid32() is used with 32-bit FML.

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

Return Values

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

Errors

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

[FBADNAME]

"unknown field name"
A field name is specified which cannot be found in the field tables.

[FMALLOC]

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

See Also

Introduction to FML Functions, Fldno, Fldno32(3fml), Fname, Fname32(3fml), Fnmid_unload, Fnmid_unload32(3fml)

malloc(3) in a UNIX system reference manual