Linux Sup

ODBC Edition 4.
51
DataDirect ®
®
SequeLink ODBC Edition

Client
Installation Supplement
Red Hat Linux

© 1999 MERANT. All rights reserved. Printed in the U.S.A.
INTERSOLV, DataDirect, APS, Maintenance Workbench, PVCS, TechGnosis,

SequeLink, and Middleware are registered trademarks of MERANT. PVCS
SiteSync, INTERSOLV Messaging, DataDirect Connect ODBC, DataDirect
Connect OLE DB, DataDirect Reflector, WebDBLink, Client/Server MiddleWare,
PVCS VM Server, PVCS Dimensions, PVCS Process Manager, PVCS Version
Manager, PVCS Tracker, and PVCS TrackerLink are trademarks of MERANT.
Micro Focus is a registered trademark and Net Express is a trademark of
MERANT International Limited. Other company or product names mentioned
herein may be trademarks or registered trademarks of their respective
companies.
No part of this publication, with the exception of the software product user
documentation contained on a CD-ROM, may be copied, photocopied,
reproduced, transmitted, transcribed, or reduced to any electronic medium or
machine-readable form without prior written consent of MERANT.
Licensees may duplicate the software product user documentation contained

on a CD-ROM, but only to the extent necessary to support the users
authorized access to the software under the license agreement. Any
reproduction of the documentation, regardless of whether the
documentation is reproduced in whole or in part, must be accompanied by
this copyright statement in its entirety, without modification.
U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the Software

and the Documentation were developed at private expense, that no part is in
the public domain, and that the Software and Documentation are Commercial
Computer Software provided with RESTRICTED RIGHTS under Federal
Acquisition Regulations and agency supplements to them. Use, duplication or
disclosure by the U.S. Government is subject to restrictions as set forth in
subparagraph (c)(1)(ii) of The Rights in Technical Data and Computer Software
clause at DFAR 252.227-7013 et. seq. or subparagraphs (c)(1) and (2) of the
Commercial Computer Software Restricted Rights at FAR 52.227-19, as
applicable. Contractor is MERANT, 701 East Middlefield Road, Mountain View,
California 94043. Rights are reserved under copyright laws of the United
States with respect to unpublished portions of the Software.
MERANT
701 East Middlefield Road
Mountain View, California 94043
3
Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
What Is DataDirect SequeLink? . . . . . . . . . . . . . . . . . . . . . . . . 5
Using This Supplement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Other Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Conventions Used in This Supplement . . . . . . . . . . . . . . . . . . . 9
Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . 9
Mouse Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Keyboard Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . 11
1 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Read the READ.ME File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Test Your Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
MERANT Product Registration . . . . . . . . . . . . . . . . . . . . . . . . . 16
2 Installing SequeLink ODBC Edition Client . . . . . . . . 17

Installing On Red Hat Linux . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing On a Red Hat Linux Workstation
Without a CD-ROM Drive . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Installing On a Red Hat Linux Workstation
With a CD-ROM Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Setting Up the SequeLink Environment
for Your Users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

4
3 Using the SequeLink ODBC Driver . . . . . . . . . . . . . . 25

Configuring Data Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Connecting to a Data Source Using a Connection String . . . 26
Threading . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
Additional Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

5
Preface
This supplement is your guide to installing and using the

MERANT™ DataDirect® SequeLink® ODBC Edition™ Client in a
Red Hat Linux environment. Read on to find out more about
SequeLink and how to use this supplement.
What Is DataDirect SequeLink?

DataDirect SequeLink is a series of standards-based client/server
middleware products that allow clients to access databases on
multiple servers using existing operating systems and network
infrastructures.
The following SequeLink editions are available:
■ SequeLink ODBC Edition supports Open Database

Connectivity (ODBC) applications.
■ SequeLink OLE DB Edition supports OLE DB applications.
■ SequeLink Java Edition supports Java Database Connectivity

(JDBC) applications.

6 Preface
Using This Supplement

