Home

Getting Started

Utilities

Indexing

Omnidex

Development

Tutorials

Quick Links

 

Utilities

DSEDIT

Data Source Objects

UNIX & Linux Clients

 

DSEDIT

Create a Data Source

Edit a Data Source

Test a Connection

Check the Server

Data Source Type

Data Source Name

Environment Info

Server / Host

ODBC Options

Sample Data Source

 

DSEDIT

DSEDIT, Data Source Editor, is a Windows utility that creates and modifies Omnidex data source objects. Data source objects are used along with Omnidex Network Services to connect to an Omnidex Environment Catalog on the server (local or remote), in client/server ODBC, JDBC and Client OmniAccess API (CLOA) applications.

Using information contained in the data source, DSEDIT can also be used to test network connections, show structural information about the database and index installation, and perform simple retrievals against the database.

 

Data Source Objects

Data source objects are a collection of configuration information that defines server and connection protocol information necessary to allow a client application to talk to a remote server. This includes the host (server) name or IP address, OdxNet listener port number, physical file location of the Omnidex Environment Catalog, and other pertinent information. This information is used by the Omnidex ODBC and JDBC drivers, as well as the Omnidex Client OmniAccess API.

Some server only applications can connect directly to the Omnidex Environment Catalog and will therefore not pass through an Omnidex Network Server nor require a Data Source object. However, the Omnidex ODBC and JDBC drivers are both client components of the Omnidex software, and therefore will always pass through an Omnidex Network Server, regardless of the network configuration. This means that single tier applications using ODBC or JDBC, where the application and database reside on the same machine, will go through an Omnidex Data Source object and an Omnidex Network Server.

 

UNIX and Linux Clients

A data source object is also required in client / server applications when the client platform is not Windows. Although, DSEDIT is a Windows only utility, meaning it will only run on the Windows operating system, it can still be used to create data sources for use on the other supported platforms.

Simply use the wizard to create a Generic or CLOA data source, passing the appropriate server information, and save the data source to the local machine. Since the data source is an ASCII text file, it can be easily copied to another platform.

If your client application will be using ODBC to access the data, you will need to make one minor edit inside the data source file. To do this, open the data source file with any text editor and look for the ODBCDSNFILE=datasourcefilespec near the top. It should be around the third line.

This tag shows the physical file location of the data source as it was originally created on the Windows machine. You simply need to change the path to show where you moved the data source file to. Save your changes and exit.

That is all there is to it. The data source file is now ready for use on the new client machine.

Top