home *** CD-ROM | disk | FTP | other *** search
/ PC Plus SuperCD (UK) 1996 May / PCPLUS115.ISO / dbasewin / readme.txt < prev   
Encoding:
Text File  |  1996-03-10  |  22.3 KB  |  493 lines

  1. PC Plus SuperCD - Issue 115 May 96
  2.  
  3. Imortant notes
  4. --------------
  5.  
  6. * dBASE 5.0 for Windows requires 6MB of RAM
  7.  
  8. * When you open the sample files included on the CD you may see a message stating that there is a mismatch with your language driver. You can safely ignore this message and continue.
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                     Welcome to dBASE for Windows
  15.                     ----------------------------
  16.  
  17. This file contains important, late-breaking information about dBASE for
  18. Windows, including updates to the printed documentation.
  19.  
  20. TABLE OF CONTENTS
  21. -----------------
  22. 1.  Configuration and System Requirements
  23. 2.  dBASE SpeedFilter Optimization
  24. 3.  Documentation Updates
  25. 4.  Compatibility Tips
  26. 5.  Common Support Questions & Answers
  27. 6.  Working with FoxPro Tables
  28. 7.  IDAPI Configuration Notes
  29. 8.  dBASE Magazines and Supporting Products 
  30. 9.  Acknowledgments
  31.  
  32. Three additional text files contain valuable information about working
  33. with dBASE for Windows:
  34.  
  35.    dBASESQL.TXT  in \DBASEWIN\BIN contains information about using Borland
  36.    SQL Links with dBASE for Windows.
  37.  
  38.    SAMPLES.TXT in \DBASEWIN\SAMPLES describes the sample program files.
  39.  
  40.    EXTERN.TXT in \DBASEWIN\SAMPLES\EXTERN describes the samples that
  41.    illustrate using the Extern System.
  42.  
  43. 1.  CONFIGURATION AND SYSTEM REQUIREMENTS
  44. -----------------------------------------
  45. System requirements:
  46.   - DOS 3.1 or higher
  47.   - Windows version 3.1
  48.   - 6 MB RAM required, 8 MB recommended
  49.   - 24 MB free disk space for a complete installation
  50.   - 10 MB free disk space for minimum installation
  51.  
  52. Supported Network Operating Systems:
  53.    Netware 3.11, 3.12, 4.01
  54.    Personal Netware (Novell DOS 7)
  55.    Banyan Vines 5.5
  56.    IBM LAN Server 3.0 *
  57.    MS LAN Manager 2.2
  58.    Lantastic 6.0
  59.  
  60.    * For proper operation of dBASE for Windows with LanServer 3.0, change
  61.    the following parameters in the DOSLAN.INI file on the workstation:
  62.       NBS: 4K
  63.       BBS: 5K
  64.  
  65. dBASE for Windows can be installed to a drive compressed with Stacker 4.0,
  66. and the data can be kept on the compressed drive. dBASE can be installed
  67. to a drive compressed with DOS 6.2 DblSpace, or DOS 6.22 DrvSpace, but the
  68. data must be kept on an uncompressed drive.
  69.  
  70. If you want to run the dBASE for Windows Interactive Tutors, and your
  71. machine has less than 12 MB of RAM, you should set the dBASE typeahead
  72. buffer to 1600. This can be done using the Desktop Properties dialog box.
  73.  
  74. To jump from Crystal Reports Help or Component Builder Help to dBASE
  75. Help, you must have the \DBASEWIN\BIN directory in your DOS path.
  76.  
  77. To open Crystal Reports Personal Trainer from within Crystal Reports
  78. Help, you must have the \DBASEWIN\CRYSTAL directory in your DOS path.
  79.  
  80. On a single machine, to access the same table concurrently using Sessions
  81. or multiple instances of dBASE for Windows, DOS SHARE.EXE must be loaded.
  82.  
  83. Also see section 7 of this README file, "IDAPI Configuration Notes."
  84.  
  85. 2. dBASE SpeedFilter OPTIMIZATION
  86. ---------------------------------
  87. dBASE SpeedFilters provide the fastest access to your dBASE tables. See
  88. the "About SpeedFilters" topic under "dBASE for Windows Basics" in
  89. the dBASE online Help file for more information.
  90.  
  91. 3.  DOCUMENTATION UPDATES
  92. -------------------------
  93. Getting Started/User's Guide updates
  94.  
  95.   See section 1 of this README file for an updated list of supported
  96.   networks.
  97.  
  98.   Navigator and Command Window changes: Double-clicking the Control menu
  99.   box or choosing File|Close minimizes these windows.
  100.  
  101.   The number of tables in a query is limited by the number of
  102.   work areas (225).
  103.  
  104.   To get context-sensitive help from the command line or while editing
  105.   programs, select the command, function, or other language element name
  106.   and press F1.  If the language element selected is fully spelled out,
  107.   the corresponding help topic appears.
  108.  
  109. Language Reference/Programmer's Guide updates
  110.  
  111.   Please consider online Help your most up-to-date source of
  112.   information on the dBASE language.
  113.  
  114.   The following language elements are not available in this release:
  115.     Copy() method (Array class); use ACOPY() instead
  116.     ReleaseOnClose property (Form class)
  117.     ScaleFontBold property (Form class)
  118.     ScaleFontItalic property (Form class)
  119.     ScaleFontStrikeOut property (Form class)
  120.     ScaleFontUnderline property (Form class)
  121.  
  122.   See online Help for updated information on the following function:
  123.  
  124.    MSGBOX() function - opens a dialog box that displays a message
  125.    and pushbuttons; returns a numeric value that corresponds
  126.    to the pushbutton the user chooses.
  127.  
  128.       Usage: MSGBOX(<message expC>, [<title expC>, [<box type expN>]])
  129.  
  130.   If you run code samples from the Language Reference manual or the
  131.   Programmer's Guide that show forms and controls, some controls may
  132.   appear misaligned onscreen. To adjust, switch to Design mode and realign
  133.   the controls, or adjust the values of the Top, Left, Height, and Width
  134.   properties accordingly.
  135.  
  136.   SET PRINTER TO FILE <filename> is identical to SET PRINTER TO <filename>.
  137.  
  138.   Event handlers you create for the Key event must return a numeric value
  139.   or a logical value. A numeric value is interpreted as the ASCII decimal
  140.   number of a character, which automatically replaces the character input
  141.   by the user. A logical value is interpreted as a decision to accept or
  142.   reject the character input by the user.
  143.  
  144.   The Shell function has been updated:
  145.  
  146.     SHELL() hides or displays the dBASE interactive environment or "shell"
  147.     when a form is open. It returns a logical value corresponding to the
  148.     previous SHELL() state. The dBASE shell consists of the interactive
  149.     components of the user interface, such as the Navigator, Command
  150.     window, application menu, SpeedBar, and the application window. By
  151.     default, the shell is on and SHELL() returns .T.
  152.  
  153.     Here is the syntax:  SHELL([<expL 1>][,<expL 2>])
  154.  
  155.     <expL 1> determines whether to hide or display the shell. If the
  156.     expression evaluates to .F., dBASE hides the shell.
  157.  
  158.     <expL 2> determines whether the dBASE application window remains
  159.     visible when the shell is off. If the expression evaluates to .T.,
  160.     the application window remains visible. If <expL 1> evaluates to
  161.     .T., the full shell is on and <expL 2> is ignored. If you open an
  162.     MDI form, the application window stays visible (to contain the
  163.     form) regardless of the <expL 2> value.
  164.  
  165.     When you display a form, you might want to prevent access to the
  166.     shell so the user can perform only the tasks intended by the
  167.     program. For instance, turning the shell off prevents the user
  168.     from opening a table with the Navigator or issuing a command in
  169.     the Command window. Use SHELL(.F.) to turn the shell off and
  170.     make a form look like a standalone application or to prevent
  171.     unwanted changes to data.
  172.  
  173.     Programmers typically issue SHELL(.F.) in a form's OnOpen procedure.
  174.     When all forms in a program are closed, the shell automatically
  175.     returns. You can also explicitly restore the shell with SHELL(.T.)
  176.  
  177.     The following table shows how the value of the two SHELL()
  178.     parameters and the form's MDI property affect the user interface.
  179.  
  180.     <expL1> <expL2>  MDI  Result
  181.     ------- -------  ---  ------------------------------------
  182.     .F.      must    .T.  The Navigator and Command window are
  183.              be           invisible. The dBASE application window
  184.              .T.          is visible (since MDI forms require a
  185.                           parent window, <expL 2> must be .T. when
  186.                           the form's MDI property is .T.). The
  187.                           dBASE application menu and SpeedBar are
  188.                           visible unless the form has a menu
  189.                           associated with it. If the form has a
  190.                           menu, the menu appears in the dBASE
  191.                           application window in place of the dBASE
  192.                           application menu and SpeedBar.
  193.  
  194.     .F.     .F.      .F.  The dBASE application window is
  195.                           invisible and only the form appears. The
  196.                           form name also appears in the Windows
  197.                           Task List in place of dBASE.
  198.  
  199.     .F.     .T.      .F.  The dBASE application window is visible and
  200.                           the form appears in a separate window.
  201.                           The dBASE application menu and SpeedBar
  202.                           are visible, but the Navigator and
  203.                           Command window are not.
  204.  
  205.     .T.     ignored  .T.  The shell is active. If you open the
  206.                       or  form with Open(), the user can access
  207.                      .F.  the Navigator, Command window, SpeedBar
  208.                           or menu while the form is open. If you
  209.                           open the form with ReadModal(), the
  210.                           dBASE interface is visible but
  211.                           inaccessible until the form is closed.
  212.  
  213. 4.  COMPATIBILITY TIPS
  214. ----------------------
  215.    Declaring a variable PRIVATE that is in use as the screen
  216.    name for SAVE SCREEN TO <screen name> returns the run-time error
  217.    "Variable undefined: <screen name>". dBASE for Windows handles
  218.    <screen name> differently than dBASE IV; it creates <screen name>
  219.    as a PUBLIC memory variable.
  220.  
  221.    dBASE for Windows does not run dBASE IV Label and Report binary
  222.    files (.LBL and .FRM). Use the Component Builder to convert them
  223.    to Crystal Reports files (.RPL and .RPT). dBASE IV .LBG and .FRG label
  224.    and report files may be run as source code.
  225.  
  226.    dBASE IV queries that contain sort instructions cannot be used by
  227.    the Component Builder and Crystal Reports for dBASE. In the case of
  228.    QBEs that SORT, please see A11 in the Common Support Questions &
  229.    Answers section below.
  230.  
  231.    To honor Windows keystroke behavior, Ctrl+Home and Ctrl+End no longer
  232.    open and close memo fields. Use F9 to open them; use F9, Ctrl+W, or
  233.    <Esc> to close them.
  234.  
  235.    F9 and double-click are used to open memo, OLE, and binary fields
  236.    in dBASE for Windows. If your application uses the ON KEY LABEL F9
  237.    <command> to redefine F9 for these fields, double-click on the icons
  238.    to open them.
  239.  
  240.    The SET STATUS ON/OFF command is not supported (returns a warning) in
  241.    dBASE for Windows. However, you may still use the Application page of
  242.    the Desktop Properties dialog box to turn the status bar on or off.
  243.    You can also do this via the DBASEWIN.INI file, by changing the
  244.    setting of StatusBar to OFF or ON in the Desktop section. This must be
  245.    done before starting dBASE for Windows.
  246.  
  247.    APPEND FROM ARRAY will require matching data types between the array 
  248.    element and the corresponding field in the table. This is not required 
  249.    in dBASE for DOS.
  250.  
  251.    dBASE for Windows does not support dBASE IV PLAY MACRO, SAVE MACROS,
  252.    or RESTORE MACROS commands. dBASE IV MACRO.KEY files must be 
  253.    converted to a Windows macro format or reprogrammed under 
  254.    dBASE for Windows as functions.
  255.  
  256.    When installed on a standalone machine, dBASE for Windows does not
  257.    change the default for SET EXCLUSIVE to on; dBASE IV does. Because of
  258.    this, you might want to SET EXCLUSIVE ON at the top of dBASE IV DOS
  259.    applications that require exclusive use of tables.
  260.  
  261.    In dBASE for Windows, a new return value has been added to the
  262.    READKEY() function to indicate that no update has occurred.
  263.    READKEY() returns 14 if an unchanged record is left by pressing
  264.    Ctrl+W or Ctrl+End.
  265.   
  266.    dBASE for Windows uses SET DELETED ON as the default setting. If
  267.    you want the default to be OFF you must go to the Tables page of the
  268.    Desktop Properties dialog box to set the default to either on or off.
  269.    Another way of doing this is in the DBASEWIN.INI file, where you can
  270.    change the setting of DELETED to OFF or ON in the "OnOffCommandSettings"
  271.    section.  This must be done before starting dBASE for Windows.
  272.  
  273. 5.  COMMON QUESTIONS & ANSWERS
  274. ------------------------------
  275. Q1:  How much hard disk space do I need to install dBASE for Windows?
  276.  
  277. A1:  Full Installation requires 24 MB. If space is a problem, select
  278. Custom Installation and omit the options you don't need. Minimum
  279. Installation requires 10 MB of hard disk space. In addition, you should
  280. have 1.5 MB of free drive space on the drive/partition where Windows is
  281. installed (if installing on a different drive/partition). When using a
  282. compressed drive, allow a plus 20 percent margin.
  283.  
  284. Q2:  The Getting Started book says 6 MB of RAM is required (8 MB
  285. preferred). Will dBASE for Windows run on a 4MB machine?
  286.  
  287. A2:  A 4 MB RAM machine has 3 MB of extended memory available before
  288. anything else is loaded into extended memory. Running Windows 3.1
  289. requires SMARTDRIVE to be installed which typically takes 1 MB of extended
  290. memory. The 2 MB of extended memory remaining is then used by Windows in
  291. conjunction with a (Windows) swap file created on your hard drive. All
  292. your Windows programs will be sharing this limited resource. dBASE for
  293. Windows will likely run on this environment but with reduced performance.
  294. The product is recommended for machines that have the specified (6 MB or
  295. more) amount of RAM.
  296.  
  297. Q3:  How do I access these Windows memory management controls?
  298.  
  299. A3: a) Choose the Windows Control Panel.
  300.     b) Choose 386 Enhanced.
  301.     c) Click the Virtual Memory pushbutton.
  302.     d) Click the Change pushbutton.
  303.     e) Choose "Permanent Swap File".
  304.     f) Increase the value of the New Size option.
  305.     g) Consult your Windows documentation for further information.
  306.  
  307. Q4:  Can dBASE IV and 5.0 for DOS and dBASE 5.0 for Windows be installed
  308. on the same machine? Which one will start when I issue the dBASE command
  309. at DOS with dBASE in my PATH?
  310.  
  311. A4:  dBASE for DOS, (dBASE IV or dBASE 5.0) starts by calling DBASE.EXE.
  312. dBASE for Windows has an executable file named DBASEWIN.EXE. The command
  313. DBASE, issued at DOS, will execute dBASE for DOS.  The command DBASEWIN,
  314. issued at DOS, will give you a DOS error "Not a DOS Program." You must
  315. start Windows first. The command WIN DBASEWIN from DOS will start dBASE
  316. for Windows. Typically dBASE for Windows will be run from the Program
  317. Manager in Windows.
  318.  
  319. Q5:  All my old data files (.DBF, .DBT, .MDX, .QBE, .FMT, .FRG, etc.) are
  320. located on my C:\DBASE or C:\DBASE\DATA subdirectory. Do I have to move
  321. them to the DBASEWIN directory?
  322.  
  323. A5:  Subdirectory selection is easy from the Navigator in dBASE for
  324. Windows. Enter the correct path in the entry field or click the file
  325. icon to select a new directory. Files in various directories can also
  326. be organized in a catalog. When running dBASE for Windows, it is ok to
  327. change the current directory to a directory on which dBASE for DOS is
  328. installed to access data files.
  329.  
  330. Q6:  Where can I get more examples on programming with dBASE for Windows?
  331.  
  332. A6:  Additional samples and example source code are available in the dBASE
  333. for Windows forum on CompuServe.
  334.  
  335. Q7:  As a dBASE DOS user, sessions are new to me. Where can I get more
  336. information about how these work?
  337.  
  338. A7:  See the "About Sessions" topic under "dBASE for Windows Basics" in
  339. the dBASE online Help system. An article is also available on the
  340. Borland TechFax machine; obtain a catalog at 1-800-822-4269.
  341.  
  342. Q8:  I get the error "In use by another" when I am accessing tables in a
  343. standalone environment. What does this mean?
  344.  
  345. A8:  dBASE for Windows installs with "Set Exclusive = On" which only
  346. allows the table to be opened once. Although you are accessing the table
  347. in a standalone environment, file access in Windows is similar to
  348. accessing files on a network in that files can be accessed multiple times.
  349. In order to remedy this, use the setting in the Desktop Properties menu to
  350. "Set Exclusive = Off". To do this, choose Properties|Desktop, click the
  351. Table tab, and uncheck the "Exclusive" box.
  352.  
  353. Q9:  When starting dBASE for Windows, I receive the error "Buttons.cc not
  354. found", however, this file is located on my network drive. What do I need
  355. to change in my configuration?
  356.  
  357. A9:  Edit your DBASEWIN.INI file, usually located in your \DBASEWIN\BIN
  358. directory, and make sure the line that reads "Procedure =" has the proper
  359. path to the location of your BUTTONS.CC file. This file should be located
  360. in your \DBASEWIN\SAMPLES directory. Then restart dBASE for Windows.
  361.  
  362. Q10:  I have a large application written in dBASE IV 2.0, what do I need to
  363. do to run this application in dBASE for Windows?
  364.  
  365. A10:  You can run your program from the Command window, however, your
  366. program will only be displayed in the results pane. You can convert your
  367. code to Windows type code using the Component Builder included with dBASE
  368. for Windows. For further information on using the Component Builder, load
  369. the Component Builder by clicking its icon and see the Conversion
  370. Guidelines in the Component Builder online Help file.
  371.  
  372. Q11:  When I run or design a report based on a sorted Query, my fields
  373. disappear from the report. How do I see my fields?
  374.  
  375. A11:  This is because the sorted query creates a temporary file with a
  376. unique name, each time the query is executed. We recommend that you
  377. perform the sort in the report designer. Alternately, you can edit
  378. the query as a program and change the variable assignment of SORT___001
  379. to a unique specific file name like SORT___001 = "NEW" and delete the
  380. rest of the line. You should add a line, SET SAFETY OFF, before the
  381. variable assignment, and add a line at the end of the QBE, SET SAFETY
  382. ON. Now you are ready to build a new report on this query. More
  383. complete details are available on the Borland TechFax machine; obtain a
  384. catalog at 1-800-822-4269.
  385.  
  386. 6.  WORKING WITH FoxPro TABLES
  387. ------------------------------
  388. dBASE for Windows can open, read, and write to FoxPro tables as follows:
  389.    .DBF - FoxPro table file
  390.    .CDX - FoxPro multiple index file
  391.    .FPT - FoxPro table memo file
  392.  
  393.    1.  If the table has no production index, memo field, or general field,
  394.        dBASE for Windows will open it and read and write data to it.
  395.  
  396.    2.  If the table has a production index (.CDX), you have an option to
  397.        open it read-only, which ignores the .CDX file, or create a new
  398.        .MDX file with the same index tags as are in the .CDX file.
  399.  
  400.    3.  If the table has a memo field or general field (.FPT), you have the
  401.        option to open it, and read and write to it, as a non-dBASE table.
  402.        If the table has a general field with OLE documents in them, dBASE
  403.        for Windows can read and write them.
  404.  
  405.        You can also open the table and convert the memo or general field
  406.        (.FPT) to the dBASE .DBT format. If you convert it, the original
  407.        .FPT file is deleted, so you should make a backup of the table
  408.        before converting.
  409.  
  410. 7.  IDAPI CONFIGURATION NOTES
  411. -----------------------------
  412.    Your DBASEWIN.INI file lets you specify a default IDAPI 
  413.    configuration file to use whenever dBASE is started. However, if 
  414.    another IDAPI-based product is already running when you start dBASE 
  415.    for Windows, dBASE will use the IDAPI configuration file that is
  416.    already active.
  417.  
  418.    Choose the IDAPI Configuration Utility icon from Windows Program
  419.    manager to edit the configuration file. When you open the utility it
  420.    will display the IDAPI.CFG specified in the IDAPI section of the
  421.    WIN.INI file. If dBASE is using a different configuration file and you
  422.    want to change those parameters, you must use File|Open to explicitly
  423.    open that file.
  424.  
  425.    During installation, if an ODAPI configuration file exists on your
  426.    machine, its settings will be read into the new IDAPI configuration
  427.    file. This will set the dBASE file level to 4 (the old level). To
  428.    use the new dBASE for Windows field types, you will need to set this
  429.    to 5. This can be done using the IDAPICFG utility.
  430.  
  431.    On a single machine, LOCALSHARE must be TRUE to use both dBASE for
  432.    Windows and other non-IDAPI products that access a table at the same
  433.    time.
  434.  
  435.    If you are using Paradox tables or executing a SQLEXEC() on a shared
  436.    drive (network), you must enter a valid path into the NET DIR
  437.    setting for the Paradox driver in the IDAPI.CFG. See the instructions
  438.    above on how to use the IDAPI Configuration Utility.
  439.  
  440. 8.  dBASE MAGAZINES AND SUPPORTING PRODUCTS
  441. -------------------------------------------
  442.    a) Regular guidance on using dBASE for Windows is available in "dBASE
  443.    Advisor Magazine" and "Inside dBASE for Windows."
  444.  
  445.      dBASE Advisor Magazine
  446.      In the US call 1-800-336-6060
  447.      From outside the US call 1-619-483-6400
  448.      From CompuServe type "GO DB"
  449.  
  450.      Inside dBASE for Windows
  451.      The Cobb Group
  452.      PO Box 35160
  453.      Louisville KY 40232-9719 USA
  454.  
  455.    b) Training videos developed by Borland International are available
  456.    from your local Borland representative. Two are available for dBASE
  457.    for Windows:
  458.  
  459.      Developing Applications with dBASE 5.0 for Windows (90 mins,
  460.      9 lessons)
  461.  
  462.      Learning dBASE 5.0 for Windows (60 mins, 6 lessons)
  463.  
  464.    c) Borland Visual Solutions Pack Volume 1, version 1.1 is a set of
  465.    Visual Basic Custom Controls that you can add as components to your
  466.    applications developed with dBASE for Windows. These controls let
  467.    you instantly add components such as spreadsheets, word processors,
  468.    images, gauges and many other objects to your forms. For more
  469.    information contact your local Borland representative.
  470.  
  471.    d) ForeHelp is a visual Windows Help file designer. This add-on from
  472.    ForeFront Inc. facilitates developing Windows help files. Contact
  473.    your local Borland representative for information on how dBASE
  474.    for Windows customers can purchase this at a special price.
  475.  
  476.    e) Training courses are available in a variety of locations; please
  477.    contact your local Borland representative for a list of training
  478.    companies in your area.
  479.  
  480. 9.  ACKNOWLEDGMENTS
  481. -------------------
  482. Some of the sound files were provided by Programmer's Warehouse from Sound
  483. Explosion for Windows. Copyright (c) 1992-1994 Programmer's Warehouse.
  484. All rights reserved. Licensed sounds Copyright (c) 1990-1992 The
  485. Hollywood Edge.
  486.  
  487. Sample music database provided by AudioFile, providers of current
  488. information for the retail music industry. Product listed in this
  489. database is available through Sound Delivery, 1280 Santa Anita Court,
  490. Woodland, CA 95776.
  491.  
  492. Sampled music provided by Southern Library of Recorded Music, 6777
  493. Hollywood Boulevard, Los Angeles, CA 90028, (213) 469-9910.