Audience and This supplement includes information which is specific to your
prerequisite operating system and was not included in the other installation
knowledge and reference guides. For additional information not specific to
your operating system, refer to the appropriate documentation.
This supplement assumes that you are familiar with your

operating system and its commands; the definition of directories;
the management of user accounts and security access; and your
network protocol and its configuration.
How this This supplement contains the following information:
supplement is
organized ■ Chapter 1, “Before You Begin” describes tasks you should
perform before you install SequeLink ODBC Edition Client in a
Red Hat Linux environment.
■ Chapter 2, “Installing SequeLink ODBC Edition Client”

provides installation instructions for SequeLink ODBC Edition
Client in a Red Hat Linux environment.
■ Chapter 3, “Using the SequeLink ODBC Driver” explains how

to use the SequeLink ODBC Driver to configure and connect
to data sources, threading, and other information specific to
the Red Hat Linux environment.

Other Documentation 7
Other Documentation
SequeLink ODBC Edition:
■ SequeLink ODBC Edition Client Installation Guide
■ SequeLink Server Installation Guide
■ SequeLink ODBC Driver Reference for Windows 3.1x
■ SequeLink ODBC Driver Reference for Windows 9x,
Windows NT, UNIX, and Macintosh
■ SequeLink Administrator’s Guide
■ SequeLink Error Codes and Messages Reference
SequeLink OLE DB Edition:

■ SequeLink OLE DB Edition Client Installation Guide
■ SequeLink OLE DB Provider Reference
Note: Getting Started with DataDirect for OLE DB is also

available.
SequeLink Java Edition:

■ SequeLink Java Edition Client Installation Guide
■ SequeLink JDBC Driver Reference

8 Preface
The following table provides a guide for finding the information

you need about SequeLink.
For information about… Go to…

Installing SequeLink Server SequeLink Server Installation Guide
Installing SequeLink Clients SequeLink Red Hat Linux Installation Supplement

SequeLink ODBC Edition Client Installation Guide
SequeLink OLE DB Edition Client Installation Guide
SequeLink Java Edition Client Installation Guide
Installing the SequeLink Online Instructions are available on the DataDirect CD

Documents Insert and on the Web site.
Planning, configuring, and SequeLink Administrator’s Guide

administering your system and
network for SequeLink; creating
and managing data sources; using
SequeLink with your database
Troubleshooting problems and SequeLink Error Codes and Messages Reference

referencing error codes
Using the SequeLink ODBC Drivers SequeLink ODBC Driver Reference for Windows 3.1x
SequeLink ODBC Driver Reference for Windows 9x,
Windows NT, UNIX, and Macintosh
Using the SequeLink OLE DB SequeLink OLE DB Provider Reference

Provider Getting Started with DataDirect for OLE DB
Using the SequeLink JDBC Driver SequeLink JDBC Driver Reference

Conventions Used in This Supplement 9
Conventions Used in This Supplement

The following sections describe the typography, terminology,
and other conventions used in this supplement.
Typographical Conventions
This supplement uses the following typographical conventions:
Convention Explanation
italics Introduces new terms with which you may not be
familiar, and is used occasionally for emphasis.
bold Emphasizes important information. Also indicates
button, menu, and icon names on which you can
act. For example, click Next.
UPPERCASE Indicates the name of a file. For operating
environments that use case-sensitive filenames, the
correct capitalization is used in information specific
to those environments.
Also indicates keys or key combinations that you
can use. For example, press the ENTER key.
monospace Indicates syntax examples, values that you specify,
or results that you receive.
monospaced Indicates names that are placeholders for values
italics that you specify. For example, filename.
forward slash / Separates menus and their associated commands.
For example, Select File / Copy means that you
should select Copy from the File menu.
The slash also separates directory levels when
specifying locations under UNIX.
vertical rule | Indicates an “OR” separator used to delineate
items.

