Empress Software C/C++ Interface - mx Routines
Empress v8.62
May 2006

© 1983, 2006 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.

05/06

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