Contents

Title Page

Copyright Page

1. Introduction

About This Guide and FML

How Does FML Fit into the BEA TUXEDO System?

Who Is This Document For?

What Does This Document Include?

What Other FML Documentation Is There?

Concepts and Definitions

BEA TUXEDO System Typed Buffers

2. Overview

Introduction

Dividing Records into Fields

: Structures
: Fielded Buffers

Implementing Fielded Buffers with FML

FML Features

Fielded Buffer Structure

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

Multiply Occurring Fields

Boolean Expressions and Fielded Buffers

: Multiply Occurring Fields in VIEWS

Error Handling

3. Setup

Introduction

Directory Structure

Environment Variables

4. Field Definition and Use

Introduction

Defining Fields

Field Names and Identifiers

Field Table Files

Field Table Example

Mapping Functions

: Loading the Field Tables

Field Header Files

Mapping Fields to C Structures and COBOL Records

View Descriptions

: flag Options
: Null Values

viewc C Header Files

COBOL COPY Files

View Disassembler

5. Field Manipulation Functions

Introduction

FML/FML32 and VIEW/VIEW32

FML Parameters

Field Identifier Mapping Functions

Buffer Allocation and Initialization

Functions for Moving Fielded Buffers

Field Access and Modification Functions

Fvals and Fvall

Buffer Update Functions

VIEWS Functions

Conversion Functions

Converting Strings

Conversion Rules

Indexing Functions

Input/Output Functions

Fread and Fwrite

Fprint and Ffprint

Boolean Expressions of Fielded Buffers

Boolean Expressions

Field Names and Types

: Strings
: Constants
: Conversion
: Primary Expressions
: Expression Operators
: 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, Fvttos and Fcodeset

6. Examples

VIEWS Examples

Sample Viewfile

Sample Field Table

Sample Header File Produced by viewc

Sample Header File Produced by mkfldhdr(1)

Sample COBOL COPY File

Sample VIEWS Program

Example of VIEWS in bankapp

FML Examples in bankapp

A. FML Error Messages