10 Preface
Convention Explanation
brackets [ ] Indicates optional items. For example, in the
following statement: SELECT [DISTINCT], DISTINCT
is an optional keyword.
Also indicates sections of the Windows Registry.
braces { } Indicates that you must select one item. For
example, {yes | no} means that you must specify
either yes or no.
ellipsis . . . Indicates that the immediately preceding item can
be repeated any number of times in succession. An
ellipsis following a closing bracket indicates that all
information in that unit can be repeated.
Mouse Conventions
This action… Means to…
Click Point to an object with the mouse pointer and
momentarily press the left mouse button.
Double-click Press the left mouse button twice.
Right-click Momentarily press the right mouse button.
Drag Press and hold the left mouse button while
dragging item(s) to another part of the screen.
SHIFT+Click Click an object to select it; then, press and hold
the SHIFT key. Click another object to select the
intervening series of objects.
CTRL+Click Press and hold the CTRL key; then, click a
selection. This lets you select or deselect any
combination of objects.
Keyboard Conventions
Select menu items by using the mouse or pressing ALT+ the key
letter of the menu name or item.

Contacting Technical Support 11
Contacting Technical Support

MERANT provides technical support for all registered users of
SequeLink, including limited installation support, for the first 30
days. For support after that time, contact us using one of the
following methods or purchase further support by enrolling in
the SupportNet program. For more information about
SupportNet, contact your sales representative.
World Wide http://www.merant.com/datadirect/support

Web
The MERANT Web site provides the latest support information
through SupportNet Online, our global service network that
provides access to valuable tools and information. Our
SupportNet users access information using the Web, automatic
email notification, newsgroups, and regional user groups.
SupportNet Online includes a knowledge base that allows you to
search on keywords for technical bulletins and other
information. You also can download product fixes for your
DataDirect products.
Internet
Australia and New australia.answerline@merant.com

Zealand
EMEA int.datadirect.answerline@merant.com
Japan jpn.answerline@merant.co.jp
USA and Canada datadirect.answerline@merant.com
Telephone
Australia 1 800 335 664 or 8:30-5:30 p.m. Local Melbourne Time (LMT)
9816 9977 for
Melbourne Metro
Belgium 0800 724 61 9:00-6:30 p.m. CET
France 0800 91 56 07 9:00-6:30 p.m. CET

12 Preface
Germany 0130 822 496 or 9:00-6:30 p.m. CET

+44 1727 812898
Japan 81-3-5401-9660 9:00-12:00, 1:00-5:00 p.m. JST
The Netherlands 0800 022 1609 9:00-6:30 p.m. CET
New Zealand 1 800 335 664 8:30-5:30 p.m. LMT
United Kingdom +44 1727 811881 8:00-5:30 p.m. GMT
and Ireland
USA and Canada 1 800 443 1601 8:30-8:00 p.m. EST
Fax and Mail

Information
Fax US 1 919 461 4527

Fax International +32-15-320919
Mail 1500 Perimeter Park Drive, Suite 100, Morrisville, NC 27560 USA
When you contact us, make sure that you can provide the
following information:
■ The product serial number located on the Product

Registration Information card or on a product serial number
card in your package. The number will be checked to verify
your support eligibility. If you do not have a SupportNet
contract, we will ask you to speak with a sales representative.
■ Your name and organization. For a first-time call, you may be

asked for full customer information, including location and
contact details.
■ The version number of your DataDirect product.
■ The type and version of your operating system.
■ Any third-party software or other environment information

required to understand the problem.
■ A brief description of the problem, including any error

messages that you have received, and the steps preceding the
occurrence of the problem. Depending on the complexity of

Contacting Technical Support 13
the problem, you may be asked to submit an example so that

we can recreate the problem.
■ An assessment of the severity level of the problem.

14 Preface

15
1 Before You Begin
This chapter describes the tasks you should perform before you
install SequeLink ODBC Edition Client in a Red Hat Linux
environment.
Read the READ.ME File

Before you install SequeLink ODBC Edition Client, read the
SequeLink READ.ME text file on your CD, or other distribution
media, in the directory sequelnk.
Note: The READ.ME file is also available from the Web.
Test Your Network

Before you install SequeLink ODBC Edition Client, you should
make sure that your communications network is installed and
running. For example, if you are using TCP/IP, you can test your
network by using the ping command. For more information
about testing your network, refer to your network product
documentation.
For SequeLink network requirements refer to “System

