| C/C++ Interface - mx Routines Empress v8.62 January 2003
--- | ---

  © 1983, 2003 Empress Software Inc.

  All rights reserved. Reproduction of this document in whole or part, by electronic or any other means, is prohibited without written consent from Empress Software Inc.

  RESTRICTED RIGHTS LEGEND

  Use, duplication, or disclosure by the Government is subject to restrictions as set forth in
  subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at 52.227-7013.

  01/03

  Part #: 001-03-B2-110

  This manual provides a reference section for all the mx routines. Examples are included in addition to the standard syntax and synopsis description so this manual can be used as a simple tutorial as well as a reference guide for mx routines.

  ## Table of Contents

  ### CHAPTER 1: Introduction

  | 1.1 | Overview
  | 1.2 | C Language Version Supported
  | 1.3 | Database Used for the Examples
  | 1.4 | References

  ### CHAPTER 2: The mx Routines

  | 2.1 | Introduction
  | 2.2 | Accessing the mx Routines

  |  | 2.2.1 | The Header File mscc.h
  |  | 2.2.2 | Initialization and Cleanup
  |  | 2.2.3 | Compiling and Linking

  | 2.3 | Internal, External, and File Attribute Formats
  | 2.4 | Handling Normal Failures: mxerret and mxoperr
  | 2.5 | Empress File Quotas
  | 2.6 | Naming Conventions
  | 2.7 | Empress Internal Procedure Names
  | 2.8 | General Overview of the mx Routines
  | 2.9 | Database, Table, and Attribute Names
  | 2.10 | Error Messages
  | 2.11 | Locking
  | 2.12 | Portability

  ### CHAPTER 3: Example Programs

  | 3.1 | Introduction
  | 3.2 | Opening and Closing Tables
  | 3.3 | Checking for an Attribute
  | 3.4 | Entering Attribute Values into Records
  | 3.5 | Adding Records to a Table
  | 3.6 | Retrieving Records

  |  | 3.6.1 | Record Retrieval Routines
  |  | 3.6.2 | Retrieving Attribute Values
  |  | 3.6.3 | Nesting Retrieval Loops

  | 3.7 | Qualification Building

  |  | 3.7.1 | Conjunctions of Qualifications
  |  | 3.7.2 | Comparing with a Constant
  |  | 3.7.3 | Selecting a Range of Values
  |  | 3.7.4 | Comparing Attributes
  |  | 3.7.5 | Match Operators
  |  | 3.7.6 | Comparing with NULL

  | 3.8 | Deleting Records
  | 3.9 | Updating Records
  | 3.10 | Using Internal Data Representations
  | 3.11 | Transactions

  ### CHAPTER 4: Manual Pages