Contents of the DB3SGEN.DOC file
db3ScrnGen version 1.1 Page 1
Copyright 1985 David W. Terry
db3ScrnGen is a dBase III(tm) Screen Editor and Program Generator designed as
an editing environment where Screens can be easily designed and then with the
push of a button a dBase III program which reproduces and utilizes your screen
This is the first release of the program and as such I am open to suggestions
or comments as to its functions or for new functions to be incorporated into
it. This program is basically what you make it. The more people that use it
the more I will develop it to include more functions.
The program is being distributed under the TRYWARE concept, that is: You may
TRY the program at your own pace, without pressure, copy protection hassles,
or paying for something you can't use. You decide for yourself if it suits your
What's the price? Nothing if you DON'T use it. If you do USE it or find it of
benefit to you, a small charge of $20.00 is required. This gives you the
right to use the program, make as many backups as necessary, receive
notification of any updates to the program, and receive one free update on
disk (others updates will be distributed either through Public Domain, or
on Disk from me at a $5.00 nominal charge for the disk, shipping and handling).
Unlike most software that today merely warrants the diskette it is supplied on,
this program is warranted that it functions as is claimed in the documentation
or in its accompanying help screens, so long as the program, documentation or
help information is not tampered with or altered in any way.
If for any reason the program fails to perform as is claimed and you have paid
your $20.00 fee, the program will either be fixed and sent free of charge, or
you will receive your money back (minus $5.00 if you have received a copy on
disk and not returned it).
Send all money, inquires, orders, suggestions, etc. to:
David W. Terry
3036 So. Putnam Ct.
West Valley City, Ut 84120
---- Please Read ----
One note must be made - That is that I designed the program to include graphics
characters in its editing capabilities - as you can see by pressing the
help key [F1] and then pressing [PgDn]. However, if you do not have SuperKey
you will quickly notice that none of the [Alt] key combinations involving a key
from the 10-Key pad will work, however, if you are familiar with the ASCII
codes for graphics characters, you may still enter them by doing the
following... To generate a double horizontal line press [Alt] and using the
10-key pad type the number 205, then let go of the [Alt] key.
I am working on a fix to this problem. It has to do with the way BIOS
interprets keystrokes and involves bypassing the BIOS in a manner similar to
what SuperKey does.
db3ScrnGen version 1.1 Page 2
DESIGNING YOUR SCREENS:
When the program first comes up (after the initial screen), you are greeted
with a blank slate with a line down on the bottom for messages and other
To create your screen, simply type on the screen as you would like the basic
screen to appear, putting in the names of Input or Output fields, dbase III
[Time()] dBase III Input Screen [Date()]
Please Enter the following:
City: [City] State: [State] Zip: [ZipCode]
In the above example, the the brackets  are including only to show which
areas will then be given a meaning as explained below.
The names TIME(), DATE(), NAME, ADDRESS, CITY, STATE and ZIPCODE are all
either Input, Output, or Input/Output fields. These can be marked by pressing
positioning the cursor at the beginning of one of the fields and pressing
[Alt-B] then moving to the end of the field and pressing [Alt-B] once again to
mark the area, then press either [F3] or [F4] to designate the field as an
input or output field.
To designate TIME() as an output field, move the cursor to the letter "T"
press [Alt-B], move the cursor to the ")" and press [Alt-B]. The field is
now highlighted (this is the same for block copy, block move, and block fill).
Now press the [F3] key to designate the marked block as an Output Field.
To designate NAME as an Input/Output field, do the same as the above
to highlight the block, then press [F4] to designate the field for Input or
Output (dBase naturally prints the current contents of NAME before allowing
performing the GET in an @ say...get statement).
db3ScrnGen version 1.1 Page 3
GETTING HELP WHEN YOU NEED IT:
Pressing the [F1] Help key at any time will give you help as to what keys
have what meanings when using the program. If there is insufficient information
on the Help screen, you may get more detailed information by pressing the key
For Example: To find out what the key combination [Alt-B] does, simply
press [F1] to view the main help screen then hold down
the [Alt] key while typing the letter [B].
GENERATING THE DBASE PROGRAM:
To generate the program which will print the screen you have designed,
outputting the output fields and reading in the input fields, simply press
the [F7] key. Then enter the name of the program to generate (for example:
MYPROG.PRG). That's all there is to it.
SAVING YOUR SCREENS:
Pressing [F10] will save the screen as you have designed it, making changes
to your program a simple matter of loading in the screen, modifying it, and
then re-generating the program.
LOADING YOUR SCREENS:
Loading your previously saved Screens requires you to press the [F8] key, and
then enter the name you used to save the screen. (Example: MYSCREEN.SCN).
VIEWING A DIRECTORY:
To view a directory, whether it be the default, another directory, or a
directory on another disk, simply press [Alt-D] and then enter the path
information including wildcards etc, the same as you would at the DOS prompt.
db3ScrnGen version 1.1 Page 4
This program was originally developed as an aid for myself and my colleagues
in quickly producing nice looking screens for dBase III programs. We are
heavy users of dBase III and realizing that the time spent encoding a program
is often the most expensive part of the development costs, this program
was therefore intended to be quick, easy to use, and yet powerful.
I encourage anyone who is currently written dBase III code to at least take
a look at the program and try it out. If it doesn't suit your needs, you
have three choices: 1) write a letter, I'll see if I can help, 2) give the
program to someone who can use it, or 3) erase it and never use it again.