Requirements” in the SequeLink ODBC Edition Client Installation
Guide.

16 Chapter 1 Before You Begin
MERANT Product Registration

During installation, you will be prompted for your Serial Number
and Key to register the product. You can find the Serial Number
and Key printed on the Product Registration Information card
that is shipped with the product.
If you want to access software for which you do not have a

license, contact MERANT.

17
2 Installing SequeLink ODBC

Edition Client
This chapter provides installation instructions for SequeLink

ODBC Edition Client in a Red Hat Linux environment.
Installing On Red Hat Linux

To install from a CD, see one of the following sections:
■ “Installing On a Red Hat Linux Workstation Without a

CD-ROM Drive” on this page
■ “Installing On a Red Hat Linux Workstation With a CD-ROM

Drive” on page 21
Note: CDs do not need to be mounted on a Red Hat Linux

workstation. This process is done automatically.
Installing On a Red Hat Linux

Workstation Without a CD-ROM Drive
Installing SequeLink ODBC Edition Client on a Red Hat Linux
workstation without a CD-ROM drive involves the following
steps:
■ Transferring files to your Red Hat Linux workstation

■ Extracting the files
■ Running the installation script
■ Setting up the SequeLink environment for your users

18 Chapter 2 Installing SequeLink ODBC Edition Client
If your workstation does not have a CD-ROM drive, you must

mount the CD on another computer with a CD-ROM drive and
transfer the tar file in binary format to your Red Hat Linux
workstation using file transfer software (for example, FTP). After
the tar file is transferred to your Red Hat Linux workstation,
extract the files from the tar file and run the installation script.
Transferring Files to Your Red Hat Linux

Workstation
1 Mount the DataDirect CD on a computer with a CD-ROM
drive and file transfer capability. For mounting instructions
on a variety of platforms other than Red Hat Linux, refer to
“Mounting your MERANT DataDirect CD” in the SequeLink
ODBC Edition Client Installation Guide.
2 Log on the Red Hat Linux workstation where you want to

install the SequeLink ODBC Edition Client software.
3 Create a temporary directory on the Red Hat Linux

workstation. This directory is used to run the installation
script and can be deleted after installation. For example,
enter:
mkdir /tmp/sqlnk
4 On the system from which you are transferring the files,
change to the directory on the DataDirect CD that applies to
the Red Hat Linux system and client:
sequelnk/linux/client
5 From this system, initiate the file transfer of the file called
slclient.tar in binary format. Transfer the file to the
temporary directory you created in Step 3.
How you transfer files from another system to your Red Hat
Linux workstation depends on your TCP/IP product and your
system’s operating system. For more information about

Installing On Red Hat Linux 19
transferring files, refer to the documentation supplied with

your TCP/IP product.
Important: Transfer the files in binary format. If you transfer

files in the wrong format, the installation will fail.
Extracting SequeLink ODBC Edition Client Files

On your Red Hat Linux workstation, access the tar file you
transferred to the temporary directory and extract it:
tar -xvf slclient.tar
Running the Installation Script

When you run the installation script, it prompts you for choices
you need to make and information you need to supply. Default
answers to questions are enclosed within square brackets [ ]. To
accept the default, press the ENTER key.
1 On your Red Hat Linux workstation, change to the temporary

directory to which you extracted the SequeLink ODBC Edition
Client files. For example, enter:
cd /tmp/sqlnk
2 Type the following command:
./unixpi.ksh
The software detects the operating system in use:
The following operating system has been

detected:
Linux
Is this the correct operating system on your
machine (Y/N) ? [Y]

3 Press ENTER to continue the installation.
The Product Selection menu appears:
------------------------------------------------
1. SequeLink ODBC Driver on Linux
2. Quit Product Setup
------------------------------------------------
Select one of the options above.
------------------------------------------------
Enter your selection: [1]
4 Press ENTER to continue the installation. The Product
Registration Fields appear.
5 Enter your Name, Company Name, Serial Number, and IPE Key
to register your SequeLink ODBC Edition Client software. You
can find them on the Product Registration Information card
A MERANT Product License Agreement screen appears. The

