WHAT IS SHAREWARE:

Shareware distribution gives users a chance to try software before buying it.
If you try a Shareware program and continue using it, you are expected to
register. Individual programs differ on details -- some request registration
while others require it, some specify a maximum trial period. With
registration, you get anything from the simple right to continue using the
software to an updated program with printed manual.

Copyright laws apply to both Shareware and commercial software, and the
copyright holder retains all rights, with a few specific exceptions as stated
below. Shareware authors are accomplished programmers, just like commercial
authors, and the programs are of comparable quality. (In both cases, there
are good programs and bad ones!) The main difference is in the method of
distribution. The author specifically grants the right to copy and distribute
the software, either to all and sundry or to a specific group. For example,
some authors require written permission before a commercial disk vendor may
copy their Shareware.

Shareware is a distribution method, not a type of software. You should find
software that suits your needs and pocketbook, whether it's commercial or
Shareware. The Shareware system makes fitting your needs easier, because you
can try before you buy. And because the overhead is low, prices are low also.
Shareware has the ultimate money-back guarantee -- if you don't use the
product, you don't pay for it.


DISCLAIMER - AGREEMENT:

Users of DBScreen must accept this disclaimer of warranty:
"DBScreen is supplied as is. The author disclaims all warranties, expressed
or implied, including, without limitation, the warranties of merchantability
and of fitness for any purpose. The author assumes no liability for damages,
direct or consequential, which may result from the use of DBScreen."

DBScreen is a "shareware program" and is provided at no charge to the user for
evaluation. Feel free to share it with your friends, but please do not give
it away altered or as part of another system. The essence of "user-supported"
software is to provide personal computer users with quality software without
high prices, and yet to provide incentive for programmers to continue to
develop new products.

If you find this program useful and find that you are using DBScreen and
continue to use DBScreen after a reasonable trial period, you must make a
registration payment of $20 to K & M Software. The $20 registration fee will
license one copy for use on any one computer at any one time. You must treat
this software just like a book. An example is that this software may be used
by any number of people and may be freely moved from one computer location to
another, so long as there is no possibility of it being used at one location
while it's being used at another. Just as a book cannot be read by two
different persons at the same time.

Commercial users of DBScreen must register and pay for their copies of
DBScreen within 30 days of first use or their license is withdrawn.
Site-License arrangements may be made by contacting K & M Software. Anyone
distributing DBScreen for any kind of remuneration must first contact
K & M Software at the address below for authorization.

You are encouraged to pass a copy of DBScreen along to your friends for
evaluation. Please encourage them to register their copy if they find that
they can use it. All registered users will receive a copy of the latest
version of the DBScreen system and any utilities for DBScreen that are
available at the time of registration. A product called SCRMAKE is in
development that will read "prg" files and create DBScreen work files.
Registered users will also get support on CompuServe by leaving E-mail to
70143,3272, or by postal mail sent to the address on the registration form.
This support is available free of charge for up to three months after
registration of DBScreen.

DBSCREEN REGISTRATION
Version 1.5




Quan Item Cost

___ DBScreen Registration............. @ $20 ea $________
(includes registration + program)

Shipping & Handling (Quan x $3.00) $________


Ontario residents please add 8% PST. Tax $________

Total $________

Check disk size required: __ 5 1/4 __ 3 1/2

Checks or money orders accepted.

-----------------------------------------------------------------

Name_______________________________________________________

Company_______________________________________________________

Address_______________________________________________________

_______________________________________________________

Phone_________________________ Bus.________________________

Where did you obtain DBScreen?

_______________________________________________________

Comments_______________________________________________________

_______________________________________________________

_______________________________________________________

_______________________________________________________

-----------------------------------------------------------------

SEND TO: K & M Software
P.O. Box 2180
Meaford, Ontario, Canada
N0H 1Y0

Table of Contents: Page #

1.0 Overview ........................................................ 1
2.0 Installation .................................................... 1
3.0 Starting DBScreen ............................................... 2
4.0 Choosing a DBF File ............................................. 2
5.0 Working with Fields & Variables
5.1 Selecting Fields/Variables ................................. 2
5.2 Sequence/Pictures/Validate ................................. 3
5.3 Deleting Fields ............................................ 3
6.0 Extended Characters ............................................. 3
7.0 General Screen Work
7.1 Deleting Lines ............................................. 4
7.2 Deleting Characters ........................................ 4
7.3 Inserting Lines ............................................ 4
7.4 Inserting Characters ....................................... 4
7.5 Line Center ................................................ 4
7.6 Changing Screen Size ....................................... 5
8.0 Block Commands
8.1 Block Copy ................................................. 5
8.2 Block Delete ............................................... 5
8.3 Block Move ................................................. 5
9.0 Color Work
9.1 Default Colors ............................................. 5
9.2 Select Paint Color ......................................... 6
9.3 Color Painting ............................................. 6
9.4 Block Painting ............................................. 6
10.0 Screen Library Management ....................................... 6
11.0 Code Generation ................................................ 6
12.0 Exiting DBScreen ............................................... 7

