home *** CD-ROM | disk | FTP | other *** search
/ Network Support Encyclopedia 96-1 / novell-nsepro-1996-1-cd2.iso / download / netware / ptf413.exe / BTRIEVE.TXT < prev    next >
Text File  |  1993-09-23  |  13KB  |  286 lines
  1. Btrieve v6.1 for NetWare v4.0
  2. January 1993
  3.  
  4. ===========================================================================
  5. Contents
  6. ========
  7.    General Information
  8.    Installation Procedure
  9.    Upgrade Information
  10.       Btrieve v6.x Utilities
  11.       Btrieve v6.x Status Codes
  12.       STS Data Type
  13.    Btrieve v6.x Program Files
  14. ===========================================================================
  15. General Information
  16. ===================
  17.    This Readme document pertains to Btrieve v6.1 for NetWare v4.0.  For
  18.    detailed information about the Btrieve v6.1 product, refer to the
  19.    "Btrieve Installation and Operation" manual.
  20. ===========================================================================
  21. Installation Procedure
  22. ======================
  23.    You can use the NetWare INSTALL utility to copy the Btrieve v6.1 program
  24.    files to your server. Refer to the NetWare v4.0 documentation for a
  25.    complete description of the installation procedure.
  26. ===========================================================================
  27. Upgrade Information
  28. ===================
  29.    For a description of the enhancements to Btrieve v6.x, refer to
  30.    "Btrieve v6.x Enhancements" in Chapter 1 of the "Btrieve Installation
  31.    and Operation" manual provided with this product.
  32.  
  33. Btrieve v6.x Utilities
  34. ----------------------
  35.    Btrieve Monitor utility (BTRMON.NLM) -- The Btrieve v6.x Monitor utility
  36.    (BTRMON.NLM) replaces the Btrieve v5.x Console utility (BCONSOLE.NLM).
  37.  
  38.    NOTE: NLM applications that call Btrieve must issue a Btrieve Reset
  39.    before unloading.  Failure to do so may lead to a server abend when
  40.    you try to use the Btrieve Monitor utility to monitor the
  41.    NLM application's activity.
  42.  
  43.    Rebuild utility (BREBUILD.NLM) -- This new Btrieve v6.x utility
  44.    allows you to upgrade Btrieve v5.x files to Btrieve v6.x.  For more
  45.    information on rebuilding your existing files, refer to "Rebuilding
  46.    Existing Btrieve Files" in Chapter 3 of the "Btrieve Installation
  47.    and Operation" manual provided with this product.
  48.  
  49.    NOTE: Before running the Rebuild utility (either from the command
  50.          line or through the Setup utility), you must start Btrieve v6.x.
  51.  
  52.    NetWare Directory Services (NDS) Support utility (BDIRECT.NLM) --
  53.    This new Btrieve v6.1 utility allows you to register Btrieve v6.1
  54.    as an object with NDS.
  55.  
  56.    Roll Forward utilities (BROLLFWD.EXE, PBROLL.EXE, and WBROLL.EXE) --
  57.    When using Btrieve's logging feature and the Roll Forward utility,
  58.    consider the following:
  59.  
  60.    - Btrieve does not allow a log file to contain log entries created by
  61.      different versions of Btrieve.  That is, all entries in a log file
  62.      must be logged under the same version of Btrieve.  Otherwise, Btrieve
  63.      displays a system error message on the server console and ignores
  64.      logging for the Btrieve file.
  65.  
  66.    - If you need to restart Btrieve, specify the same Index Balancing
  67.      setting that was used when you first loaded Btrieve (after a backup)
  68.      and performed logging.  Otherwise, you may receive a Status Code 43
  69.      when you run the Roll Forward utility.
  70.  
  71.    - If you need to run the Roll Forward utility (for example, after a
  72.      system crash), load the same version of Btrieve and specify the same
  73.      Index Balancing setting that was used during logging.  Otherwise,
  74.      you may receive a Status Code 43.
  75.  
  76.    NOTE: If you want to switch to a different version of Btrieve or
  77.          you want to change the Index Balancing setting, first create a
  78.          backup of the Btrieve files to be logged and then delete the
  79.          corresponding log files.
  80.  
  81.    - If you attempt to create a log file for a Btrieve file that contains
  82.      records larger than 57 KB, you may receive a Status Code 43.
  83.  
  84.    The Btrieve v6.1 BROLLFWD.EXE file replaces the Btrieve v6.0 DBROLL.EXE.
  85.  
  86.    NOTE: If you are upgrading from Btrieve v6.0 to Btrieve v6.1, the
  87.          NetWare v4.0 installation procedure will not overwrite the
  88.          DBROLL.EXE file.  Do not use DBROLL.EXE to perform the
  89.          roll forward procedure with Btrieve v6.1.
  90.  
  91.  
  92. Btrieve v6.x Status Codes
  93. -------------------------
  94.    Status Code 11 (The specified filename is invalid) --  If you receive
  95.    this status code when you open a Btrieve file using the Btrieve OS/2
  96.    Requester (BTRCALLS.DLL), make sure that you are using the latest
  97.    NetWare OS/2 Requester.
  98.  
  99.    Status Code 43 (The specified record address is invalid) -- The Btrieve
  100.    Roll Forward utility returns this status code because the address
  101.    acquired from the Free Space List of the Btrieve file is different from
  102.    the one received at the time when the operation was originally executed.
  103.    The resulting file of the roll forward becomes out of sync with the
  104.    original run.  This syncronization problem occurs because different
  105.    versions of Btrieve or the same Btrieve version but with a different
  106.    Index Balancing setting may produce different Free Space Lists.
  107.    The following is a summary of the specific conditions for which
  108.    Status Code 43 can be returned:
  109.  
  110.    - During logging, Btrieve was loaded multiple times and the
  111.      Index Balancing setting was not always the same.
  112.  
  113.    - A record larger than 57K is inserted or updated.
  114.  
  115.    - A different version of Btrieve or the same Btrieve version but
  116.      with a different Index Balancing setting from what was used at
  117.      logging time is now loaded (at roll forward time). To correct
  118.      the synchronization problem, load the proper version of Btrieve
  119.      with the proper Index Balancing setting.
  120.  
  121.    - You logged Btrieve operations with the Index Compaction option (/C)
  122.      set on the Btrieve NLM but not on the Roll Forward utility,
  123.      or vice versa.
  124.  
  125.    Status Code 44 (The specified key path is invalid) -- Btrieve v6.1
  126.    returns this code for some situations, in which earlier versions of
  127.    Btrieve returned Status Code 82 (The application lost positioning).
  128.    These situations only occur when you define the key attribute to be
  129.    manual or null. If you have an existing Btrieve application that
  130.    checked for Status Code 82, you may want to rewrite the application
  131.    to check for Status Code 44 as well.
  132.  
  133.    Status Code 102 (Insufficient stack space is available) -- Btrieve v6.1
  134.    requires 3 KB of stack space. If your NLM application receives this
  135.    status code, try increasing the size of your stack space.  You
  136.    may need to allow more than 3 KB of stack space if you are accessing
  137.    files defined by NetWare SQL as being under Referential Integrity
  138.    (RI) constraints. Because Btrieve uses recursion when enforcing the
  139.    RI constraints, you will need 3 KB of stack space for each level
  140.    of recursion.
  141.  
  142. STS Data Type
  143. -------------
  144.    Btrieve v6.1 supports a longer STS data type than NetWare SQL.  Make
  145.    sure that the length of the STS data type does not exceed 15 bytes
  146.    if you plan to use the Btrieve v6.1 files with NetWare SQL.
  147. ===========================================================================
  148. Btrieve v6.x Program Files
  149. ==========================
  150.    Btrieve files can be grouped into the following categories:
  151.       - Files related to server operations
  152.       - Files related to DOS workstation operations
  153.       - Files related to Windows workstation operations
  154.       - Files related to OS/2 workstation operations
  155.  
  156.    The following lists describe the files in each category.
  157.       - Files related to server operations:
  158.         BDIRECT.NLM     NDS Support utility that allows you to
  159.                         install or remove a Btrieve Server object.
  160.  
  161.         BDIRECT.MSG     Message file for BDIRECT.NLM.
  162.  
  163.         BDROUTER.NLM    NLM that allows server-based Btrieve applications
  164.                         to access Btrieve databases on remote servers
  165.                         and also provides NDS support in NetWare v4.0.
  166.  
  167.         BDROUTER.MSG    Message file for BDROUTER.NLM.
  168.  
  169.         BREBUILD.NLM    Rebuild utility that lets you convert existing
  170.                         Btrieve v5.x files to Btrieve v6.x format.
  171.  
  172.         BREBUILD.MSG    Message file for BREBUILD.NLM.
  173.  
  174.         BROUTER.NLM     NLM that allows server-based Btrieve applications
  175.                         to access Btrieve databases on remote servers.
  176.  
  177.         BROUTER.MSG     Message file for BROUTER.NLM.
  178.  
  179.         BSETUP.NLM      Btrieve installation and configuration utility.
  180.  
  181.         BSETUP.HLP      Help file for BSETUP.NLM.
  182.  
  183.         BSETUP.MSG      Message file for BSETUP.NLM.
  184.         BSPXCOM.NLM     SPX communications agent.
  185.  
  186.         BSPXCOM.MSG     Message file for BSPXCOM.NLM.
  187.  
  188.         BSPXSTUB.NLM    NLM that allows you to use the Btrieve Monitor
  189.                         utility (BTRMON.NLM) when BSPXCOM.NLM is not
  190.                         loaded.
  191.  
  192.         BSPXSTUB.MSG    Message file for BSPXSTUB.NLM.
  193.  
  194.         BSTART.NCF      Batch file executed to start Btrieve.  This file
  195.                         also loads BSPXCOM.NLM, BDIRECT.NLM, and
  196.                         BROUTER.NLM (if Btrieve is configured to do so).
  197.  
  198.         BSTOP.NCF       Batch file executed to stop Btrieve.  This file
  199.                         also unloads BSPXCOM.NLM, BDIRECT.NLM, and
  200.                         BROUTER.NLM (if loaded).
  201.  
  202.         BTRIEVE.NLM     Btrieve Record Manager (database engine).
  203.  
  204.         BTRIEVE.MSG     Message file for BTRIEVE.NLM.
  205.  
  206.         BTRMON.NLM      Btrieve Monitor utility that lets you monitor
  207.                         the activity of Btrieve files, users, and
  208.                         communications resources.
  209.  
  210.         BTRMON.MSG      Message file for BTRMON.NLM.
  211.  
  212.         BTRMON.HLP      Help file for BTRMON.NLM.
  213.  
  214.         BUTIL.NLM       Btrieve Maintenance utility, which is a command
  215.                         line utility that allows you to create,
  216.                         manipulate, and recover Btrieve data files.
  217.  
  218.         BUTIL.MSG       Message file for BUTIL.NLM.
  219.  
  220.         RSPXSTUB.NLM    Module that resolves external references for the
  221.                         Btrieve Monitor utility (BTRMON.NLM) when BSPXCOM
  222.                         is not loaded.  If you want to use the Btrieve
  223.                         Monitor utility to monitor outgoing requests
  224.                         generated by the Btrieve Message Router (BROUTER
  225.                         or BDROUTER) to another server and you do not
  226.                         want to load BSPXCOM, load RSPXSTUB instead of
  227.                         BSPXSTUB at the server.
  228.  
  229.         RSPXSTUB.MSG    Message file for RSPXSTUB.NLM.
  230.  
  231.       - Files related to DOS workstation operations:
  232.  
  233.         BREQUEST.EXE    Btrieve Requester for DOS.
  234.  
  235.         BREQUEST.MSG    Message file for BREQUEST.EXE.
  236.  
  237.         BREQUTIL.EXE    Btrieve Requester utility that allows you to
  238.                         stop the Requester and to obtain the Requester's
  239.                         version number at a DOS workstation.
  240.  
  241.         BREQUTIL.MSG    Message file for BREQUTIL.EXE.
  242.  
  243.         BROLLFWD.EXE    Roll Forward utility for the DOS operating
  244.                         environment.  This utility recovers changes
  245.                         made to a Btrieve file between the time of
  246.                         the last backup and a system failure.
  247.  
  248.         BROLLFWD.MSG    Message file for BROLLFWD.EXE.
  249.  
  250.       - Files related to Windows workstation operations:
  251.  
  252.         NOVDB.INI       Btrieve initialization file for the Btrieve
  253.                         Windows Requester.
  254.  
  255.         WBROLL.EXE      Roll Forward utility for the Windows operating
  256.                         environment.  This utility recovers changes
  257.                         made to a Btrieve file between the time of
  258.                         the last backup and a system failure.
  259.  
  260.         WBROLLRS.DLL    Resource file for WBROLL.EXE.
  261.  
  262.         WBTRCALL.DLL    Btrieve Requester for Windows.
  263.  
  264.         WBTRVRES.DLL    Resource file for the Btrieve Requester.
  265.  
  266.         WNDBCNVT.EXE    Windows Conversion utility that converts the
  267.                         client-based Btrieve DLL (WBTRCALL.DLL) to
  268.                         WBTRLOCL.DLL.
  269.  
  270.       - Files related to OS/2 workstation operations:
  271.  
  272.         BTRCALLS.DLL    Btrieve Requester for OS/2.
  273.  
  274.         NDBCNVT.EXE     OS/2 Conversion utility that converts the
  275.                         client-based Btrieve DLL (BTRCALLS.DLL) to
  276.                         BTRLOCL.DLL.
  277.  
  278.         NDBCOMM.DLL     Communications handler for the Btrieve
  279.                         Requester for OS/2.
  280.  
  281.         PBROLL.EXE      Roll Forward utility for the OS/2 operating
  282.                         environment.  This utility recovers changes
  283.                         made to a Btrieve file between the time of
  284.                         the last backup and a system failure.
  285.  
  286.         PBTRVRES.DLL    Resource file for PBROLL.EXE.