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