home *** CD-ROM | disk | FTP | other *** search
/ Stars of Shareware: Programmierung / SOURCE.mdf / programm / windows / c / sqlwrq / sqlwrq.doc < prev    next >
Encoding:
Text File  |  1992-08-25  |  6.0 KB  |  156 lines
  1. Filename: SQLWRQ.DOC
  2. Product:  WXQLCALL.DLL v3.0
  3. Date:      August 1992
  4.  
  5. ===========================================================================
  6. Contents
  7. ========
  8.  
  9.    General Information
  10.    Critical Information
  11.    Developing Your Application
  12.       Developing Your Application with C
  13.       Developing Your Application with Other Languages
  14.    Installing and Using WXQLCALL.DLL v3.0 with XQL v2.11
  15.    Installation Notes
  16.  
  17. ===========================================================================
  18. General Information
  19. ===================
  20.  
  21.    This document describes how to install and use the NetWare SQL v3.0
  22.    Requester for Windows (WXQLCALL.DLL) with XQL v2.11.  The
  23.    NetWare SQL Requester for Windows is an interface that uses the DOS
  24.    Protected Mode Interface (DPMI) that Windows provides to access XQL,
  25.    which runs in real mode.
  26.  
  27. ===========================================================================
  28. Critical Information
  29. ====================
  30.  
  31.    Although you should read this entire file, pay special attention to
  32.    this section.  It contains information critical to your success in
  33.    using WXQLCALL.DLL.
  34.  
  35.    You can use XQL v2.x to develop and run applications using
  36.    WXQLCALL.DLL v3.0. If you want to run these applications in a
  37.    NetWare environment, you must upgrade or purchase NetWare SQL v3.0.
  38.    (You can also use NetWare SQL v3.0 to develop applications using
  39.    WXQLCALL.DLL v3.0)
  40.  
  41. ===========================================================================
  42. Developing Your Application
  43. ===========================
  44.  
  45.    This section discusses information pertinent to languages you may use
  46.    to develop XQL applications.
  47.  
  48.  
  49. Developing Your Application with C
  50. ----------------------------------
  51.  
  52.    The header file NWSQLAPI.H contains the prototype definitions for the
  53.    XQL APIs (application programming interface); therefore, you should
  54.    include this header file in your application source files to ensure
  55.    that the correct calling sequence exists for interfacing with the
  56.    XQL APIs.  NWSQLAPI.H includes the header file NWSQLINT.H, which
  57.    contains environment configuration parameters.
  58.  
  59.    In NWSQLINT.H, set the operating system environment to Windows in
  60.    section 1, "OS Environment," and define which C compiler you
  61.    are using in section 2, "C Compiler."  In NetWare SQL v3.0, the levels
  62.    of API support have new names.  The SQL-level functions correspond to
  63.    XQLM, and the relational primitives correspond to XQLP.  By default,
  64.    both API levels are defined in section 3, "API Level Support."
  65.  
  66.    After compiling your Windows application, link it with the import
  67.    library WXQLCALL.LIB.
  68.  
  69.    NOTE: xRecall, xField, and xCompute give incorrect results when
  70.      you execute them using XQL.EXE v2.11a.
  71.  
  72.  
  73. Developing Your Application with Other Languages
  74. ------------------------------------------------
  75.  
  76.    The NWSQLAPI.H file provides the information you need to determine
  77.    how to call the various functions in WXQLCALL.DLL. Consult the
  78.    language reference for your compiler for more information on calling
  79.    Dynamic Link Library (DLL) functions.
  80.  
  81. ===========================================================================
  82. Installing and Using WXQLCALL.DLL v3.0 with XQL v2.11
  83. =====================================================
  84.  
  85.    Before using WXQLCALL.DLL with XQL, apply optional patch #38 to XQL.EXE,
  86.    XQLO.EXE, XQLP.EXE, or XQLPO.EXE (whichever one you are running).
  87.  
  88.    Initialize WXQLCALL.DLL in the [NSREQDPMI] section of the NOVDB.INI file.
  89.    The default parameters for this section are as follows:
  90.  
  91.    [NSREQDPMI]
  92.    datalength=4096  ; same as the /W: option used for XQL
  93.    views=8        ; same as the /V: option used for XQL
  94.    tasks=2        ; maximum tasks that can use WXQLCALL.DLL concurrently
  95.  
  96.    The value for the datalength option must equal or exceed the size of
  97.    the largest record being accessed.
  98.  
  99.    Load Btrieve and XQL before starting Windows, or place the commands to
  100.    load Btrieve and XQL in the WINSTART.BAT file.  (You can use the latter
  101.    method only if you are using Windows in enhanced mode.)  Windows must be
  102.    able to locate WXQLCALL.DLL.
  103.  
  104.    NOTE: If you do not load Btrieve and XQL in WINSTART.BAT, you must load
  105.      them before loading Windows.  Otherwise, your application
  106.      receives Status Code 2112.
  107.  
  108.    To unload WXQLCALL.DLL, an XQL application running in Windows must
  109.    call xStop or XQLStop before terminating.
  110.  
  111.    If you loaded Btrieve and XQL before starting Windows, make sure all
  112.    Windows tasks have exited, and then unload Windows before unloading XQL
  113.    and Btrieve.  Unload XQL by issuing the XQLUTIL -STOP command from
  114.    the DOS prompt.  Unload Btrieve by issuing the BUTIL -STOP command from
  115.    the DOS prompt.
  116.  
  117.    If you loaded Btrieve and XQL using the WINSTART.BAT file, Windows
  118.    unloads them when you exit the Windows environment.
  119.  
  120. ===========================================================================
  121. Installation Notes
  122. ==================
  123.  
  124.    You can find the following files on NetWire or on the diskette you
  125.    received:
  126.  
  127. NWSQLINT H        4087 03-11-92   3:47p
  128. NWSQLAPI H        5999 12-03-91   5:06p
  129. WXQLCALL LIB      4608 04-02-92  10:24a
  130. WXQLCALL DLL     20832 04-02-92  10:24a
  131. SQLWRQ   DOC      
  132.  
  133.    - SQLWRQ.DOC       The document you are reading
  134.  
  135.    - WXQLCALL.DLL     NetWare SQL Requester interface for Windows v3.0
  136.  
  137.    - WXQLCALL.LIB     Library containing symbols that the developer must
  138.               link with the application (if developing with C)
  139.  
  140.    - NWSQLAPI.H       Include file containing prototypes of XQL APIs
  141.  
  142.    - NWSQLINT.H       Include file containing environment configuration
  143.               parameters
  144.  
  145.  
  146.    NOTE: See the section "Developing Your Application" in this document
  147.      for information on the use of these files.
  148.  
  149. ===========================================================================
  150.  
  151. NetWare SQL is a trademark of Novell, Inc.
  152. NetWire is a service mark of Novell, Inc.
  153. Windows is a trademark of Microsoft Corporation.
  154.  
  155. ** End of SQLWRQ.DOC **
  156.