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