text on this screen points you to a printed version of the
software license agreement.
6 Type YES to accept the agreement and continue the

installation. The target directory command prompt appears.
7 Enter the fully qualified path of the target directory for the
SequeLink ODBC Edition Client software. If this directory does
not exist, it is created for you.
If the Product Setup detects a previously installed version of

SequeLink ODBC Edition Client in the directory you specified,
it asks you whether you want to make a backup of your
existing installation.

8 (Optional) Type Y to create a backup of your existing

installation. The backup is created in the backup
subdirectory of your SequeLink directory in a file with the
format slclientmmddyy.tar, where mmddyy is the date the
file was created.
9 SequeLink ODBC Edition Client is installed. A message

appears, informing you when the installation is complete.
Set up the SequeLink environment for your users. For

instructions, see “Setting Up the SequeLink Environment for
Your Users” on page 23.
Installing On a Red Hat Linux

Workstation With a CD-ROM Drive
If your Red Hat Linux workstation has a CD-ROM drive, you can
use the MERANT Product Setup to install SequeLink ODBC
Edition Client and other MERANT products on your DataDirect
CD. The Product Setup prompts you for information you need to
supply during installation and provides default values for this
information. Default answers to questions are enclosed within
brackets [ ]. To accept the default, press the ENTER key.
To install SequeLink ODBC Edition Client:
1 Insert the DataDirect CD into your Red Hat Linux

workstation. It is mounted automatically.
2 Change to the top-level directory on the CD.
3 Type the following command:
./unixpi.ksh

The software detects the operating system in use:
The following operating system has been

detected:
Linux
Is this the correct operating system on your
machine (Y/N) ? [Y]
4 Press ENTER to continue the installation.
The Product Selection menu appears:
------------------------------------------------
1. SequeLink ODBC Driver on Linux
2. Quit Product Setup
------------------------------------------------
Select one of the options above.
------------------------------------------------
Enter your selection: [1]
5 Press ENTER to continue the installation. The Product
Registration Fields appear.
6 Enter your Name, Company Name, Serial Number, and IPE Key
to register your SequeLink ODBC Edition Client software. You
can find them on the Product Registration Information card
A MERANT Product License Agreement screen appears. The

text on this screen points you to a printed version of the
software license agreement.
7 Type YES to accept the agreement and continue the

installation. The target directory command prompt appears.
8 Enter the fully qualified path of the target directory for the
SequeLink ODBC Edition Client software. If this directory does
not exist, it is created for you.
If the Product Setup detects a previously installed version of

SequeLink ODBC Edition Client in the directory you specified,
it asks you whether you want to make a backup of your
existing installation.

9 (Optional) Type Y to create a backup of your existing

installation. The backup is created in the backup
subdirectory of your SequeLink directory in a file with the
format slclientmmddyy.tar, where mmddyy is the date the
file was created.
10 SequeLink ODBC Edition Client is installed. A message

appears, informing you when the installation is complete.
Set up the SequeLink environment for your users. For

instructions, see “Setting Up the SequeLink Environment for
Your Users” on page 23.
Setting Up the SequeLink Environment

for Your Users
For each SequeLink user, set up a SequeLink environment by
running the appropriate shell script in the SequeLink directory:
■ If using the Korn or Bourne shell, enter:
. .sqlnk.sh
This script can also be obtained from the user’s .profile script.
■ If using the C shell, enter:
source .sqlnk.csh
This script can also be obtained from the user’s .login script.
To establish a connection, refer to “Establishing a Connection” in

the SequeLink ODBC Edition Client Installation Guide.


25
3 Using the SequeLink ODBC

Driver
This chapter explains how to use the SequeLink ODBC Driver to

configure and connect to data sources, and how to correctly
thread the SequeLink ODBC Driver in a Red Hat Linux
environment.
Additional information about using the SequeLink ODBC Driver

on UNIX platforms is provided in the SequeLink ODBC Driver
Reference.
Configuring Data Sources