Page 1



1.0 OVERVIEW:

DBScreen is a screen design utility for Clipper. It will allow the
developer to create input/display screens much more quickly than the manual
approach. Dbscreen can handle an unlimited number of database files and up
to 1024 fields per file. The shareware version is limited only, by not
generating the code needed to create color screens.

DBScreen allows you to type any text, select fields from databases,
install memory variables and position them on the screen. You can also draw
with the extended character set and change colors. The program will generate
Clipper code that can be inserted into your applications.



2.0 INSTALLATION:

To install DBScreen, simply put it anywhere in your search path. There
is also an environment variable that can optionally be set as follows:

SET DBSCREEN=0[,MONO]

The first parameter determines how many spaces are needed to force
a new "@ say" to be generated by DBScreen. For example, suppose the
following is a line composed using DBScreen.

Quantity Cost TOTAL

With the space parameter set to 0 (the default setting), DBScreen will
generate the line with one "@ say". eg.

@ line,16 say "Quantity Cost TOTAL"

If the space parameter is set to 10, DBScreen will generate a new "@ say"
after it sees 10 or more spaces between characters. eg.

@ line,16 say "Quantity"
@ line,38 say "Cost"
@ line,55 say "TOTAL"


The second parameter to the environment variable can be either MONO or
COLOR. These should only be used if DBScreen does not properly recognize
the type of monitor connected to your PC.

Page 2



3.0 STARTING DBSCREEN:

To start, type DBSCREEN workname where the workname represents
the screen you are building. If screen files have already been created under
this work name, they will be read and the screen will appear as you last
left it. If not, a blank screen will appear.

At this point, you can type any text on the screen. Move the cursor
using the arrow keys and the tab key to position yourself anywhere on the
screen.

Another way to start, is by typing DBSCREEN * to automatically invoke
the screen library manager. From this, you will be able to choose from a
list of screen files.


4.0 CHOOSING A DBF FILE:

Before you are allowed to select fields to put on the screen, you must
first select the database file by pressing . This will display all
database files in the current directory in alphabetical order. Highlight the
one you want, and press return. If you are inserting a memory variable,
select the "M" at the top of the database list. (The screen library
management system automatically creates a file called DBSCREEN.DBF to hold
general screen information.)



5.0 WORKING WITH FIELDS AND VARIABLES:

5.1 Selecting Fields/Variables:

Pressing will display the fields for the selected database file.
Highlight the one you want, and press return. You will see the field
indicator appear at your current cursor position. The length of the field
indicator represents the actual length of the field. An error message will
appear if there is not enough room for the field at your current position.
If you are inserting a memory variable, you will be prompted for the variable
name and length.


Page 3

5.2 Sequence/Pictures/Validate:

Each field and variable on the screen is assigned a sequence number.
This determines in what order the fields will be read by the READ statement
within Clipper. Normally, they will be read in the order they were put on
the screen within DBScreen. If you want to change this order, position the
cursor over the field, and press . This will display the sequence number
currently assigned to this field. You may change this to any number desired.
At this point, you may also enter a picture and/or valid clause, and finally,
you may choose the field to be a "get" or "say only" field. These will all
be used when DBScreen generates the Clipper code.

Another way to change the sequence numbers, is to use the
function. This will cycle through the sequence numbers, one at a time. The
current sequence number will be displayed in the bottom left corner of the
screen. Position cursor on the field you want to receive that sequence number,
and press . The next available sequence number will appear.

To view the sequence of the fields press . This will move the
cursor to the field with the lowest sequence number. To move to the next
field, press any key. Continue this until all fields have been accessed.
When you begin this sequence test, you will see an indication of this mode
in the lower left hand corner of the screen. Note that "display only" fields
will be ignored in this mode.


5.3 Deleting Fields:

To delete a field, position the cursor anywhere on the field and press
the key. You will be asked to confirm this move before the deletion
continues.



6.0 EXTENDED CHARACTERS:

DBScreen has the ability to display characters from the extended
character set. This allows you to draw on your screens. On the bottom
line of your screen, there is an indication of what your current extended
character is (blank by default). To select a new extended character, press
, position the cursor under the character you want, and press .
This will return you to your screen, and you will see the character you
picked on the status line. To paint the chosen character onto the screen,
press , , or . Any one of
these will put the character on the screen, and move the cursor one position
left, right, up or down. Be aware that the control keys used to place the
extended characters on the screen are the same ones used to paint colors.
The status line will indicate if the color paint mode is active.
Press to toggle between the color and extended character paint modes.

