home *** CD-ROM | disk | FTP | other *** search
Text File | 1990-10-15 | 59.2 KB | 1,629 lines |
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- PopDBF (tm)
- "Instant Access to dBASE Files"
- Copyright (c) 1988-1990
- Bowen Software
-
-
- By: Don Bowen
- Member of the Association of Shareware Professionals
-
-
-
- ┌─────────┐
- ┌─────┴───┐ │ (tm)
- ──│ │o │──────────────────
- │ ┌─────┴╨──┐ │ Association of
- │ │ │─┘ Shareware
- └───│ o │ Professionals
- ──────│ ║ │────────────────────
- └────╨────┘ MEMBER
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Table of Contents
-
-
-
-
- 1 Introduction . . . . . . . . . . . . . . . . . . . . . . . 1
- 1.1 Copyright and Registration Information . . . . . . 1
- 1.2 How to Register . . . . . . . . . . . . . . . . . . 1
- 1.3 Association of Shareware Professionals . . . . . . 2
- 1.4 How to Contact Bowen Software . . . . . . . . . . . 2
- 1.5 Software Support . . . . . . . . . . . . . . . . . 3
- 1.6 Trademark Acknowledgements . . . . . . . . . . . . 3
- 1.7 Disclaimer and Warranty . . . . . . . . . . . . . . 3
-
- 2 Getting Started . . . . . . . . . . . . . . . . . . . . . 4
- 2.1 Description . . . . . . . . . . . . . . . . . . . . 4
- 2.2 Limitations . . . . . . . . . . . . . . . . . . . . 4
- 2.3 Cautions . . . . . . . . . . . . . . . . . . . . . 4
- 2.4 Installing PopDBF Files on Your Hard Disk . . . . . 5
- 2.5 Modifying AUTOEXEC.BAT to Load PopDBF . . . . . . . 5
- 2.6 How to Invoke PopDBF (Using the "Hotkey") . . . . . 6
- 2.7 Command Line Options . . . . . . . . . . . . . . . 6
- /A<A|B|E|S> Default action . . . . . . . . . . . 6
- /C<C|M|O> Color scheme . . . . . . . . . . . . 6
- /D<dir> Initial PopDBF Directory . . . . . . 6
- /E<size> Edit buffer of size bytes . . . . . 7
- /F<num> Maximum of num fields . . . . . . . 7
- /H Command line syntax/options . . . . 7
- /O Use old keyboard bios calls . . . . 7
- /[!]P[file] Use "passthru" non-resident mode . . 8
- /R<size> Read buffer of size bytes . . . . . 8
- /S Enable snow checking . . . . . . . . 8
- /T<B,C,I,W> Toggle indicator defaults . . . . . 9
- /U Uninstall (remove) from memory . . . 9
- /Z Zoom the Browse window . . . . . . 10
-
- 3 Help . . . . . . . . . . . . . . . . . . . . . . . . . . 11
- 3.1 Generic Help (Alt-F1) . . . . . . . . . . . . . . 11
- 3.2 Context Sensitive Help (F1) . . . . . . . . . . . 11
-
- 4 Alt Menu (Alt) . . . . . . . . . . . . . . . . . . . . . 12
- 4.1 Alt Action Keys . . . . . . . . . . . . . . . . . 12
- 4.2 Alt Toggle Keys . . . . . . . . . . . . . . . . . 12
- 4.3 Toggle Indicator Summary . . . . . . . . . . . . 13
-
- 5 Pick File (Alt-P) . . . . . . . . . . . . . . . . . . . 14
- 5.1 Select Directory/File/Index (Enter) . . . . . . . 14
- 5.2 Move to Parent Directory (BackSpace) . . . . . . 14
- 5.3 Change Directory and/or Drive (F2) . . . . . . . 14
- 5.4 Enter A Specific File (F3) . . . . . . . . . . . 14
- 5.5 Change File Specification (F4) . . . . . . . . . 15
-
- i
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Table of Contents
-
-
-
- 5.6 Change Default Action (F5) . . . . . . . . . . . 15
- 5.8 Move to Current DOS Drive & Directory (F10) . . . 15
- 5.9 Frequent Database Access (Alt-1 thru Alt-=) . . . 15
-
- 6 View Structure (Alt-S) . . . . . . . . . . . . . . . . . 17
- 6.1 Number/Un-Number Fields (Space) . . . . . . . . . 17
- 6.2 Clear Field Numbers (F2) . . . . . . . . . . . . 17
- 6.3 Assign a Specific Field Number (F3) . . . . . . . 17
- 6.4 Order Fields Using Field Numbers (F4) . . . . . . 17
- 6.5 Tag/Un-Tag Field for Exclusive Find (F6) . . . . 17
- 6.6 Clear Exclusive Find Tags (F7) . . . . . . . . . 18
- 6.7 Copy Structure (F8) . . . . . . . . . . . . . . . 18
- 6.8 Print the File Structure (F9) . . . . . . . . . . 18
-
- 7 Browse Records (Alt-B) . . . . . . . . . . . . . . . . . 19
- 7.1 Current Record and Delete Status . . . . . . . . 19
- 7.2 Pan the Browse Window ( / ) . . . . . . . . . . . 19
- 7.3 View Large Fields (Tab/Shift-Tab) . . . . . . . . 19
- 7.4 Zoom the Browse Window (F2) . . . . . . . . . . . 19
- 7.5 Goto a Specific Record (F3) . . . . . . . . . . . 19
- 7.8 Find Text (F7) . . . . . . . . . . . . . . . . . 20
- 7.9 Find Next Occurrence of Text (F8) . . . . . . . . 20
- 7.10 Print Records (F9) . . . . . . . . . . . . . . . 21
- 7.11 Turn Century On/Off (Ctrl-C) . . . . . . . . . . 21
- 7.12 Mark Record as Deleted (Ctrl-U) . . . . . . . . 21
-
- 8 Edit/Append Records (Alt-E/Alt-A) . . . . . . . . . . . 22
- 8.1 Copy a Record (F2) . . . . . . . . . . . . . . . 22
- 8.2 Goto a Specific Record (F3) . . . . . . . . . . . 22
- 8.3 Find Text (F7) . . . . . . . . . . . . . . . . . 22
- 8.4 Find Next Occurrence of Text (F8) . . . . . . . . 22
- 8.5 Field Information (F10) . . . . . . . . . . . . . 22
- 8.6 Turn Century On/Off (Ctrl-C) . . . . . . . . . . 22
- 8.7 System Date (Ctrl-D) . . . . . . . . . . . . . . 22
- 8.8 Move to Last Field Position (Ctrl-E) . . . . . . 23
- 8.9 Restore Field Data (Ctrl-F) . . . . . . . . . . . 23
- 8.10 Abort and Lose Changes (Ctrl-Q/Esc) . . . . . . 23
- 8.11 Restore Entire Record (Ctrl-R) . . . . . . . . . 23
- 8.12 Mark Record as Deleted (Ctrl-U) . . . . . . . . 23
- 8.13 Quit and Save Changes (Ctrl-W/Ctrl-End) . . . . 23
- 8.14 Blank Current Field (Ctrl-Y) . . . . . . . . . . 23
- 8.15 Blank to End of Field (Ctrl-Delete) . . . . . . 23
- 8.16 Move to End of Data (End) . . . . . . . . . . . 24
- 8.17 Move to First Position (Home) . . . . . . . . . 24
- 8.18 Move Word (Ctrl- /Ctrl- ) . . . . . . . . . . . 24
- 8.19 Move to First/Last Field (Ctrl- /Ctrl- ) . . . . 24
-
-
- ii
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Introduction
-
-
- 1 Introduction
-
- 1.1 Copyright and Registration Information
- PopDBF, its documentation and supplementary files and programs
- are Copyright (c) 1989-90 Bowen Software. All rights reserved
- worldwide.
-
- PopDBF is not now, nor was it ever, public domain or free
- software. PopDBF is currently available in shareware and
- commercial versions.
-
- You are granted a limited license to use PopDBF.
-
- Non-registered users are granted a limited license for 21 days
- only. After 21 days if you continue to use PopDBF you MUST
- register it. Use of PopDBF after the 21 day trial period
- violates Bowen Software's license.
-
- Under no circumstances shall any other person or business profit
- from the sale of this program, other than to distribute the
- program in a shareware library, unless previously approved by
- Bowen Software in writing. Distributors MUST read and abide by
- the accompanied VENDOR.DOC file, which explains Bowen Software's
- distribution policy.
-
- 1.2 How to Register
- Registration of PopDBF is mandatory for commercial and government
- users.
-
- To register your copy of PopDBF, send your registration fee,
- payable in US funds (see ORDER.FRM), to:
-
- Bowen Software
- P.O. Box 2134
- East Peoria, Illinois 61611
-
- You can order by sending check, cash or money order to Bowen
- Software at the address listed above. You can also register with
- MC, Visa, Amex, or Discover from the Public (software) Library
- (PsL) by calling 1-800-2424-PsL or 713-524-6394 or by FAX to
- 1-713-524-6398 or by CIS Email to 71355-470. These numbers are
- for ORDERS ONLY. To insure that you get the latest version, PsL
- will notify us the day of your order and we will ship the product
- directly to you. Any questions about the status of the shipment
- of the order, refunds, product details, technical support, volume
- discounts, dealer pricing, site licenses, etc, must be directed
- to Bowen Software at 309-699-0950. You can also mail credit card
-
-
- Copyright (c) 1989-90 Bowen Software Page 1
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Introduction
-
-
- orders to PsL at P.O.Box 35705, Houston, TX 77235-5705. There is
- an additional $5 charge for using this service.
-
- PopDBF must be registered for EACH USER at your site;
- alternatively, contact Bowen Software for current SITE LICENSE
- information.
-
- Registered users are provided services and software not available
- to the non-registered user. Registered users are notified of
- program updates and provided the first update FREE! Also, the
- registered version of PopDBF does NOT contain the registration
- information screen, which pops up on the screen at each
- invocation of PopDBF.
-
- FREE!! -- when you register, you are entitled to a free
- introductory subscription to CompuServe Information Service - the
- biggest national BBS! You will receive: a private user ID number
- and Password, a $15 usage credit (over 1 hour connect time at
- 2400 baud), a complimentary subscrition to CompuServes's monthly
- computing magazine: 'Compuserve'. If you are registered, please
- see the file CIS.$15 on the diskette for directions.
-
- 1.3 Association of Shareware Professionals
- Bowen Software is a member of the Association of Shareware
- Professionals (ASP). ASP wants to make sure that the shareware
- principle works for you. If you are unable to resolve a
- shareware-related problem with an ASP member by contacting the
- member directly, ASP may be able to help. The ASP Ombudsman can
- help you resolve a dispute or problem with an ASP member, but
- does not provide technical support for members' products. Please
- write to the ASP Ombudsman at P.O. Box 5786, Bellevue, WA 98006
- or send a Compuserve message via Easyplex to ASP Ombudsman
- [70007,3536].
-
- 1.4 How to Contact Bowen Software
- Bowen Software shareware products have their home on the Exec-PC
- bulletin board located in Milwaukee, Wisconsin. The Exec-PC
- phone number is (414) 789-4210. Electronic messages can be left
- on Exec-PC and should be addressed to Don Bowen. This is also
- where you can find the latest version of PopDBF and other
- programs by Bowen Software.
-
- You can also contact Bowen Software by leaving messages on
- Compuserve, where our number is 76665,736. The latest version of
- PopDBF can be found on Compuserve in the IBMAPP forum DL 3.
-
- Contacting us using the above two methods is preferred. If you
- do not have access to electronic communication you can contact us
-
- Copyright (c) 1989-90 Bowen Software Page 2
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Introduction
-
-
- by phone at (309) 699-0950. Messages are usually returned within
- 24 hours.
-
- The cheapest way to ask questions or make suggestions is by mail.
- Send inquiries or recommendations to:
-
- Bowen Software
- P. O. Box 2134
- East Peoria, IL 61611
-
-
- 1.5 Software Support
- Registered and commercial users are provided free phone support
- for six months. No support is guaranteed for non-registered
- users, but we are happy to answer questions about our products
- and consulting services. Bowen Software can be reached at (309)
- 699-0950. Registered users will be asked for their serial
- number.
-
-
- 1.6 Trademark Acknowledgements
- CLIPPER is a trademark of Nantucket Corporation.
- COMPAQ is a registered trademark of COMPAQ Computers, Inc.
- dBASE and dBASE III are registered trademarks of Ashton Tate,
- Inc.
- dBASE III Plus and dBASE IV are trademarks of Ashton Tate, Inc.
- FoxBASE+ is a registered trademark of Fox Software, Inc.
- FoxPro is a trademark of Fox Software, Inc.
- PopDBF is a trademark of Bowen Software.
- Quicksilver is a trademark of Wordtech Systems, Inc.
- Sidekick is a trademark of Borland International, Inc.
-
- 1.7 Disclaimer and Warranty
- This software is provided "as is" without any warranty of any
- kind, either expressed or implied, including, but not limited to,
- the implied warranties of merchantability and fitness for a
- particular purpose. The entire risk as to the quality and
- performance of the software is with you. Should the software
- prove defective, the user, NOT Bowen Software, assumes the entire
- cost of all necessary servicing, repair or correction.
-
- In no event shall Bowen Software be liable to the user for any
- damages, including lost profits, lost savings or other incidental
- or consequential damages arising out of the use or inability to
- use this software, even if Bowen Software has been advised of the
- possibility of such damages, or for any claim by any other party.
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 3
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- 2 Getting Started
-
- 2.1 Description
- PopDBF is a memory resident program that will give you "instant
- access" to Clipper, dBASE III Plus, dBASE IV, FoxBASE+, FoxPro
- and Quicksilver (or any other dBASE compatible) files from
- anywhere at the press of the hotkey (Alt-BackSpace). It provides
- an easy way to move throughout your hard disk(s) and find your
- database files. It also has context sensitive help for novice
- (or forgetful) users.
-
- You can use PopDBF to:
-
- ■ pick a database file
- ■ delete a (database) file
- ■ view file structure
- ■ print file structure
- ■ browse records
- ■ delete records
- ■ print records
- ■ search for strings anywhere in a database
- ■ append and edit records
- ■ pack and zap a database
- ■ specify fields and assign their order for the above
- features
- ■ view index expressions of index files
-
- PopDBF has four main areas, Pick File, View Structure, Browse
- Records, and Edit/Append Records. These areas are described more
- fully below along with the actions available from each.
-
- 2.2 Limitations
- Though PopDBF has many features, it does not do everything, yet!.
-
- Currently PopDBF does not do the following:
-
- ■ install itself in extended memory (v3.8).
- ■ allow two or more users on a network to access the same
- file
- ■ view or edit memo fields
- ■ use index files (it does display the expression used to
- create them)
- ■ view more than one database file at a time.
- ■ handle database files with more 65,535 records.
- ■ handle fields larger than 1080 characters.
-
- 2.3 Cautions
-
-
- Copyright (c) 1989-90 Bowen Software Page 4
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- When using PopDBF from within any product that allows editing of
- dBASE compatible files, like dBASE, it is important to remember
- that most of those products do internal record buffering. This
- means that if a record is changed in dBASE and resides in a dBASE
- internal buffer, it will NOT reflect that change when viewed from
- within PopDBF.
-
- Likewise, if a record is changed in PopDBF while that same record
- is in an internal dBASE buffer, the change will be overwritten by
- dBASE when it closes the file and/or flushes the internal buffer.
-
- As a general rule, do not change records in a database that might
- be opened by dBASE or any of its compatibles.
-
- 2.4 Installing PopDBF Files on Your Hard Disk
- To load the PopDBF files on your hard disk do the following:
-
- ■ Place the PopDBF diskette in drive A:
-
- ■ Type A:INSTALL [d:\path\]directory and press RETURN.
- directory is the directory and optional drive and path,
- where you want the PopDBF program and files installed.
- If you don't specify a directory it will default to
- C:\POPDBF.
-
- When PopDBF is executed it assumes that POPDBF.HLP, the context
- sensitive help file, is in the same directory as POPDBF.COM. If
- POPDBF.HLP is not in that directory, it will not function. See
- "Help" on page 11.
-
- 2.5 Modifying AUTOEXEC.BAT to Load PopDBF
- To load PopDBF at boot time, add the following line to your
- AUTOEXEC.BAT file:
-
- .
- [path\]POPDBF [options] <load PopDBF into memory>
- .
-
- If the optional path is not specified, POPDBF.COM must either be
- in the current directory or in the PATH.
-
- For help on which options to use when loading PopDBF see "Command
- Line Options" on page 6.
-
- You can conserve memory by loading PopDBF (or any other memory
- resident program) before doing any PROMPT, PATH or SET commands.
- For additional memory saving tips see /E, /F, and /R under
- "Command Line Options" on page 6.
-
- Copyright (c) 1989-90 Bowen Software Page 5
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- PopDBF does not need to be the last memory resident program.
- However, it can NOT be uninstalled from memory if it isn't the
- last memory resident program or if another memory resident
- program has recaptured one of PopDBF's interrupts.
-
- 2.6 How to Invoke PopDBF (Using the "Hotkey")
- By default the hotkey to invoke PopDBF is Alt-BackSpace. To
- invoke PopDBF, press and hold the Alt key and at the same time
- press the BackSpace key. The commercial version includes a
- program that will allow you to change this default.
-
- As soon as you press the PopDBF hotkey, the PopDBF program will
- "pop" onto the screen. Pressing the hotkey again will take you
- right back to the interrupted program. You can "hotkey" out of
- PopDBF from anywhere in the program, except a few places when you
- are being prompted for information. At those times, pressing the
- hotkey will abort that action just as if you had pressed Esc.
-
- When you press the hotkey to leave PopDBF, any open database is
- closed. Pressing the hotkey again will return you to the same
- location in PopDBF with the file being opened automatically as if
- it had never been closed. You can even hotkey out and back while
- in the middle of using Edit or Append!
-
- 2.7 Command Line Options
- To load or execute PopDBF type the following at the DOS prompt:
-
- PopDBF [options], where options can be:
-
- /A<A|B|E|S> Default action, where:
-
- A>ppend <B>rowse E>dit S>tructure
-
- /C<C|M|O> Color scheme, where:
-
- <C>urrent M>ononchrome O>riginal
-
- The original colors option is provided for those
- people who liked the colors used in versions
- before 3.7.
-
- /D<dir> Initial PopDBF Directory
-
- The format of <dir> is [d:\]path, where d: is the
- optional drive identifier.
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 6
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- The initial PopDBF directory is set to the current
- DOS directory the first time PopDBF invoked, if
- this option is not specified.
-
- The PopDBF directory changes only when a move is
- made from within PopDBF. Each time PopDBF is
- invoked, the current DOS directory is saved and
- the PopDBF directory becomes the current
- directory. When leaving PopDBF the DOS directory
- is restored. See also "Move to Current DOS
- Directory" on page 15.
-
- /E<size> Edit buffer of size bytes (default = 512)
-
- If a file has a record size larger than the edit
- buffer size, you will not be allowed to Edit or
- Append.
-
- You can conserve memory by specifying a buffer
- size as small as 0. However, if the buffer is too
- small you will not be allowed to Edit or Append.
-
- /F<num> Maximum of num fields (default = 64)
-
- The default value should handle most needs,
- however Clipper databases can have up to 1024
- fields.
-
- The maximum number of fields also determines the
- maximum number of files that the Pick File window
- can display. To calculate the maximum number of
- files, multiply the maximum number of fields by 20
- and divide by 14. The default is 91 (64 x 20 / 14
- = 91).
-
- You can conserve memory by specifying less than
- the default number of fields. The savings is 21
- bytes per field.
-
- /H Command line syntax/options
-
- /O Use old keyboard bios calls
-
- There are a few machines that are capable of
- supporting an extended 101/102 key keyboard, but
- have an old 88 key keyboard attached. Use this
- option if this is your hardware setup.
-
-
- Copyright (c) 1989-90 Bowen Software Page 7
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- /[!]P[file] Use "passthru" non-resident mode
-
- This option will NOT load PopDBF into memory, but
- will execute it and allow you to use all of its
- features.
-
- If a file is also specified (no brackets are
- necessary), PopDBF will automatically come up in
- Browse, unless the /A option is used to specify a
- different action.
-
- Passthru mode is indicated on the screen by the
- word "PASSTHRU" in the upper left-hand corner.
- The /P option can also be used even if PopDBF is
- already in memory. Pressing the PopDBF hotkey
- will cause the resident version to pop up over the
- passthru version.
-
- Preceeding the P with an exclamation point (!)
- will cause PopDBF to exit when ESC is pressed from
- append, browse, edit, or structure. This is a
- nice feature to use from batch files.
-
- /R<size> Read buffer of size bytes (default = 4096)
-
- If a file's record size is larger than the read
- buffer size, you will not be allowed to Browse the
- file.
-
- The larger the read buffer the faster scrolling
- and finding will be done when in Browse and Edit.
-
- You can conserve memory by specifying a buffer
- size as small as 512 (this is the minimum).
- However, in doing so you may only be able to view
- the structure of some files. If the specified
- buffer is small than the size of one record you
- will not be allowed to Browse, Edit or Append the
- database.
-
- /S Enable snow checking
-
- Older color graphic adapters (CGA) produce snow or
- sparkle when accessing video memory directly.
- PopDBF gets some of its speed by directly
- accessing video memory. If you see snow on your
- monitor, using this option should eliminate most
- of the distraction.
-
- Copyright (c) 1989-90 Bowen Software Page 8
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- /T<B,C,I,W> Toggle indicator defaults
-
- Any or all of the toggle indicator letters may be
- specified to override the defaults. The letters
- and the toggle indicator they modify are discussed
- below. The /W option should be specified as /TW.
- However, it will still function to provide
- backward compatibility.
-
- B - Borders for fields ON
-
- Specifying this option forces all finds to be
- successful only if WITHIN field borders.
-
- C - Case sensitive
-
- Specifying this option forces all finds to be
- sensitive to upper and lower case letters.
-
- I - Insert mode
-
- When insert mode is on and you are entering
- information or editting a record, characters to
- the right will move to the right as you enter
- data.
-
- W - Write file access
-
- Specifying this option will cause each database to
- be opened with read-write access.
-
- For more information on toggle indicators, see
- "Alt Toggle Keys" on page 12.
-
- /U Uninstall (remove) from memory
-
- This will remove PopDBF from memory, but ONLY if
- it is the last memory resident program.
-
- In some special cases, even when PopDBF is the
- last memory resident program it can't be removed
- from memory. This occurs if another resident
- program recaptures one of the interrupt vectors
- after PopDBF has chained into it. Sidekick is an
- example of this type of program.
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 9
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Getting Started
-
-
- /Z Zoom the Browse window
-
- By default the Browse window shows only 12
- records. When zoomed it will show 18 records.
- See also "Zoom Browse Window" on page 19.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 10
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Help
-
-
- 3 Help
-
- Help is available in PopDBF only if the file POPDBF.HLP is in the
- same directory as POPDBF.COM, the main program.
-
- While in Help you can press the up and down arrow keys as well as
- PgUp and PgDn to scroll the help text. To get out of Help, press
- Esc.
-
- 3.1 Generic Help (Alt-F1)
- You can get generic help about the system by pressing Alt-F1 from
- any area of the program.
-
- This help explains the Alt Action and Toggle Keys and the toggle
- indicators. See "Alt Menu" on page 12. It also explains cursor
- and lite-bar movement.
-
- 3.2 Context Sensitive Help (F1)
- Pressing F1 will provide specific help for any area of PopDBF.
- The help provided is essentially the same text found in this
- manual. Some areas of PopDBF are explained only in context
- sensitive help.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 11
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Alt Menu
-
-
- 4 Alt Menu (Alt)
-
- Pressing the Alt key will show the Alt menu on the status line.
- Releasing the Alt key will restore the previous status line. The
- Alt menu is divided into two parts, "Action Keys" and "Toggle
- Keys". Pressing Alt and one of the highlighted Action Keys will
- cause the appropriate action to occur. Pressing Alt and one of
- the highlighted Toggle Keys will toggle the appropriate indicator
- in the indicator window located in the lower left border of the
- main window.
-
- 4.1 Alt Action Keys
- Alt Action Keys will have no effect when responding to an error,
- a prompt, or inside of Help. They also have no effect while
- positioned on a directory in the Pick File window.
-
- The Alt Action Keys are:
-
- Alt-A Append records in the current database. Ignored
- if file access mode is read-only.
-
- Alt-B Browse records in the current database. If
- pressed while in Edit or Append is the same as
- pressing Esc to abort. See "Abort and Lose
- Changes" on page 23.
-
- Alt-E Edit records in the current database. If the file
- access mode is read-only, Edit acts as a full
- screen record viewer.
-
- Alt-P Pick a different database or directory. If
- pressed while in Edit or Append is the same as
- pressing Esc to abort.
-
- Alt-S View field structure of current database. If
- pressed while in Edit or Append is the same as
- pressing Esc to abort.
-
- 4.2 Alt Toggle Keys
- Alt Toggle Keys will function regardless of where you are in the
- program.
-
- The Alt Toggle Keys are:
-
- Alt-C Toggles the case sensitivity indicator between
- "IC", ignore case, and "CS", case sensitive. This
- indicator affects how the Find function does its
- search. See "Find Text" on page 20.
-
- Copyright (c) 1989-90 Bowen Software Page 12
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Alt Menu
-
-
- Alt-D Toggles the field border indicator between "NB",
- no borders, and "BO", borders on. This indicator
- also affects how the Find function behaves.
-
- Alt-I Toggles the insert/overstrike indicator between
- "IN", insert mode, and "OV", overstrike mode.
- This indicator affects how text is placed into
- fields in Edit. It can also be toggled by
- pressing Insert.
-
- Alt-M Toggles the file access mode indicator between
- "RO", read-only mode, and "RW", read-write mode.
- When the file access mode is read-only, you will
- not be allowed to Edit or Append.
-
- 4.3 Toggle Indicator Summary
- The default values for the toggle indicators are given below.
-
- ╚═╡ RW IC BO OV ╞══
- │ │ │ │
- │ │ │ └─── IN/OV: edit mode is insert/overstrike
- │ │ └────── BO/NB: field borders are on/off
- │ └───────── IC/CS: case sensitivity is off/on
- └──────────── RO/RW: file access mode is read-only /
- read/write
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 13
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"Pick File
-
-
- 5 Pick File (Alt-P)
-
- Pressing any letter will move the lite-bar to the first file or
- directory that begins with that letter. Successive presses of
- the same letter will move to the next file or directory that
- begins with that letter. If no file or directory begins with the
- letter pressed, no movement will occur.
-
-
- 5.1 Select Directory/File/Index (Enter)
- Pressing RETURN will cause one of the following to occur:
-
- ■ If the file is a directory, you will move to that
- directory. Once in that directory the Pick File window
- is refreshed with the names of files that match the
- file specification.
-
- ■ If the file is a database, the action taken corresponds
- to the currently specified Action letter. This can be
- changed by pressing F5 (see "Change Default Action" on
- page 15). It is the same as pressing Alt-<action
- letter>.
-
- ■ If the file is an index (.NDX, .IDX, .NTX only), you
- will view the index expression used to create it.
-
-
- 5.2 Move to Parent Directory (BackSpace)
- Pressing BackSpace will take you to the parent of the current
- directory, unless you are currently in the root directory.
-
-
- 5.3 Change Directory and/or Drive (F2)
- Pressing F2 will allow you to change the current PopDBF directory
- and/or drive. The name supplied can be a drive letter followed
- by a colon (C:), a directory path (\DON\BOWEN), or both
- (C:\DON\BOWEN).
-
- If the new directory is invalid, an error message will be
- displayed. If the new directory is valid the file selection
- window will be filled with files matching the current file
- specification in that directory.
-
-
- 5.4 Enter A Specific File (F3)
- Pressing F3 will allow you to enter a specific file name. If the
- file is not found or is not a valid database or index, an error
- message will be displayed. If no extension is entered, the
- extension in the file specification will be used. This will
-
- Copyright (c) 1989-90 Bowen Software Page 14
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"Pick File
-
-
- cause an error if that extension contains a wildcard (*/?) and
- you will need to enter the file extension as well.
-
-
- 5.5 Change File Specification (F4)
- Pressing F4 will allow you to modify the file specification
- located in the upper right corner of the main window. The file
- specification is used to determine which files in the current
- PopDBF directory you are allowed to pick from. Entering a file
- specification of *.* will allow you to pick from all files, while
- *.DBF will allow only files with an extension of .DBF.
-
- The names of any sub-directories in the current PopDBF directory
- are included for possible selection regardless of the file
- specification.
-
-
- 5.6 Change Default Action (F5)
- The current default action is displayed in the upper left portion
- of the file selection window. The default action determines what
- happens when you press Enter and the selection bar is on a valid
- database file. Each press of F5 will change the action as
- follows:
-
- Append -> Browse -> Edit -> Structure -> Append, etc.
-
- The result is the same as holding the Alt key and pressing that
- letter. You can override the default action by holding the Alt
- key and pressing a different action key.
-
-
- 5.7 Delete File (F6)
- Pressing F6 will allow you to delete a file. You will be asked
- to verify that you really want to delete the file. If you answer
- with a Y for yes, the file will be deleted. Pressing ESC or N
- for no, will cancel the delete.
-
-
- 5.8 Move to Current DOS Drive & Directory (F10)
- Pressing F10 will move you to the current DOS directory. The
- current DOS directory is the directory you were in before the
- PopDBF hotkey was pressed. If that directory is on a drive other
- than the current drive, that drive becomes the current drive as
- well.
-
-
- 5.9 Frequent Database Access (Alt-1 thru Alt-=)
- To use this feature you must have already created an ASCII file
- named POPDBF.FRQ containing the names of up to 12 frequently used
-
- Copyright (c) 1989-90 Bowen Software Page 15
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"Pick File
-
-
- databases. Multiple POPDBF.FRQ files can exist. It will be
- looked for first in the current directory and then in the
- directory from which PopDBF was executed.
-
- Each database name can include a drive identifier and path. It
- MUST include file name and extension. Optionally, each file can
- be preceded by an action letter and a space. See "Change Default
- Action" on page 15 for more information on action letters.
-
- Pressing Alt-1 will access the database whose name is on the
- first line of this file, Alt-2 will access the second, and so on.
- If more than 12 lines are included POPDBF.FRQ they are ignored.
-
- Examples of lines in POPDBF.FRQ:
-
- C:\ME\DBF\ROLODEX.DBF
- E C:\PERSONAL\MILEAGE.DBF
- A MILEAGE.DBF
-
- Using this feature while in the middle of edit or append, will
- save any current changes.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 16
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- View Structure
-
-
- 6 View Structure (Alt-S)
-
- Pressing any letter will move the lite-bar to the first field
- that begins with that letter. Successive presses of the same
- letter will move to the next field that begins with that letter.
- If no field begins with the letter pressed, no movement will
- occur.
-
-
- 6.1 Number/Un-Number Fields (Space)
- Pressing the Space bar will number/un-number the field at the
- selection bar. If any fields are numbered, only those fields
- will be shown when you Browse or Edit records. The number beside
- the field determines the order in which it will be displayed.
- Two fields with the same number will remain in the same relative
- position to each other.
-
-
- 6.2 Clear Field Numbers (F2)
- Pressing F2 will clear all field numbers, but leave the file
- structure in the present order. This means that you can assign
- field numbers, press F4 to order the fields, and then remove all
- field numbers by pressing F2. This will allow you to view all
- fields but in an order different from the original. Field
- numbers are also cleared when a new file is selected from the
- Pick File window.
-
-
- 6.3 Assign a Specific Field Number (F3)
- Pressing F3 will allow you to assign a specific number (0-1024)
- to a field to affect its order. Assigning a zero will un-number
- the field.
-
-
- 6.4 Order Fields Using Field Numbers (F4)
- Pressing F4 will reorder the fields in the structure based on
- their field numbers. THIS NEW ORDER IS NOT PERMANENT. The
- actual structure of the file on disk is NOT affected. To restore
- the original field order either return to the Pick File window
- and re-select the file or clear all field numbers by pressing F2
- and press F4 again.
-
-
- 6.5 Tag/Un-Tag Field for Exclusive Find (F6)
- Pressing F6 will tag/un-tag the field at the selection bar for
- exclusive find. When any fields are tagged for exclusive find,
- only those fields are used when doing a Find or Find Next from
- Browse or Edit. Also, if the field border indicator is on (see
-
- Copyright (c) 1989-90 Bowen Software Page 17
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- View Structure
-
-
- "Toggle Indicators Summary" on page 13), the text being searched
- for MUST be found entirely within ONE field. For more
- information see "Find Text" on page 20.
-
- 6.6 Clear Exclusive Find Tags (F7)
- Pressing F7 will turn off the exclusive find indicator for all
- fields.
- This will allow Find and Find Next to locate text anywhere in the
- record, unless field borders are on, in which case it must be
- entirely within ONE field. Exclusive find tags are also cleared
- when a new file is selected from the Pick File window.
-
-
- 6.7 Copy Structure (F8)
- Pressing F8 will allow you to copy the current database file
- structure to another file. You will be prompted for the new
- database file name. Pressing ESC will abort this function. If
- any fields are marked, only those fields, and in their specified
- order, will be copied.
-
-
- 6.8 Print the File Structure (F9)
- Pressing F9 will print the file structure. If any fields are
- numbered only those fields will be printed. The file statistics
- are printed first followed by the field structure.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 18
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Browse Records
-
-
- 7 Browse Records (Alt-B)
-
-
- 7.1 Current Record and Delete Status
- The current record number and delete status are displayed in the
- bottom border of the Browse window.
-
-
- 7.2 Pan the Browse Window ( / )
- The LeftArrow and RightArrow will allow you to pan to the left
- and right, respectively.
-
-
- 7.3 View Large Fields (Tab/Shift-Tab)
- Tab and Shift-Tab change the offset of fields that are wider than
- the Browse window. The offset is incremented or decremented by
- 10 characters. The current offset is displayed in the upper
- right-hand corner of the Browse window.
-
-
- 7.4 Zoom the Browse Window (F2)
- Pressing F2 will either expand or contract the Browse window.
- When expanded the window shows 18 records and when contracted
- shows only 12, but has the advantage of allowing you to see the
- file statistics as well.
-
-
- 7.5 Goto a Specific Record (F3)
- Pressing F3 will prompt you for a new record position. If the
- record number specified is greater than the number of records in
- the file, an error will occur and the lite-bar will stay on the
- same record.
-
-
- 7.6 Zap Database (F4)
- Pressing F4 will Zap the current database. When a database is
- zapped, all records are deleted AND physically removed. Because
- this is potentially a dangerous function, you will be prompted to
- make sure you really want to zap the database. Pressing ESC or
- entering N will abort. If the database is currently opened in
- read-only (RO) mode, this function will be ignored.
-
-
- 7.7 Pack Database (F5)
- Pressing F5 will Pack the current database. When a file is
- packed, all logically deleted records are physically removed.
- Because this is potentially a dangerous function, you will be
- prompted to make sure you really want to pack the database.
-
- Copyright (c) 1989-90 Bowen Software Page 19
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Browse Records
-
-
- Pressing ESC or entering N will abort. If the database is
- currently opened in read-only (RO) mode, this function will be
- ignored.
-
- 7.8 Find Text (F7)
- Pressing F7 will prompt you for the text you want to locate.
- Memo fields are not searched and dBASE dates need to be searched
- as follows. If the date you are looking for is 11/03/89 you
- would enter: "891103" or "19891103" (don't enter the quotes).
-
- When the case sensitivity indictor is off (IC) finding "don" will
- locate records containing "Don", "DON", and other combinations.
- To find only occurrences of "don", you must first turn on the
- case sensitivity indicator (CS) by pressing Alt-C.
-
- There may be times that you want to find text only if it occurs
- in a specific field or fields, not just anywhere in the record.
- To do this press Alt-S for the View Structure window. Now tag
- the fields you want searched exclusively by pressing F6. When
- you have tagged the fields to be searched, press Alt-B to return
- to the Browse window. Now Find will search only the fields you
- tagged.
-
- By default Find will locate text even if it crosses field
- boundaries. To prevent this you can turn on the field border
- indicator by pressing Alt-D. When field borders are on (BO),
- text must be found entirely within ONE field. Field borders are
- on by default.
-
- Find can also be used to locate deleted records. Do a find for
- "*" and make sure that field borders are off and no fields have
- been tagged for exclusive find. This will only work if an
- asterisk is not actually found in one of the database fields.
-
- Find ALWAYS begins with the first record in the file. See "Find
- Next Occurrence of Text" below to see how to start Find at the
- current record.
-
- If Find fails a beep will sound.
-
-
- 7.9 Find Next Occurrence of Text (F8)
- Pressing F8 will do a Find Next. Find Next ALWAYS begins with
- the next record in the file.
-
- To start a Find at the current record you can use Find Next.
- Press F7 to enter the find text and then press Esc. This will
-
-
- Copyright (c) 1989-90 Bowen Software Page 20
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Browse Records
-
-
- cause the find text window to disappear. Now press F8 and the
- search will begin at the next record.
-
- If Find Next fails a beep will sound.
-
-
- 7.10 Print Records (F9)
- Pressing F9 prompts for print parameters and then prints the
- data. The parameters you will be asked for are the starting
- record, ending record, if only records matching the find text
- should be used, and the width of the print line. Data is printed
- exactly as it is seen in the Browse window, but more text may be
- printed if a longer print width is specified (this is how you
- print the additional data to the right of the Browse window).
-
- Print can be used in conjunction with the find text string to
- print only records that contain certain text. Find behaves here
- as described above under "Find Text".
-
- The maximum print width is 250 characters.
-
-
-
- 7.11 Turn Century On/Off (Ctrl-C)
- Pressing Ctrl-C will toggle the century on or off. When on, the
- date is formatted as MM/DD/YYYY.
-
-
- 7.12 Mark Record as Deleted (Ctrl-U)
- Pressing Ctrl-U will toggle the delete status of the current
- record. The delete status of the current record is displayed in
- the bottom border of the Browse (and Edit) window. See "Find
- Text" on page 20 for a tip on how to find deleted records.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 21
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Edit/Append Records
-
-
- 8 Edit/Append Records (Alt-E/Alt-A)
-
-
- 8.1 Copy a Record (F2)
- Pressing F2 will prompt you for the number of the record you want
- to copy into the current record. To append a duplicate of a
- current record you must first go into Append by pressing Alt-A.
- Then press F2 and specify the number of the record to copy. To
- complete the operation, press PgDn.
-
- Pressing Ctrl-F2 will also copy a record, but will use the last
- record you specified to be copied instead of prompting you.
-
-
- 8.2 Goto a Specific Record (F3)
- Pressing F3 works the same as it does in Browse. See "Goto a
- Specific Record" on page 19.
-
-
- 8.3 Find Text (F7)
- Pressing F7 works the same as it does in Browse. See "Find Text"
- on page 20.
-
-
- 8.4 Find Next Occurrence of Text (F8)
- Pressing F8 works the same as it does in Browse. See "Find Next
- Occurrence of Text" on page 20.
-
-
- 8.5 Field Information (F10)
- Pressing F10 will pop-up a window containing information about
- the field in which the cursor is currently positioned. This can
- be helpful if you forget the field type or want to know exactly
- how long it is.
-
-
- 8.6 Turn Century On/Off (Ctrl-C)
- Pressing Ctrl-C works the same as it does in Browse. See "Turn
- Century On/Off" on page 21.
-
-
- 8.7 System Date (Ctrl-D)
- Pressing Ctrl-D while in a date field will place the system date
- in the field. It will only work in a character field if enough
- room remains from the cursor to the end of the field. It will
- also overwrite any existing data in the field at those positions.
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 22
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Edit/Append Records
-
-
- 8.8 Move to Last Field Position (Ctrl-E)
- Pressing Ctrl-E will move the cursor to the last possible
- position in a field.
-
-
- 8.9 Restore Field Data (Ctrl-F)
- Pressing Ctrl-F will restore the field's original data. Once you
- have moved to another record any changes that were made become
- permanent and can NOT be restored.
-
-
- 8.10 Abort and Lose Changes (Ctrl-Q/Esc)
- Pressing Ctrl-Q or Esc will quit Edit and abort any changes made
- to the current record will be lost. If any changes have been
- made you will be asked if you want to lose the changes. Pressing
- escape will abort and leave you in Edit. Pressing N will save
- the changes and then exit, while pressing Y will exit and the
- changes will be lost.
-
-
- 8.11 Restore Entire Record (Ctrl-R)
- Pressing Ctrl-R will restore the entire record's original data.
- See "Restore Field Data" above for when changes in the current
- record become permanent.
-
-
- 8.12 Mark Record as Deleted (Ctrl-U)
- Pressing Ctrl-U will toggle the delete status of the current
- record. The delete status of the current record is displayed in
- the bottom border of the Edit (and Browse) window. See "Find
- Text" on page 20 for a tip on how to find deleted records.
-
-
- 8.13 Quit and Save Changes (Ctrl-W/Ctrl-End)
- Pressing Ctrl-W or Ctrl-End will quit Edit and save any changes
- made to the current record.
-
-
- 8.14 Blank Current Field (Ctrl-Y)
- Pressing Ctrl-Y will fill the current field with spaces.
-
-
- 8.15 Blank to End of Field (Ctrl-Delete)
- Pressing Ctrl-Delete will delete from the current cursor position
- in the current field to the end of the field.
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 23
-
-
-
-
-
-
-
- PopDBF - "Instant Access to dBASE Files"
- Edit/Append Records
-
-
- 8.16 Move to End of Data (End)
- Pressing the End key will move the cursor to the first blank
- position after any data entered in the current field.
-
-
- 8.17 Move to First Position (Home)
- Pressing the Home key will move the cursor to the first position
- of the current field.
-
-
- 8.18 Move Word (Ctrl- /Ctrl- )
- Pressing Ctrl-LeftArrow or Ctrl-RightArrow will move one word to
- the left or right, respectively.
-
-
- 8.19 Move to First/Last Field (Ctrl- /Ctrl- )
- Pressing Ctrl-UpArrow and Ctrl-DownArrow will move to the first
- and last field respectively, on the current screen.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- Copyright (c) 1989-90 Bowen Software Page 24
-