To use the SequeLink ODBC Driver, there are two types of data
sources to configure:
■ ODBC data source. This is the data source you specify from
within your application when you connect to a database.
To configure an ODBC data source, edit the .odbc.ini file with

a text editor. Table 3-1, “ODBC Attributes” on page 27
describes the attributes and values that you can set for a data
source. For more information about the .odbc.ini file, see
Appendix B, “odbc.ini for UNIX” in the SequeLink ODBC
Driver Reference.
■ SequeLink data source. This is the data source your ODBC

data source uses to connect to the database through the
SequeLink ODBC Driver. You specify this data source when
you configure an ODBC data source. If the SequeLink data
source does not already exist, you can create it. You can also
SequeLink ODBC Edition Red Hat Linux Installation Supplement

26 Chapter 3 Using the SequeLink ODBC Driver
modify one that exists. You use the SequeLink Connect

Administration Tool (CAT).
To configure a SequeLink data source, use the command line

version of the SequeLink CAT. For more information about
SequeLink data sources or the CAT, refer to the SequeLink
Administrator’s Guide.
Connecting to a Data Source Using a

Connection String
If your application requires a connection string to connect to a
data source, you must specify the data source name that tells the
driver which data source to use for the default connection
information. Optionally, you may specify attribute=value pairs in
the connection string to override the default values stored in the
data source.
You can specify long or short names in the connection string,

which has the form:
DSN=data_source_name[;attribute=value[;attribute=value]...]
For example, a connection string for SequeLink may look like this:
DSN=Accounting;DB=EMP;UID=JOHN;PWD=XYZZY
Table 3-1 on page 27 lists the long and short names and provides
a description of each attribute. The defaults listed in Table 3-1 are
initial defaults that apply when no value is specified in the
connection string or in the data source definition. If you specified
a value for the attribute when configuring the data source, that
value is your default. In Table 3-1, short names are shown
enclosed within parentheses ( ).

Connecting to a Data Source Using a Connection String 27
To configure a data source in UNIX, you must edit the .odbc.ini

file, using the attributes in Table 3-1. This file accepts only long
names for attributes.
Table 3-1. ODBC Attributes
Attribute Description
DataSourceName (DSN) A string that identifies an ODBC data source configuration.
Examples include “Accounting” or “SequeLink to Informix
Data.”
LogonID (UID) The host or database user name, depending on the setting of
UID/PWD Mapping.
Password (PWD) The host or database password, depending on the setting of
UID/PWD Mapping.
SqlnkDSN (SDSN) A SequeLink data source name. See “Hierarchy of Connection
Attributes” in the SequeLink ODBC Driver Reference for
more information about how the SequeLink ODBC Driver
interacts with SequeLink data sources.
Database (DB) The name of the database to which you want to connect.
UidPwdMapping (UPM) UidPwdMapping={0|1}. This attribute determines whether
the UID and PWD are mapped to the host machine account
or database account. Specify 0 (the default) to map the user
name (UID) and the password (PWD) to the host machine
user account. If your database requires user authentication,
you must specify the Database User Name and the Database
Password in the SequeLink CAT settings. Specify 1 to map the
user name and password to the database account. If your
SequeLink Server service is configured for host
authentication, you must specify the Host User Name and
Host Password in the SequeLink CAT settings.
PreFetchRows (PFR) The number of rows the driver will attempt to retrieve when
fetching from the server. Fetching multiple rows can improve
performance by reducing the number of network roundtrips.
The default is 30.
EnableScrollableCursors EnableScrollableCursors={0|1}. Enables scrollable cursors for
(ESC) this data source. Static cursors are supported for all
databases. In addition, keyset-driven cursors are supported
for Oracle and INFORMIX databases. Specify 1 to enable
scrollable cursors. The default is 0.

