Preface

This book describes how to install the DataDirect Connect^® for SQL/XML product by DataDirect Technologies from a CD-ROM and from files downloaded from the DataDirect Technologies Web site.

What Is DataDirect Connect for SQL/XML?

DataDirect Connect for SQL/XML is your solution for producing XML for data exchange. Developers need a way to build hierarchical XML structures using queries on a set of relational tables. Similarly, they need a way to update the content of their relational tables using data in XML hierarchies. Using Connect for SQL/XML, you can accomplish both of these tasks, and you can accomplish them by writing one Java application that works without change for any database DataDirect Technologies JDBC drivers support.

Connect for SQL/XML lets Java applications connect to databases using DataDirect Technologies JDBC drivers, return XML values in the columns of JDBC result sets, and access XML columns as JDOM, SAX, DOM, or text. For a more detailed explanation of Connect for SQL/XML, see the "Overview" chapter in the DataDirect Connect for SQL/XML User's Guide.

Using This Book

This book assumes that you are familiar with your operating system and its commands; the concept of directories; the management of user accounts and security access; and your network protocol and its configuration. You should also be familiar with Java, the JDBC API, SQL, and relational database programming.

This book explains how to install DataDirect Connect for SQL/XML on Windows and UNIX operating systems.

NOTE: This book refers the reader to Web URLs for more information about specific topics, including Web URLs not maintained by DataDirect Technologies. Because it is the nature of Web content to change frequently, DataDirect Technologies can guarantee only that the URLs referenced in this book were correct at the time of publishing.

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 file names, 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 italics`	Indicates names that are placeholders for values 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.
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.

About the Product Documentation

For detailed information about DataDirect SequeLink for JDBC, refer to the Connect for SQL/XML product documentation on the DataDirect Technologies web site:

DataDirect documentation is provided on your DataDirect CD in PDF format, which allows you to view it online or print it. You can view the online documentation using Adobe Acrobat Reader. The DataDirect CD includes Acrobat Reader 4.x with Search. DataDirect product documentation is also available on the DataDirect Technologies Web site:

During installation, the Connect for SQL/XML online books are placed in the /books directory in the Connect for SQL/XML installation directory. See the DataDirect Connect for SQL/XML Installation Guide for complete information about installing the online documents independently of the installer, as well as about viewing the documents.

HTML-based online help for the DataDirect Query Builder for SQL/XML is placed in the /help/builder directory in the Connect for SQL/XML installation directory. Open the online help for the Builder by selecting Help / Contents on the Builder's menu.

HTML-based online help for the Connect for JDBC drivers and the SequeLink JDBC driver is also placed on your system during installation. Online help for the Connect for JDBC drivers is installed in the /help/cjdbc directory in the Connect for SQL/XML installation directory. Online help for the SequeLink JDBC driver is installed in the /help/sljc directory in the Connect for SQL/XML installation directory. To access these help systems from a GUI environment, navigate to the appropriate help subdirectory and open the file:

To access these help systems from a command-line environment, at a command prompt, enter:

wher e browser_exe is the name of your browser executable and help_directory_path is the path to the appropriate help directory.

To use these help systems, you must have Internet Explorer 5.x or higher, or Netscape 4.x or higher installed. After you have opened the main screen of the help system in your browser, you can bookmark it in the browser for quick access later.

NOTE: Depending on your configuration, you may have to configure the Web browser as described in the DataDirect Connect for SQL/XML User's Guide before you can use the DataDirect Query Builder for SQL/XML help or the Web links in the Help menu of the Builder.

Contacting Technical Support

DataDirect Technologies provides technical support for registered users of this product, including limited installation support, for the first 30 days. Register online for your SupportLink user ID and password for access to the password-protected areas of the SupportLink web site at http://www.datadirect-technologies.com/support/support_index.asp. Your user ID and password are issued to you by email upon registration.

For post-installation support, contact us using one of the methods listed below or purchase further support by enrolling in the SupportLink program. For more information about SupportLink, contact your sales representative.

The DataDirect Technologies web site provides the latest support information through SupportLink Online, our global service network providing access to support contact details, tools, and valuable information. Our SupportLink users access information using the web and automatic email notification. SupportLink Online includes a knowledge base so you can search on keywords for technical bulletins and other information.


World Wide Web
http://www.datadirect-technologies.com/support/support_index.asp
E-Mail
USA, Canada, and Mexico	supportlink@datadirect-technologies.com
Europe, Middle East, and Africa	int.supportlink@datadirect-technologies.com
Japan	jpn.answerline@datadirect.co.jp
All other countries	http://www.datadirect-technologies.com/ contactus/distributor.asp provides a list of the correct e-mail contacts.

Local Telephone Support
Local phone numbers can be found at: http://www.datadirect.com/support/contactus/su-contact-phone/index.ssp SupportLink support is available 24 hours a day, seven days a week.
Fax Information
Fax US, Mexico, and Canada	1 919 461 4527
Fax EMEA	+32 (0) 15 32 09 19