Table of Contents Introduction to FML Programming What Is FML? How Does FML Fit into the Oracle Tuxedo System? Oracle 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 RECORD Features RECORD Features RECORD Description File Setting up Your Environment for RECORD 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 RECORD Functions Introduction to RECORD Functions Synopsis Description RECORD buffers Error Handling Rinit() Return Values Rget() Errors Rset() Errors Frneeded() Return Values Errors Fvftor32() Errors Fvrtof32() Errors Fvrtos32() Errors Fvstor32() Errors Data Type and Conversion 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 RECORD Examples RECORD Example: COBOL Copybook File RECORD Example: RECORD Programs See Also FML Error Messages
Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.