Table 3-1. ODBC Attributes (cont.)
AllowBatchStatements(ABS) AllowBatchStatements={0|1}. This attribute determines
whether the SequeLink data source should accept batch SQL
statements. When set to 0 (the default), the SequeLink data
source does not accept batch SQL statements. Semicolons are
considered part of a single SQL statement. Specify 1 to tell
the SequeLink data source accept batch SQL statements.
EnableWarnings (EW) EnableWarnings={0|1}. This attribute determines whether
SequeLink returns warnings from the database. When set to
0 (the default), SequeLink does not return warnings
generated by the DBMS. Specify 1 to return warnings.
DataDictionary (DD) DataDictionary={(Default)|DBMS|SQLNK|HYBRID}. This
attribute determines the type of data dictionary to be used.
Specify:
■ (Default) to use the default setting of SequeLink
Server
■ DBMS to return all data dictionary information from the

database’s native data dictionary
■ SQLNK to extract all data dictionary information from the

SSDD
■ HYBRID to use data dictionary information from the

database’s native data dictionary and the SSDD
DataDictionaryCatalog The catalog (qualifier) name of the SSDD that will be used
(DDC) when DataDictionary={SQLNK|HYBRID}.
DataDictionarySchema The schema (owner) name of the SSDD that will be used
(DDS) when DataDictionary={SQLNK|HYBRID}.

Connecting to a Data Source Using a Connection String 29
NewPassword (NPWD) This attribute applies to connections to DB2 and Oracle on
OS/390 and is ignored otherwise. When a password is expired
and NewPassword is not specified (the default), the driver
will perform one of the following actions:
■ If the DriverCompletion parameter of the
SQLDriverConnect call is a value other than
SQL_DRIVER_NOPROMPT, the driver will prompt for a new
password.

SQLDriverConnect call is SQL_DRIVER_NOPROMPT, the
driver will return the password-expired error to the
application.
If a password is expired and NewPassword is specified, the
driver will attempt to change the password with the
attribute value without further prompting. If this password
change operation fails, the driver will perform one of the
following actions:
SQLDriverConnect call is a value other than
SQL_DRIVER_NOPROMPT, the driver will prompt for a new
password.

SQLDriverConnect call is SQL_DRIVER_NOPROMPT, the
driver will return the password change error to the
application.

ForcePasswordChange This attribute applies to connections to DB2 and Oracle on
(FPWDC) OS/390 and is ignored otherwise. It allows you to change the
password on the host before logging on. The value of the
new password is taken from the NewPassword (NPWD)
connect option:
■ The default value is 0, which means no forced password
change.
■ If the value is 1, the driver will attempt to change the

password on the host before logging on.
ApplicationID (APPID) Identifies an ODBC application to the SequeLink Server and
should only be used when the SequeLink Server is configured
to restrict access to specific applications. For more
information about using application IDs to restrict access to
applications, refer to the SequeLink Administrator’s Guide.
TransactionIsolationLevel TransactionIsolationLevel={1|2|4|8}. This attribute specifies
(TIL) the initial transaction isolation level when the connection is
established for those applications that do not allow the
transaction isolation level to be changed from within the
application (Microsoft Access, for example). Specify:
■ 1 (SQL_TXN_READ_UNCOMMITTED). Dirty reads,
nonrepeatable reads, and phantoms are allowed.
■ 2 (SQL_TXN_READ_COMMITTED). Dirty reads are not

allowed; nonrepeatable reads and phantoms are allowed.
■ 4 (SQL_TXN_REPEATABLE_READ). Dirty reads and

nonrepeatable reads are not allowed; phantoms are
allowed.
■ 8 (SQL_TXN_SERIALIZABLE). Transactions are serializable;

Dirty reads, nonrepeatable reads, and phantoms are not
allowed.
For more information about transaction isolation levels, refer
to Microsoft’s ODBC 3.0 Programmer’s Reference.

Threading 31
Threading
The ODBC specification requires that all ODBC drivers must be
thread-safe; that is, they must not fail when database requests
are made on separate threads.
An ODBC driver can be based on one of the following

architectures:
■ Not thread-safe. The ODBC driver should not be used in a

multi-threaded environment.
■ Thread-impaired. The ODBC driver serializes all ODBC calls.