Page 4

One of the most popular reasons for using extended characters is to draw
boxes. To make this easier, there is a box draw feature in DBScreen.
Simply position the cursor at the upper left corner of where you want the box
and press . Move to the lower right corner of where you want the box
and press . You will be asked to select either a double or single
line box.



7.0 GENERAL SCREEN WORK

7.1 Deleting Lines:

To delete an entire line, put the cursor on the line to be deleted and
press . All lines below the deleted line will move up. If there are any
fields on the line, you will be notified and asked for confirmation.


7.2 Deleting Characters:

To delete characters position the cursor under the character to be
deleted and press the key. The specified character will be deleted,
and all characters to the right of the cursor will move left 1 position.

Another way to delete characters is to use the backspace key. This will
delete a character to the left of the cursor, but will leave all other
characters on the line in their original positions.


7.3 Inserting Lines:

To insert a new line, position the cursor where the new line is to go,
and press . All lines at and below the cursor will move down 1 position.
If there is any text on the bottom row, it will be lost, but if there are
fields on the bottom row, you will not be allowed to continue.


7.4 Inserting Characters:

The key toggles between insert and overwrite modes. When the
insert mode is active, a block cursor will appear. All characters typed
while in the insert mode will appear normally, but any characters to the
right of the cursor position will be moved to the right. If this will result
in losing a character off the right side of the screen, you will not be
allowed to continue.


7.5 Line Center:

Position the cursor on the line to be centered and press . This
will center the line on the screen.
Page 5

7.6 Changing Screen Size:

If you want to change the number of rows and/or columns for your display,
press . You will be asked for the number of rows and columns you want.
DBScreen will adjust to the specified size, as long as it is supported by
your video card.

There is currently a problem with the 132 column mode. At this time,
if you want to use this mode, I suggest you change into the 132 column mode
before you start DBScreen.



8.0 BLOCK COMMANDS

8.1 Block Copy:

To copy an area of the screen, position the cursor at the upper left
corner of the section you want to copy and press . Move to the
bottom right corner if the section to be copied and press . Next,
move to the upper right corner of the target area & press once
again. You will see the screen area duplicated including any fields.


8.2 Block Delete:

To delete an area of the screen, position the cursor at the upper left
corner of the section to delete. Press and move to the bottom
right corner and press . Press to delete the block, or any
other key to cancel.


8.3 Block Move:

To move an area of the screen to another location, position the cursor
at the upper left corner of the section to be moved. Press and move
to the bottom right corner and press . Next, position the cursor at
the upper right corner of the area to move to and press .


9.0 COLOR WORK

9.1 Default Color:

If you are using a color monitor, the default color is white on blue by
default. To change this, press . You will see the color table
appear. Select the new default color and press . To abort the
selection press .

Page 6

9.2 Select Paint Color:

This selection determines the color that will be used while in the color
paint mode. Press to display the color table. Select the color you
wish to paint with.


9.3 Color Painting:

When designing the screen, press to toggle color painting on/off.
If color painting is on, there will be an indication on the status line.
When on, use the , , and keys
to paint colors.


9.4 Block Painting:

Block painting should be used when you have a large area to paint.
Position the cursor at the upper left corner of the area you want to paint.
Press and move to the lower right corner of the area to paint.
When done, press . To abort press .



10.0 SCREEN LIBRARY MANAGEMENT

When DBScreen is first executed in a directory, it will create its own
database table to keep track of your screens. Any screens created with an
earlier version will also be added to this file. To start DBScreen without
specifying a work area, type "DBSCREEN *". This will display a list of
screens. Move to the screen you want, and press . To recall the screen
manager at any time, press . You can do this to call different
screens from within DBScreen.


11.0 CODE GENERATION

To have DBScreen generate the screen code, press . This will
generate code useable by Clipper version 5.x but can be easily converted
for earlier versions. For earlier versions, delete any lines with
setmode, dispbegin and dispend functions. The setmode function changes
the screen size and was not available before version 5. The dispbegin
and dispend functions deal with screen buffering and are not really
necessary. These functions were not available before version 5.01 of
Clipper. Finally, you may have to remove the word "static" from the
setattr function. This function is only written if there are multiple
colors on the screen. A static function is visible only to the procedure
it is in. Static functions are new to version 5.

Page 7

12.0 EXITING DBSCREEN

To exit DBScreen, press . you will be asked if you want to save
your screen layout. Press Y or N accordingly. Pressing again will
return you to DBScreen and your work file.