Programming a BEA Tuxedo ATMI Application Using FML

     Previous  Next    Contents  Open Index in new window  View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Introduction to FML Programming

What Is FML?

How Does FML Fit into the BEA Tuxedo System?

BEA Tuxedo Typed Buffers

FML Terminology

FML and VIEWS Features

Dividing Records into Fields: Data Structures Versus Fielded Buffers

Using Structures to Divide Records into Fields

Using Fielded Buffers to Divide Records into Fields

How Fielded Buffers Are Implemented with FML

FML Features

What Is a Fielded Buffer?

Supported Field Types

Type int in VIEWS

Type dec_t in VIEWS

Field Name-to-Identifier Mappings

Run Time: Field Table Files

Compile Time: Header Files

Fielded Buffer Indexes

Multiple Occurrence Fields in a Fielded Buffer

Boolean Expressions and Fielded Buffers

VIEWS Features

Multiple Occurrence Fields in VIEWS

Error Handling for FML Functions

Setting Up Your Environment for FML and VIEWS

Environment Requirements for FML and VIEWS

FML Directory Structure

Environment Variables Used by FML and VIEWS

VIEW32 Support for MBSTRING

Defining and Using Fields

Preparing to Use FML and VIEWS

Defining Fields for FML and VIEWS

Defining Field Names and Identifiers

Creating Field Table Files

Field Table Example

Mapping Field Names to Field IDs

See Also

Loading Field Tables

See Also

Converting Field Tables to Header Files

Examples of Converting Field Tables to Header Files

Example 1

Example 2

Example 3

Overriding Environment Variables to Run mkfldhdr

Mapping Fields to C Structures and COBOL Records

What Is the VIEWS Facility?

Structure of VIEWS

Creating Viewfiles

Creating View Descriptions

Specifying flag Options in a View Description

Using NULL Values in VIEWS

Compiling Viewfiles

Using Header Files Compiled with viewc

Using COBOL COPY Files Created by the View Compiler

Displaying Viewfile Information After Compilation

Field Manipulation Functions

About This Section

FML and VIEWS: 16-bit and 32-bit Interfaces

Definitions of the FML Function Parameters

Field Identifier Mapping Functions

Fldid

Fname

Fldno

Fldtype

Ftype

Fmkfldid

Buffer Allocation and Initialization

Fielded

Fneeded

Fvneeded

Finit

Falloc

Ffree

Fsizeof

Funused

Fused

Frealloc

Functions for Moving Fielded Buffers

Fmove

Fcpy

Field Access and Modification Functions

Fadd

Fappend

Fchg

Fcmp

Fdel

Fdelall

Fdelete

Ffind

Ffindlast

Ffindocc

Fget

Fgetalloc

Fgetlast

Fnext

Fnum

Foccur

Fpres

Fvals and Fvall

Buffer Update Functions

Fconcat

Fjoin

Fojoin

Fproj

Fprojcpy

Fupdate

VIEWS Functions

Fvftos

Fvstof

Fvnull

Fvsinit

Fvopt

Fvselinit

Conversion Functions

CFadd

CFchg

CFget

CFgetalloc

CFfind

CFfindocc

Converting Strings

Ftypcvt

Conversion Rules

Converting FLD_MBSTRING Fields

Fmbpack32

Fmbunpack32

tpconvfmb32

tpconvvmb32

Indexing Functions

Fidxused

Findex

Frstrindex

Funindex

Example of Sending a Fielded Buffer Without an Index

Input/Output Functions

Fread and Fwrite

Fchksum

Fprint and Ffprint

Fextread

Boolean Expressions of Fielded Buffers

Definitions of Boolean Expressions

Field Names and Types

Strings

Constants

How a Boolean Expression Is Converted for Evaluation

Description of Boolean Primary Expressions

Description of Boolean Expression Operators

Unary Operators Used in Boolean Expressions

Multiplicative Operators Used in Boolean Expressions

Additive Operators Used in Boolean Expressions

Equality and Match Operators Used in Boolean Expressions

Relational Operators Used in Boolean Expressions

Exclusive OR Operator Used in Boolean Expressions

Logical AND Operator Used in Boolean Expressions

Logical OR Operator Used in Boolean Expressions

Sample Boolean Expressions

Boolean Functions

Fboolco and Fvboolco

Fboolpr and Fvboolpr

Fboolev and Ffloatev, Fvboolev and Fvfloatev

VIEW Conversion to and from Target Format

Fvstot, Fvftos and Fcodeset

FML and VIEWS Examples

VIEWS Examples

Sample Viewfile

Sample Field Table

Sample Header File Produced by viewc

Sample Header File Produced by mkfldhdr

Sample COBOL COPY File

Sample VIEWS Program

Example of VIEWS in bankapp

See Also

FML Examples in bankapp

FML Error Messages


  Back to Top       Previous  Next