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