home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1999 March B / SCO_CASTOR4RRT.iso / nwsrvr / reloc.23 / $SYSVOL / public / unix / btrunix.doc / btrunix
Text File  |  1998-08-19  |  14KB  |  357 lines
  1. Filename:   BTRUNIX.DOC
  2. Product:    NetWare Btrieve v6.0 Requester for UnixWare
  3. Date:     June 1993
  4.  
  5.    This Readme document pertains to the NetWare Btrieve v6.0 Requester
  6.    for UnixWare, which is a component of NetWare Btrieve v6.1 for
  7.    NetWare v4.01.  The Btrieve Requester for UnixWare provides
  8.    UnixWare clients with access to Btrieve data residing on a NetWare
  9.    Btrieve server.  This document describes the Btrieve Requester
  10.    components and the NetWare and UnixWare environments.
  11.  
  12.    In NetWare 4.01 the following files are copied to
  13.    SYS:PUBLIC\UNIX:
  14.                     LIBBTRV.A
  15.                     LIBBTRV.SO
  16.                     LIBCOMM.A
  17.                     LIBCOMM.SO
  18.                     UNXCBTRV.O
  19.                     BTRUNIX.DOC
  20.  
  21. ==========================================================================
  22. Disclaimer
  23. ==========
  24.  
  25.    Novell, Inc. makes no representations or warranties with respect to any
  26.    NetWare software, and specifically disclaims any express or implied
  27.    warranties of merchantability, title, or fitness for a particular
  28.    purpose.
  29.  
  30.    Distribution of any NetWare software is forbidden without the express
  31.    written consent of Novell, Inc.  Further, Novell reserves the right to
  32.    discontinue distribution of any NetWare software.
  33.  
  34.    Novell is not responsible for lost profits or revenue, loss of use of
  35.    the software, loss of data, costs of re-creating lost data, the cost of
  36.    any substitute equipment or program, or claims by any party other than
  37.    you.  Novell strongly recommends a backup be made before any software
  38.    is installed.  Technical support for this software may be provided at
  39.    the discretion of Novell.
  40.  
  41.  
  42. ==========================================================================
  43. Contents
  44. ========
  45.  
  46.    Product Overview
  47.       C Interface Object File
  48.       Btrieve Interface Library
  49.       Communications Interface Library
  50.    Requester Requirements
  51.    Using the Requester
  52.       Archive and Shared-Object Libraries
  53.       Requester Linking
  54.       Requester Configuration Options
  55.       Requester Connection and Termination
  56.       File Access
  57.       Btrieve Operations
  58.    Associated Documents
  59.    Customer Support
  60.  
  61.  
  62. ==========================================================================
  63. Product Overview
  64. ================
  65.  
  66.    The NetWare Btrieve Requester for UnixWare allows a Btrieve client
  67.    application in a UnixWare environment to access Btrieve data on a
  68.    NetWare Btrieve server.  The Btrieve Requester uses the SPX Transport
  69.    Layer Interface (TLI) and can establish or disconnect a connection
  70.    with the Btrieve communications program BSPXCOM.  BSPXCOM handles
  71.    incoming requests to the Btrieve NLM from a remote source.
  72.  
  73.    The Btrieve Requester for UnixWare consists of a C interface object
  74.    file, a set of archive libraries, and a set of shared-object libraries.
  75.    Each set includes a library for the Btrieve Interface and a library
  76.    for the Communications Interface.
  77.  
  78.    The following figure illustrates how UnixWare clients can access
  79.    Btrieve data on a NetWare Btrieve server.
  80.  
  81.  
  82.                                           +-----------------+
  83.                                           |   Application   |
  84.                                           +-----------------+
  85.                                                 |     ^
  86.                                                 v     |
  87.                                   +----------------------------------+
  88.        +-----------+              |        C Interface/API           |
  89.        |  BSPXCOM  |   <---+      |          (UNXCBTRV.O)            |
  90.        +-----------+       |      +----------------------------------+
  91.           |      ^         |                    |     ^
  92.           v      |         |                    v     |
  93.        +-----------+       |      +----------------------------------+
  94.        |  Btrieve  |       |      |      Btrieve Interface Library   |
  95.        |    NLM    |       |      |      (LIBBTRV.A or LIBBTRV.SO)   |
  96.        +-----------+       |      +----------------------------------+
  97.           |      ^         |                    |     ^
  98.           v      |         |                    v     |
  99.        +-----------+       |      +----------------------------------+
  100.        |  NetWare  |       |      | Communications Interface Library |
  101.        +-----------+       |      |      (LIBCOMM.A or LIBCOMM.SO)   |
  102.                            |      +----------------------------------+
  103.                            |                    |     ^
  104.        NetWare Server      |                    v     |
  105.                            |      +----------------------------------+
  106.                            |      |         Transport Library        |
  107.                            |      |          Interface (TLI)         |
  108.                            |      +----------------------------------+
  109.                            |                    |     ^
  110.                            |                    v     |
  111.                            |              +-----------------+
  112.                            +--->          |       SPX       |
  113.                                           +-----------------+
  114.  
  115.                                             UnixWare Client
  116.                                        Application Server (AS) or
  117.                                          Personal Edition (PE)
  118.  
  119.  
  120.    The following sections describe the Btrieve Requester for UnixWare
  121.    components.
  122.  
  123.  
  124. C Interface Object File
  125. -----------------------
  126.  
  127.    The C interface object file (UNXCBTRV.O) links a C application
  128.    and maps a C interface to the Btrieve Requester interface.
  129.  
  130.  
  131. Btrieve Interface Library
  132. -------------------------
  133.  
  134.    The Btrieve Interface Library (LIBBTRV.A or LIBBTRV.SO) processes
  135.    Btrieve requests, sending requests to and receiving responses from
  136.    the Communications Interface Library.
  137.  
  138.    -  LIBBTRV.A    Archive Btrieve Interface Library
  139.  
  140.    -  LIBBTRV.SO   Shared-object Btrieve Interface Library
  141.  
  142.  
  143. Communications Interface Library
  144. --------------------------------
  145.  
  146.    The Communications Interface Library (LIBCOMM.A or LIBCOMM.SO) routes
  147.    Btrieve requests to the specified server where the Btrieve NLM
  148.    is located.  It also receives responses from the NetWare server
  149.    and returns them to the Btrieve Interface Library.
  150.  
  151.    -  LIBCOMM.A    Archive Communications Interface Library
  152.  
  153.    -  LIBCOMM.SO   Shared-object Communications Interface Library
  154.  
  155.  
  156. ==========================================================================
  157. Requester Requirements
  158. ======================
  159.  
  160.    The NetWare Btrieve Requester for UnixWare requires that the following
  161.    products be used in conjunction with it to enable UnixWare client
  162.    applications to access Btrieve data on a NetWare server.
  163.  
  164.     NetWare Products               UnixWare Products
  165.     ----------------------         ------------------------------------
  166.  
  167.       NetWare v3.11,                 UnixWare Application Server (AS) or
  168.         v4.0, or v4.01                 UnixWare Personal Edition (PE)
  169.  
  170.       NetWare Btrieve                UnixWare Libraries:
  171.         v5.15, v6.0, or v6.1            LIBNWAPI.SO  Shared-object NetWare
  172.                                         Unix Client (NUC) API
  173.                                         Library
  174.  
  175.                                      LIBNSL.SO    Shared-object Network
  176.                                         Service Library
  177.  
  178.                                      LIBSOCKET.SO Shared-object Socket
  179.                                         Interface Library
  180.  
  181.                                      LIBDL.SO     Shared-object Dynamic
  182.                                         Link Library
  183.  
  184.  
  185. ==========================================================================
  186. Using the Requester
  187. ===================
  188.  
  189.    The NetWare Btrieve v6.0 Requester for UnixWare is compatible with
  190.    NetWare Btrieve v5.15, v6.0, and v6.1.  In the case of NetWare
  191.    Btrieve v6.1, however, the Btrieve v6.0 Requester for UnixWare
  192.    does not provide full support for Btrieve v6.1 features.
  193.  
  194.         Btrieve v6.1 Features                   Btrieve v6.1 Features
  195.            Supported                                Not Supported
  196.    --------------------------------------     --------------------------
  197.  
  198.    Index Balancing                           Multiple Alternate Collating
  199.    Find Percentage Operation                 Sequences (ACSs)
  200.    Get By Percentage Operation               No Currency Change
  201.    STS Data Type                             Get Direct/Chunk Operation
  202.    Variable-tail Allocation Tables (VATs)    Update Chunk Operation
  203.    Locale-specific Alternate Collating
  204.    Sequence
  205.  
  206.  
  207.    This section covers the following topics:
  208.  
  209.    - when to use archive and shared-object libraries
  210.  
  211.    - how to link the Btrieve Requester
  212.  
  213.    - how to configure the Btrieve Requester
  214.  
  215.    - how to establish Btrieve Requester connections
  216.  
  217.    - how to access files using the Btrieve Requester
  218.  
  219.    - which Btrieve operations are affected by the Btrieve Requester
  220.  
  221.  
  222. Archive and Shared-Object Libraries
  223. -----------------------------------
  224.  
  225.    You can use either the archive library set or the shared-object
  226.    library set.
  227.  
  228.    - Use the archive library set (LIBBTRV.A and LIBCOMM.A) if you want
  229.      to link the libraries with your program at link time.
  230.  
  231.    - Use the shared-object library set (LIBBTRV.SO and LIBCOMM.SO) if
  232.      you want the libraries to be dynamically linked with your program
  233.      at execution time.
  234.  
  235.  
  236. Requester Linking
  237. -----------------
  238.  
  239.    To use the Btrieve Requester for UnixWare, complete the follwing steps:
  240.  
  241.    1. At the linker command line, link the UNXCBTRV.O file with your
  242.       program.
  243.  
  244.    2. Link your program with the following libraries (in the order given):
  245.  
  246.       LIBBTRV.A or LIBBTRV.SO
  247.       LIBCOMM.A or LIBCOMM.SO
  248.       LIBNWAPI.SO
  249.       LIBNSL.SO
  250.       LIBSOCKET.SO
  251.       LIBDL.SO
  252.  
  253.    The following example illustrates how to link the Btrieve Requester
  254.    for UnixWare:
  255.  
  256.       cc -c btrget.c
  257.       cc -o btrget -L/home/mydir/univel/breq -L/home/mydir/univel/comm
  258.          unxcbtrv.o btrget.o -lbtrv -lcomm -lnwapi -lnsl -lsocket -ldl
  259.  
  260.       where:
  261.  
  262.       -L/home/mydir/univel/breq    Indicates the location of libbtrv.a.
  263.  
  264.       -L/home/mydir/univel/comm    Indicates the location of libcomm.a.
  265.  
  266.       btrget.c                     Specifies your program file.
  267.  
  268.       btrget.o                     Specifies the object file for btrget.c.
  269.  
  270.  
  271.    NOTE: You can place UNXCBTRV.O in your working directory.  However,
  272.       if you want to place UNXCBTRV.O in another directory, specify
  273.       the file's location.
  274.  
  275.    For shared-object libraries ending with the .SO extension, you need to
  276.    set the environment variables under the Bourne shell as follows:
  277.  
  278.    LD_LIBRARY_PATH=/home/mydir/univel/breq:/home/mydir/univel/comm export
  279.                LD_LIBRARY_PATH
  280.  
  281.  
  282. Requester Configuration Options
  283. -------------------------------
  284.  
  285.    You do not need to set any configuration options to specify the size
  286.    of the data message buffers.  The Btrieve Requester for UnixWare
  287.    dynamically expands the data message buffer to pass records between
  288.    Btrieve and the application.  The Btrieve Requester for UnixWare
  289.    also dynamically expands the Server Router Table that is used for
  290.    routing the Btrieve requests to the specified server.
  291.  
  292.  
  293. Requester Connection and Termination
  294. ------------------------------------
  295.  
  296.    A UnixWare client can connect to a maximum of 50 servers.  The Btrieve
  297.    Requester for UnixWare automatically terminates all the connections
  298.    that are left open when an application exits.  However, the files
  299.    that are left open when an application exits remain open until a
  300.    Btrieve Stop operation is issued.
  301.  
  302.  
  303. File Access
  304. -----------
  305.  
  306.    There are no drive mappings in UnixWare.  You must log in to the
  307.    server and initiate authentication with the server in order to
  308.    access files or directories on it.  You can use the NetWare Access
  309.    Utility (NAU) to log in to the server.
  310.  
  311.    You cannot use relative paths or simple filenames.  You must use the
  312.    full pathname because of the limitation imposed by the NetWare C
  313.    Interface.
  314.  
  315.  
  316. Btrieve Operations
  317. ------------------
  318.  
  319.    The Btrieve Requester for UnixWare affects the following Btrieve
  320.    operations:
  321.  
  322.     - Get Directory: This operation can return only the current
  323.       directory.  It ignores the logical disk drive specified in the key
  324.       number parameter.
  325.  
  326.     - Set Directory: For this operation, you must specify the path
  327.       according to the UnixWare pathname specification.
  328.  
  329.  
  330. ==========================================================================
  331. Associated Documents
  332. ====================
  333.  
  334.    For detailed information on NetWare Btrieve, refer to the "Btrieve
  335.    Installation and Operation" manual that was included in the
  336.    documentation set for the NetWare operating system you are
  337.    currently using.
  338.  
  339.    If you have purchased a Btrieve Developer's Kit or a NetWare Btrieve
  340.    Developer's Kit Supplement, refer to the "Btrieve Programmer's
  341.    Manual" that was included in the kit for information about the
  342.    Btrieve operations.
  343.  
  344.  
  345. ==========================================================================
  346. Customer Support
  347. ================
  348.  
  349.    For information about UnixWare-specific problems when using the NetWare
  350.    Btrieve Requester for UnixWare, contact Univel Developer Support as
  351.    follows:
  352.  
  353.    Fax number: (801) 568-8699            Email: devsup@univel.com
  354.  
  355. **End of BTRUNIX.DOC**
  356.  
  357.