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