All requests are handled one by one, without concurrent
processing.
■ Thread per connection. The ODBC driver processes requests

concurrently with statement handles that do not share the
same connection handle; however requests on the same
connection are serialized.
■ Fully threaded. All requests fully use the threaded model.

The ODBC driver processes all requests on multiple
statements concurrently.
The multi-threading capabilities of the SequeLink ODBC Driver

are platform dependent, as shown in Table 3-2.
Table 3-2. Multi-threading Capabilities of the SequeLink ODBC

Driver
Platform Capability
Red Hat Linux Thread per connection
Windows 9x and Windows NT Thread per connection
AIX reentrant Thread per connection
AIX non-reentrant Not thread-safe
HP-UX 10 aCC Thread per connection using
the DCE threading model

Table 3-2. Multi-threading Capabilities of the SequeLink ODBC

Driver (cont.)
Platform Capability
HP-UX 11 aCC Thread per connection using
the HP-UX native threading
model (p-threads)
HP-UX cFront Not thread-safe
Solaris Thread per connection
Macintosh Not thread-safe
Additional Information
For additional information on the following topics, refer to the
SequeLink ODBC Driver Reference:
■ Data types
■ Isolation and lock levels supported
■ ODBC conformance levels
■ Connection and statements supported
■ Hierarchy of connection attributes
■ Using SequeLink Shadow Data Dictionaries
■ Error messages
This information applies to all UNIX platforms including the Red

Hat Linux environment.

Linux Sup

Uploaded by

Document Information

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Linux Sup

Uploaded by

Copyright:

Available Formats

ODBC Edition 4.

SequeLink ODBC Edition

Red Hat Linux

INTERSOLV, DataDirect, APS, Maintenance Workbench, PVCS, TechGnosis,

Licensees may duplicate the software product user documentation contained

U.S. GOVERNMENT RESTRICTED RIGHTS. It is acknowledged that the Software

Contacting Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . 11

1 Before You Begin . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

2 Installing SequeLink ODBC Edition Client . . . . . . . . 17

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

3 Using the SequeLink ODBC Driver . . . . . . . . . . . . . . 25

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

This supplement is your guide to installing and using the

What Is DataDirect SequeLink?

The following SequeLink editions are available:

■ SequeLink ODBC Edition supports Open Database

■ SequeLink OLE DB Edition supports OLE DB applications.

■ SequeLink Java Edition supports Java Database Connectivity

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

Using This Supplement

This supplement assumes that you are familiar with your

■ Chapter 2, “Installing SequeLink ODBC Edition Client”

■ Chapter 3, “Using the SequeLink ODBC Driver” explains how

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

SequeLink OLE DB Edition:

Note: Getting Started with DataDirect for OLE DB is also

SequeLink Java Edition:

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

The following table provides a guide for finding the information

For information about… Go to…

Installing SequeLink Clients SequeLink Red Hat Linux Installation Supplement

Installing the SequeLink Online Instructions are available on the DataDirect CD

Planning, configuring, and SequeLink Administrator’s Guide

Troubleshooting problems and SequeLink Error Codes and Messages Reference

Using the SequeLink OLE DB SequeLink OLE DB Provider Reference

Using the SequeLink JDBC Driver SequeLink JDBC Driver Reference

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

Conventions Used in This Supplement

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

Contacting Technical Support

World Wide http://www.merant.com/datadirect/support

Australia and New australia.answerline@merant.com

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

Germany 0130 822 496 or 9:00-6:30 p.m. CET

Fax and Mail

Fax US 1 919 461 4527

■ The product serial number located on the Product

■ Your name and organization. For a first-time call, you may be

■ The version number of your DataDirect product.

■ The type and version of your operating system.

■ Any third-party software or other environment information

■ A brief description of the problem, including any error

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

the problem, you may be asked to submit an example so that

■ An assessment of the severity level of the problem.

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement

1 Before You Begin

Read the READ.ME File

Note: The READ.ME file is also available from the Web.

Test Your Network

For SequeLink network requirements refer to “System

SequeLink ODBC Edition Client Red Hat Linux Installation Supplement