home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The World of Computer Software
/
World_Of_Computer_Software-02-385-Vol-1of3.iso
/
s
/
sqlwrq.zip
/
SQLWRQ.DOC
< prev
next >
Wrap
Text File
|
1992-12-30
|
6KB
|
156 lines
Filename: SQLWRQ.DOC
Product: WXQLCALL.DLL v3.0a
Date: December 1992
===========================================================================
Contents
========
General Information
Critical Information
Developing Your Application
Developing Your Application with C
Developing Your Application with Other Languages
Installing and Using WXQLCALL.DLL v3.0 with XQL v2.11
Installation Notes
===========================================================================
General Information
===================
This document describes how to install and use the NetWare SQL v3.0
Requester for Windows (WXQLCALL.DLL) with XQL v2.11. The
NetWare SQL Requester for Windows is an interface that uses the DOS
Protected Mode Interface (DPMI) that Windows provides to access XQL,
which runs in real mode.
===========================================================================
Critical Information
====================
Although you should read this entire file, pay special attention to
this section. It contains information critical to your success in
using WXQLCALL.DLL.
You can use XQL v2.x to develop and run applications using
WXQLCALL.DLL v3.0a. If you want to run these applications in a
NetWare environment, you must upgrade or purchase NetWare SQL v3.0.
(You can also use NetWare SQL v3.0 to develop applications using
WXQLCALL.DLL v3.0a)
===========================================================================
Developing Your Application
===========================
This section discusses information pertinent to languages you may use
to develop XQL applications.
Developing Your Application with C
----------------------------------
The header file NWSQLAPI.H contains the prototype definitions for the
XQL APIs (application programming interface); therefore, you should
include this header file in your application source files to ensure
that the correct calling sequence exists for interfacing with the
XQL APIs. NWSQLAPI.H includes the header file NWSQLINT.H, which
contains environment configuration parameters.
In NWSQLINT.H, set the operating system environment to Windows in
section 1, "OS Environment," and define which C compiler you
are using in section 2, "C Compiler." In NetWare SQL v3.0, the levels
of API support have new names. The SQL-level functions correspond to
XQLM, and the relational primitives correspond to XQLP. By default,
both API levels are defined in section 3, "API Level Support."
After compiling your Windows application, link it with the import
library WXQLCALL.LIB.
NOTE: xRecall, xField, and xCompute give incorrect results when
you execute them using XQL.EXE v2.11a.
Developing Your Application with Other Languages
------------------------------------------------
The NWSQLAPI.H file provides the information you need to determine
how to call the various functions in WXQLCALL.DLL. Consult the
language reference for your compiler for more information on calling
Dynamic Link Library (DLL) functions.
===========================================================================
Installing and Using WXQLCALL.DLL v3.0a with XQL v2.11
=====================================================
Before using WXQLCALL.DLL with XQL, apply optional patch #38 to XQL.EXE,
XQLO.EXE, XQLP.EXE, or XQLPO.EXE (whichever one you are running).
Initialize WXQLCALL.DLL in the [NSREQDPMI] section of the NOVDB.INI file.
The default parameters for this section are as follows:
[NSREQDPMI]
datalength=4096 ; same as the /W: option used for XQL
views=8 ; same as the /V: option used for XQL
tasks=2 ; maximum tasks that can use WXQLCALL.DLL concurrently
The value for the datalength option must equal or exceed the size of
the largest record being accessed.
Load Btrieve and XQL before starting Windows, or place the commands to
load Btrieve and XQL in the WINSTART.BAT file. (You can use the latter
method only if you are using Windows in enhanced mode.) Windows must be
able to locate WXQLCALL.DLL.
NOTE: If you do not load Btrieve and XQL in WINSTART.BAT, you must load
them before loading Windows. Otherwise, your application
receives Status Code 2112.
To unload WXQLCALL.DLL, an XQL application running in Windows must
call xStop or XQLStop before terminating.
If you loaded Btrieve and XQL before starting Windows, make sure all
Windows tasks have exited, and then unload Windows before unloading XQL
and Btrieve. Unload XQL by issuing the XQLUTIL -STOP command from
the DOS prompt. Unload Btrieve by issuing the BUTIL -STOP command from
the DOS prompt.
If you loaded Btrieve and XQL using the WINSTART.BAT file, Windows
unloads them when you exit the Windows environment.
===========================================================================
Installation Notes
==================
You can find the following files on NetWire or on the diskette you
received:
NWSQLINT H 4087 03-11-92 3:47p
NWSQLAPI H 5999 12-03-91 5:06p
WXQLCALL LIB 4608 04-02-92 10:24a
WXQLCALL DLL 19872 11-16-92 2:02p
SQLWRQ DOC
- SQLWRQ.DOC The document you are reading
- WXQLCALL.DLL NetWare SQL Requester interface for Windows v3.0
- WXQLCALL.LIB Library containing symbols that the developer must
link with the application (if developing with C)
- NWSQLAPI.H Include file containing prototypes of XQL APIs
- NWSQLINT.H Include file containing environment configuration
parameters
NOTE: See the section "Developing Your Application" in this document
for information on the use of these files.
===========================================================================
NetWare SQL is a trademark of Novell, Inc.
NetWire is a service mark of Novell, Inc.
Windows is a trademark of Microsoft Corporation.
** End of SQLWRQ.DOC **