home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c164 / 1.img / $READ.ME < prev    next >
Encoding:
Text File  |  1993-12-17  |  17.4 KB  |  425 lines
  1.  
  2.       $read.me (c)Copyright Sequiter Software Inc., 1992-1993.
  3.       All rights reserved.
  4.       ----------------------------------------------------------
  5.       
  6.           README -  Table of Contents
  7.       
  8.       I.    Introduction
  9.       
  10.       II.   CodeBase++ Electronic Documentation Files       
  11.  
  12.       III.  CodeBase++ Manual and Code Revisions 
  13.       
  14.       IV.   Examples 
  15.    
  16.       V.    CodeBase++ Public-Access: Sequiter BBS and Compuserve Access 
  17.  
  18.       VI.   Accessing More Than 20 Files in DOS or Windows 
  19.       
  20.       ----------------------------------------------------------
  21.       
  22.       I.    Introduction
  23.       
  24.          CodeBase++ is a C++ library for database management.  Its compat-
  25.       ibility allows you to directly create, access, or change dBASE 
  26.       IV, dBASE III, FoxPro or Clipper data, index, or memo files.
  27.       
  28.          CodeBase++ has full multi-user capabilities.  When programs are 
  29.       run on a network, the network is automatically detected and 
  30.       used.  CodeBase++ allows both explicit and automatic record 
  31.       locking and file locking.  It is also possible to bypass the 
  32.       locking mechanism and read data locked by another user.
  33.       
  34.          All of the CodeBase++ functions work together to allow C++
  35.       programmers to program at a very high level.  Programs will 
  36.       execute very quickly, they will be readable and there will be no 
  37.       unnecessary lines of code.
  38.       
  39.          In order to use CodeBase++, it is necessary to have a C++ 
  40.       compiler and it is necessary to have some knowledge of the C++
  41.       programming language.
  42.       
  43.          To accommodate users requiring DOS screen management 
  44.       capabilities, a C software library called 'CodeScreens' is 
  45.       available.  CodeScreens features pop-up and pull-down window 
  46.       support, color screen design capabilities, and print functions, 
  47.       plus much more.
  48.       
  49.          For information on CodeScreens, contact Sequiter Software Inc.
  50.       Also, look for a CodeBase++ portability version in the future!
  51.  
  52.  
  53.          CodeBase++ 5.1 serial and version numbers can be found on the
  54.       inside-front covers of the supplied Reference Manual.
  55.       
  56.       ----------------------------------------------------------
  57.       
  58.       II.   CodeBase++ Electronic Documentation Files 
  59.       
  60.          It is highly recommended that any installed documentation
  61.       files be read in addition to the CodeBase++ manuals. 
  62.       
  63.          The various documentation files provide additional specific
  64.       information not found in the CodeBase++ manual.  Please note
  65.       that only documentation files relevant to the options
  66.       installed will be present on your drive after installation.
  67.       
  68.          All electronic documentation files have been suitably 
  69.       formatted for hard-copy printing.  To print any document, 
  70.       simply direct that file to your printer, using the 'print' 
  71.       command.
  72.       
  73.          The complete list of documentation files that are present 
  74.       on the CodeBase++ disk are:
  75.       
  76.       GENERAL DOCUMENTATION:
  77.       
  78.       $READ.ME        General user information, manual changes/updates,
  79.                       and installation information. Always installed.
  80.       
  81.       INSTALL.DOC     Information on CodeBase++ installation.  Includes
  82.                       manual unfolding documentation.
  83.       
  84.       COMPILER DOCUMENTATION:
  85.       
  86.       COMPILER.DOC    Compiler specific documentation.  There is one 
  87.                       COMPILER.DOC file in each CodeBase++ compiler 
  88.                       subdirectory (i.e. in \BOR31, \MSC7)
  89.       
  90.       EXAMPLES.DOC    Information on usage of the provided source code
  91.                       examples.
  92.       
  93.       CONVERT.DOC     CodeBase 5.1 to CodeBase++ 5.1 translation information.
  94.       
  95.       ----------------------------------------------------------
  96.       
  97.       III.  CodeBase++ Manual and Code Revisions
  98.  
  99.       Following are corrections to the CodeBase++ 5.1 printed documentation:
  100.  
  101.       CodeBase++ 5.0 USER'S GUIDE:
  102.  
  103.        No current critical addendum.
  104.  
  105.       CodeBase++ 5.0 REFERENCE GUIDE:
  106.  
  107.       1. Conditional Compilation Switch addendum (page 6)
  108.          New Conditional Compilation Switch.  'S4FLUSH' may be defined
  109.          if a hard-flush is required when writing data to disk:
  110.  
  111.  
  112.          S4FLUSH   This switch automatically calls function file4flush()
  113.                    whenever a write() occurs.  It is set automatically
  114.                    whenever S4WINDOWS, S4DLL or S4DLL_BUILD is defined.
  115.                    This switch is not usually required, since a write()
  116.                    should perform a flush, but some environments do not
  117.                    flush data immediately.  S4FLUSH is meant to be used
  118.                    with these environments.   See function file4flush().
  119.  
  120.  
  121.       2. Code4::lockAttempts Clarification (page 25)
  122.  
  123.          If Code4::lockAttempts is greater than zero, it is the
  124.          number of times a CodeBase++ function will attempt to lock before
  125.          returning r4locked.
  126.  
  127.          If Code4::lockAttempts is (int) -1, CodeBase++ retries until
  128.          it succeeds.
  129.  
  130.          Any other value for Code4::lockAttempts is undefined.
  131.  
  132.       3. Sort4::assignCmp (page 323)
  133.          
  134.          This function is not available to Microsoft compiler users
  135.          under Windows.
  136.  
  137.  
  138.       CodeBase++ SOURCE CODE CHANGES:
  139.       
  140.       Note: Notices of fixes to CodeBase++ 5.1 will be 
  141.             updated on files contained on Sequiter's BBS system. 
  142.             For more information, refer to 'Section V:
  143.             CodeBase++ Public-Access Bulletin Board System'.
  144.  
  145.       ----------------------------------------------------------
  146.  
  147.       IV.    Examples
  148.       
  149.           There are three sources of CodeBase++ 5.1 examples:
  150.       
  151.           1.  The manual, for short examples of function (and class)
  152.               usage.
  153.       
  154.  
  155.           2.  The examples present on the CodeBase++ 5.1 diskette.
  156.               All examples installed are placed on the CodeBase++
  157.               \EXAMPLES subdirectory.  Examples from the manual
  158.               can be found in \EXAMPLES.  See EXAMPLES.DOC in this
  159.               subdirectory for more information.
  160.            
  161.       
  162.           3.  Our BBS, which contains new examples produced by our
  163.               developers and examples which users have uploaded.
  164.               Please see 'Section V: CodeBase++ Public-Access
  165.               Bulletin Board System (BBS)' for more information.
  166.       
  167.       ----------------------------------------------------------
  168.       
  169.       V.   CodeBase++ Public-Access: Sequiter BBS and Compuserve Access 
  170.       
  171.          Any user with a modem may connect with the Sequiter
  172.       Bulletin Board System.  Connection to the BBS is free, 
  173.       although all users are responsible for their own long-
  174.       distance toll charges.  The BBS operates twenty-four hours
  175.       a day, seven days-a-week, excluding maintenance periods.  
  176.       The BBS operates under the DOS environment, running
  177.       WildCat(c) communications software.
  178.       
  179.          Code updates for CodeBase++ 5.1 can be accessed from the BBS
  180.       through the use of patch files, which may be downloaded freely.  
  181.       These files are .ZIP files containing instructions and the patch 
  182.       utility.  The patch utility requires an existing copy of 
  183.       CodeBase++ 5.1 and works by updating your existing source and header
  184.       modules to the latest version.  The patch utility can also be
  185.       obtained from Compuserve (see below) .
  186.  
  187.          The BBS also contains several CodeBase++-related files and
  188.       documents that may be downloaded.  There is also a message
  189.       system so that electronic correspondence may be left for
  190.       Sequiter staff, or other BBS users.  The files include example
  191.       programs, utilities, add-ons and enhancements, written by
  192.       both Sequiter developers and CodeBase++ users.  Users are
  193.       invited to upload interesting CodeBase++-related files for the
  194.       use of all BBS users.  A list of the latest enhancements, fixes 
  195.       and additions for all Sequiter products is also maintained on
  196.       the Sequiter BBS.  Users are encouraged to periodically
  197.       download these files, and make the appropriate changes.
  198.       
  199.          The phone number for the BBS is found on the back outside
  200.       cover of the CodeBase++ manual.  The phone number is currently
  201.       (403)-437-2229.
  202.       
  203.          Settings for the connection are:
  204.       
  205.               1200, 2400 or 9600 baud
  206.               ANSI terminal type.
  207.               No parity.
  208.               8 bits.
  209.               1 stop bit.
  210.       
  211.          Upon connection to the Sequiter BBS, a new user will be
  212.  
  213.       prompted for some information and the selection of a private
  214.       password.  After selection of your password, please memorize
  215.       it since you will be asked for that password on future
  216.       connections to the BBS.
  217.  
  218.          Sequiter Software is a registered member of the 'Data Based
  219.       Advisor Forum' on CompuServe.  Through this forum, messages can
  220.       be sent to Sequiter Technical Support.  Also, support and demonstration 
  221.       files can be downloaded from the DBA library area.  To access the
  222.       DBA forum, type 'GO DBA' at any CompuServe exclamation (!) prompt.
  223.       Messages can be directed to Sequiter using the following CIS ID
  224.       number:
  225.  
  226.               71321,1306
  227.  
  228.          This account is monitored for messages a minimum of three times
  229.       a week.
  230.  
  231.          The patch file discussed above (paragraph two) can be obtained 
  232.       from the DBA library area.  
  233.  
  234.          The following are detailed instructions as to how our customers
  235.       can access Sequiter through the DBA Forum on Compuserv (CIS).
  236.       
  237.        1 - Once user is logged on to CIS, he or she can get to the DBA Forum
  238.            from any "!" prompt by entering the command "GO DBA".
  239.       
  240.        2 - This will bring the user into the DBA top menu, at which time the
  241.            user selects menu item " 1 Data Based Advisor Forum ".
  242.       
  243.        3 - The next screen is the Welcome Screen, at which the user
  244.            presses the <ENTER>, which then takes the user into the "Forum
  245.            Menu".
  246.       
  247.        4 - If menu item " 3 LIBRARIES (Files) " is selected, the next
  248.            menu to come up is one which lists all 17 library areas.  All
  249.            Sequiter files will be located in area " 6 Libs, Addons, Tools".
  250.       
  251.        5 - After selecting this area, the user can then browse through
  252.            this area, searching by a key word which identifies our
  253.            packages (i.e. SEQUITER, CodeBase++, CODEBASIC, etc.), or if the
  254.            user knows the name of the file he wants to download, he can
  255.            simply select download.
  256.  
  257.       --------------------------------------------------------------------
  258.  
  259.       VI.  Accessing More Than 20 Files in DOS or Windows 
  260.  
  261.          Due to a default imposed by most compilers and DOS, no more
  262.       than  twenty files can be opened during the execution of any
  263.       one single process by default.  And since the file streams 'stdout',
  264.       'stprn', 'stdin', 'stderr' and 'stdaux' count as files, and
  265.       your executing application counts as well, this leaves only
  266.       fourteen database, index  and memo files that are allowed to
  267.       be opened by any one application.  CodeBase++ has no inherent
  268.  
  269.       limit to the number of files opened, but will display an error
  270.       because of the failure of the system function call 'sopen()'.      
  271.  
  272.          Several compilers have patches available for increasing the
  273.       file limit.  However, because of the nature of these patches,
  274.       Sequiter does not provide technical support regarding this issue.
  275.        Please consult  your compiler's manufacturer for information.
  276.        Again, CodeBase++ has no inherent file limit, but will produce
  277.       an error message when it receives an 'error' return from any
  278.       C library function that is called.     
  279.  
  280.          Don't forget to increase the number of file handles in your 
  281.       CONFIG.SYS file.  To open more than 20 files (eg. 100), you
  282.       need to also modify your CONFIG.SYS file :
  283.  
  284.                  eg.  set  'FILES=100'
  285.  
  286.       
  287.          Please note the above config.sys setting will only affect
  288.       files opened on your local drives.  If you are operating on
  289.       a network drive, note that there is a default setting to the
  290.       number of files specified by your network software.  For example,
  291.       Novell's default setting is 40 files. If you want to increase
  292.       this limit in Novell, create or edit the file 'SHELL.CFG',
  293.       which should be located together with 'IPX.COM' and 'NETX.COM'.
  294.       Add  'FILEHANDLES = n', where  'n' is the maximum number of
  295.       file handles required, into  SHELL.CFG.  Other LAN software
  296.       users should consult their LAN documentation.
  297.  
  298.          Under MicroSoft Windows 3.x, you need to also make a call
  299.       to the function SetHandleCount (eg. SetHandleCount( 100 )).
  300.       If you are using CodeBase++ 5.1 as a DLL, then you need to add
  301.       this function call to the beginning of the d4init function in
  302.       c4code.c.  This requires you to alter the source code, then 
  303.       to rebuild the DLL and its import library.  If you are using
  304.       CodeBase++ statically, then all you need to do is add the 
  305.       'SetHandleCount()' function call to your application program.         
  306.  
  307.          General outines of the patches provided by the more popular
  308.       compilers is provided below.  This includes MicroSoft C 6.00a
  309.       and 7.0, Borland C++ 3.1, Turbo C++ 3.0 / 3.1.
  310.  
  311.       Microsoft C patch:
  312.       ------------------
  313.  
  314.          By default, MicroSoft is hardcoded to only allow 20 file handles.  
  315.       This limit can be increased by altering the 'startup' code in 
  316.       MicroSoft C and is outlined in the 'readme.doc' file supplied with
  317.       MicroSoft C.
  318.  
  319.          You will need to alter the following files:
  320.  
  321.            _FILE.C      (source\startup)
  322.            crt0dat.asm  (source\startup\dos)
  323.       
  324.  
  325.            1.   _FILE.C :
  326.                            line 18  :  from :  #define _NFILE_ 20
  327.                                        to   :  #define _NFILE_ 100
  328.       
  329.                 crt0dat.asm :
  330.                            line 17  :  from :  _NFILE_ = 20
  331.                                        to   :  _NFILE_ = 100
  332.  
  333.            2.   If Microsoft C 6.0 is being used, also make the
  334.                 following changes:
  335.       
  336.                            line 259 :  (comment this line out)
  337.                            line 731 :  (comment this line out)
  338.                                        - these were commented out because of
  339.                                          an unresolved external. This didn't 
  340.                                          seem to affect the example.
  341.       
  342.                            line 319 - 321 :  (uncomment these lines)
  343.       
  344.            3.   Compile _FILE.C and crt0dat.asm :
  345.       
  346.                  cl -c -AL -W2 -Gsw -Owd _FILE.C
  347.                  masm -Mx -Dmem_L crt0dat.asm
  348.  
  349.            4.   The compiled .OBJs need to be put in the appropriate library.
  350.  
  351.                  DLL :     lib ldllcew-+_FILE;     
  352.                            lib ldllcew-+crt0dat;
  353.             
  354.                  NONDLL :  lib llibcew-+_FILE;
  355.                            lib llibcew-+crt0dat;
  356.       
  357.  
  358.  
  359.       Borland C++ 3.1 patch:
  360.       ----------------------
  361.  
  362.          This patch was obtained directly from Borland International Inc.
  363.       This patch involves changes to one file from the RTL ( Run-Time
  364.       Library ): _NFILE.H
  365.  
  366.       A change to this file affects these files: FILES.C and FILES2.C .    
  367.       Therefore, FILES.C and FILES2.C must be recompiled and re-linked.
  368.  
  369.          Please note that this fix has not been extensively tested
  370.       by Sequiter.       
  371.  
  372.  
  373.            1.   _NFILE.H:
  374.  
  375.                 // _NFILE.H
  376.                 // Copyright (C) 1992 Borland International, Inc.
  377.                 // All Rights Reserved
  378.  
  379.                 // Maximum number of open FILES
  380.                 #define _NFILE_ 20       /* change 20 to larger value */
  381.  
  382.                 //........................................................
  383.  
  384.  
  385.          You will now have to replace the files FILES.C and FILES2.C in
  386.       the standard library with the patched files.  You must first compile
  387.       FILES.C and FILES2.C.  You can do this as follows:
  388.  
  389.             bcc -c -mX FILES.C FILES2.C
  390.  
  391.      where the X in -mX is the memory model being used.  Each memory
  392.      model used must have these changes made to each repective memory model
  393.      library.
  394.  
  395.      eg.  For large model usage:
  396.  
  397.             bcc -c -ml FILES.C FILES2.C
  398.  
  399.  
  400.         Now link the new modules into the library.  For example, the large
  401.      model link would be:
  402.  
  403.  
  404.             tlib cX.lib -+FILES.OBJ -+FILES2.OBJ   
  405.             tlib cwX.lib -+FILES.OBJ -+FILES2.OBJ  
  406.  
  407.      where the X is the memory model being used.  Each memory
  408.      model used must have these changes made to each repective memory model
  409.      library.
  410.  
  411.      eg.  For large model usage:
  412.  
  413.             tlib cl.lib -+FILES.OBJ -+FILES2.OBJ   
  414.             tlib cwl.lib -+FILES.OBJ -+FILES2.OBJ  
  415.  
  416.  
  417.      Both of these lines should be executed.  'CL.LIB' is a Borland DOS   
  418.      library, and 'CWL.LIB' is a Borland Windows library.
  419.  
  420.         Once completed, you should now be able to open more than twenty
  421.      files.  
  422.  
  423.                   ------   END   ------
  424.  
  425.