Easysoft XML-ODBC Server User Guide - Preface

About this manual

This manual is intended to cover the full range of requirements for anyone wishing to install, use, or configure the Easysoft XML-ODBC Server.

Chapter Guide

Intended Audience

Sections written for the Microsoft Windows platforms require some familiarity with the use of buttons, menus, icons and text boxes, but should present no difficulties if you have any experience of Apple Macintosh computers, Microsoft Windows or the X Window System.

The Unix-based sections require experience of using a Unix shell and basic functions like editing a file. More complex activities are detailed more clearly, but it helps to understand how your system handles dynamic linking of shared objects.


Several technical documents are installed in addition to this manual, including a detailed list of Frequently Asked Questions (FAQ.txt). These are located in the Documentation subdirectory underneath the installation directory on both Windows and Unix. Please check all documentation thoroughly before contacting Easysoft with a query.

Displaying the Manual

This manual is available in the following formats:

Notational Conventions

Across the range of Easysoft manuals you will encounter passages that are emphasized with a box and a label.

A note box provides additional information that may further your understanding of a particular procedure or piece of information relating to a particular section of this manual:


Note boxes often highlight information that you may need to be aware of when using a particular feature.

A reference box refers to resources external to the manual, such as a useful website or suggested reading:


For more manuals that use this convention, see the rest of the Easysoft documentation.

A platform note provides platform-specific information for a particular procedure step:


In Linux you must log on as the root user in order to make many important changes.

A caution box is used to provide important information that you should check and understand, prior to starting a particular procedure or reading a particular section of this manual:


Be sure to pay attention to these paragraphs because Caution boxes are important!

Typographical Conventions

To avoid ambiguity, typographic effects have been applied to certain types of reference:

Click Next to continue.

Where there is a chain of submenus, the following convention is used:

Choose Start > Programs > Command Prompt.

At the command prompt type admin.

It is assumed that all typed commands will be committed by pressing the <Enter> key, and as such this will not normally be indicated in this manual. Other key presses are italicized and enclosed by angle brackets, for example:

Press <F1> for help.


An overview of ODBC and the Easysoft XML-ODBC Server.

A step-by-step guide to installing the Easysoft XML-ODBC Server software.

Describes how the Easysoft XML-ODBC Server runs as a service and the ways in which this connection can be configured and controlled.

Shows how to create an ODBC data source on the server machine to be accessed by the Easysoft XML-ODBC Server.

Includes useful information for use when creating client applications to connect to the Easysoft XML-ODBC Server.

Provides sample client application classes and objects for use with the Easysoft XML-ODBC Server.

Details configuration options for the Easysoft XML-ODBC Server.

Comprising Document Type Definitions, a Technical Reference and a Glossary.


Throughout this manual, Windows refers generically to Microsoft Windows 7, 8, 2012 R2, 10, 2016, 2019 or 2022, which are trademarks of the Microsoft Corporation. The X Window system is specifically excluded from this and is referred to as The X Window Systemor just X.

Note also that although the name UNIX is a registered trademark of The Open Group, the term has come to encompass a whole range of UNIX-like operating systems, including the free, public Linux and even the proprietary Solaris. Easysoft use Unix (note the case) as a general term covering the wide range of Open and proprietary operating systems commonly understood to be Unix `flavors'.

Easysoft and Easysoft Data Access are trademarks of Easysoft Limited.