  ---------			        		Desktop Systems
-------------				                  -----------
   pwQuery  				             5 St Albans Avenue
-------------			                          London W4 5LL
  ---------						        England


           
   Version 1.45

   February 21 1994



  This is an evaluation copy of pwQuery.  It functions in exactly 
  the same way as the full version except you cannot save query 
  forms that you build using the pwQwery Form Builder.  This means 
  that you cannot use them in stand-alone mode nor integrate them 
  into your applications.  You can however use them interactively 
  within the Form Builder.


HOW TO ORDER

  To order the full working version of pwQuery either:
   
    Use the pwQuery Order Form, which is printed during the pwQuery 
    installation procedure.  The Order Form includes all pricing and 
    ordering information.  It can also be printed subsequent to 
    installation by opening and printing the Paradox for Windows form 
    named ORDER.

    Mail or fax the completed Order Form to -

	Paradox Users Group UK
        2 Earldom Road
        London SW15 1AF
	England

	Fax - International: +4481 780 0791 / UK: 081 995 0791

   If you order this way your credit card will be debited in 
   Pounds Sterling.

  or:

    Register your use of pwQuery as Shareware via Compuserve (GO SWREG
    Registration ID: 2066). If you order this way your credit card 
    will be debited in US Dollars.

  On receipt of your order, by either method, a new installation disk
  will be mailed to you together with the comprehensive pwQuery manual.

  Site Licences: contact the Paradox User Group UK at the address or 
  fax number above, or via CompuServe 100016,552.
  

SYSTEM REQUIREMENTS

  + A personal computer capable of running Borland's Paradox for Windows.

  + Borland's Paradox for Windows version 4.5



TECHNICAL SUPPORT

  Technical support is available from Desktop Systems by fax or via
  CompuServe.
	Fax number - International +4481 995 3195 / UK: 081 995 3195
        CompuServe - 100102,461

	

INSTALLATION AND USE

The following extract from the pwQuery manual tells you how to install
pwQuery and then takes you on a guided tour through the main features 
to show you how it all works.

Note: 	If you downloaded pwQuery then the Order Form report and table
        remain in the temporary directory into which you unzipped it. 
  

How to install pwQuery
++++++++++++++++++++++


pwQuery is set up on your computer using the install program that comes 
with the product.  This program is run from Paradox for Windows. 
It creates a directory on your hard disk and copies the pwQuery forms
and library into it.  It also generates a pwQuery Order Form for you, 
and optionally installs the tutorial material for the pwQuery Guided 
Tour.  



Before you run the install program
----------------------------------

Your pwQuery install will benefit from a little pre-planning :

1  Check that Paradox for Windows is installed and working correctly 
   on your computer.

2  Check that you have at least 150 Kbytes of free space on your hard 
   disk for pwQuery's forms and library, plus an additional 100 Kbytes 
   if you want to install the optional sample material.

3  Decide the name of the directory in which you want pwQuery to be 
   permanently.  The recommended directory name is C:\PWQUERY. 
 
   If you downloaded pwQuery then you will have already unzipped it into 
   a temporary directory, probably on your hard disk.  This directory 
   must have a different name from the permanent directory. If you named 
   the temporary directory PWQUERY then you must choose a different name 
   for the permanent directory or, preferably, rename the temporary 
   directory.  

4  The install program asks you if you want to install the pwQuery 
   sample material.  If you decide that you do want this material then 
   it is installed in a sub-directory of the main pwQuery directory.

5  The install program also asks you for information with which to 
   complete your Order Form.  The information that it requires is -

	Your name
	A company name
	An address
	Telephone and fax numbers

   You must supply your name or a company name or both.  You should have
   a printer ready to print the Order Form.



Now run the Install Program
---------------------------

Before running the install program you should have a good understanding 
of Paradox for Windows, and you should have done the preparatory work 
described in the previous section. 

The install procedure takes just a few minutes.  When you are ready 
to run the install program -

1  Make sure your computer is ready, with Paradox for Windows running 
   and the Paradox for Windows Desktop visible.

2  If you received pwQuery on a floppy disk, insert it into your 
   drive A, then change your Paradox for Windows working directory 
   to drive A by choosing File|Working Directory from the menu bar, 
   entering A:\ in the Working Directory text box, and choosing OK. 

   If you downloaded pwQuery then change your working directory to the 
   temporary directory containing the pwQuery files. 

3  Open form INSTALL by clicking the Open Form button on the SpeedBar,
   or choosing File|Open|Form, and selecting it from the Open Document 
   dialog box.  

4  Follow the simple instructions presented by INSTALL.  At critical 
   points INSTALL asks you for confirmation before proceeding and you 
   have opportunities for cancelling the installation procedure.

5  It is strongly recommended that you print the Order Form when given 
   the opportunity at the end of the installation procedure.  

6  pwQuery has now been successfully installed.  If installing from 
   a floppy disk, change your working directory back to one on your 
   hard disk, remove the pwQuery disk and keep it in a safe place.



A guided tour of pwQuery
++++++++++++++++++++++++

By the end of the tour you will have created a query form, used it 
to search a Paradox for Windows table for specific information, 
and printed this information in a report.



The sample tables and report
----------------------------

Two tables and a report for use on the tour are included with pwQuery. 
If you asked for them to be installed you will find them in the SAMPLE 
sub-directory of the directory into which pwQuery was installed.

The table that you are going to query is called PETS.  It contains 
information about a number of domesticated animals each of which is 
owned by an Aunt.  Information about the Aunts is held in the AUNTIES
table and each Aunt can own one or more pets.  Choose File|Open|Table 
and then Table|Infostructure to inspect the structure of the sample 
tables.

A sample report, called PETREP, produces a report on an individual pet 
and its owner.



To use the Form Builder
-----------------------

1  Set your working directory to the directory into which the pwQuery 
   sample tables and report were installed (usually \PWQUERY\SAMPLE) 
   by choosing File|Working Directory from the Paradox for Windows 
    menu bar.
 
2  Open the pwQuery script in your private directory by choosing 
   File|Open|Script from the Paradox for Windows menu bar or Open Script 
   from the SpeedBar, and opening script :PRIV:PWQUERY.SDL.

3  Either:
     type 'pets' in the Which table do you want to query? text box,
   or:
     click on the table browse button (to the right of the text box) 
     to use the Paradox for Windows File Browser to select the PETS 
     table from the \SAMPLE directory.

4  Choose Next step... to advance to the next form.


-----
At this point you have told the pwQuery Form Builder that you want 
to run queries on the PETS table.
-----

 
Now you can tell the Form Builder which fields in the PETS table you may 
want to search on.  The left-hand box, headed Source Field Names, 
contains a list of all the field names in the PETS table.  You can use 
the vertical slide bar to scroll through them.  The first field, 
named Owner, is high-lighted with a dark gray bar.


5  Press the Select (right-pointing) button.


-----
The Owner field name is copied to the box, headed Selection Field Names, 
on the right.  Owner is now a field that you can search on.  The Select 
button always copies the high-lighted source table field name in the 
left box to the list of selection field names in the right box.
-----


6  Move the mouse pointer to Species in the left box and click the left 
   mouse button.  The Species field name is now high-lighted.

7  Press the Select button again.  Species is added to the list 
   of selection field names.

8  Do the same with Major colour, Length, Disposition and Swimmer. (You 
   need to use the slide bar to get to Swimmer.)


-----
At this point you have told the pwQuery Form Builder that you want 
to run queries on any or all of the fields named Owner, Species, 
Major colour, Length, Disposition and Swimmer in the PETS table.
-----


Let's suppose that you decide that you do not want to search on Swimmer 
after all.

9   Move the mouse pointer to Swimmer in the right box and click 
    the left mouse button to high-light it.

10  Press the Remove (left-pointing) button.  Swimmer disappears from 
    the list of selection field names.   


-----
You are now nearly ready to build the query form.
-----


11  Choose Next step..

12  Type 'findapet' in the What do you want to call your query form? 
    text box.

13  Type any title you like in the Form Title text box.  How about 'Pet 
    location system' ?

14  pwQuery forms can be built in two styles: Standard which is similar
    to the style of the Form Builder screens, and Custom which takes
    the properties of the query form's objects from the current 
    Paradox for Windows Designer Style Sheet.  Choose a style by 
    clicking one of the Form Style radio buttons.

15  Click the Report? check box to say that you want a Paradox 
    for Windows report to be associated with this query form.  
    Then either:
      type 'petrep' in the Report Name text box,
    or:
      click on the report browse button (to the right of the text box)
      to use the Paradox for Windows File Browser to select the PETREP 
      report from the \SAMPLE directory.


-----
At this point you have told the pwQuery Form Builder that you want 
to run queries on any or all of the fields named Owner, Species,
Major colour, Length and Disposition in the PETS table.  You want 
the query form to be named FINDAPET and you have linked a report 
called PETREP to it. You have also given the form a title and chosen
its style.
-----


16  Choose Build Query Form.


-----
pwQuery now builds the form.  Depending on your computer you may or may 
not see your query form being built.  On a fast computer this happens 
so quickly that you don't notice it.
-----  


When the form has been built the Form Builder asks you two questions:
   Do you want to use the form now? and
   Do you want to save it?
   
Let's suppose that you do want to use it now.


17  Choose Yes in the Do you want to use the form now? dialog box.


-----
Your query form appears on the screen and you can try a query straight 
away.  Let's suppose you want to find all the big, brown, friendly dogs 
in the PETS table.
-----


18  Select the text box for Species by clicking it or pressing 
    the Return key.  Type 'dog'.

19  Select Major colour and type 'brown'.

20  Select Length and type '>90'.  This means: select all pets that are 
    more than 90cm long.

21  Select Disposition and type 'friendly'.

22  Press the Query button.


-----
The PETS table is searched for all records with dog in the Species 
field, brown in the Major colour field, a value greater than 90 
in the Length field and friendly in the Disposition field.

When the search finishes the Help Box in the lower left-hand corner 
shows that 2 out of 11 pets meet these conditions and that their 
records have been copied to the results table.
-----


To look at the results table in a Paradox for Windows table view:

23  Choose View.

24  Close the table view window by clicking the control menu in its top 
    left-hand corner and choosing Close, or use Ctrl+F4.


To look at the results table in a Paradox for Windows report:

25  Choose Report.

26  Close the report window by clicking the control menu in its top 
    left-hand corner and choosing Close, or use Ctrl+F4.


To view examples of selection conditions:

27  Choose Examples.

28  Close the examples window by clicking the control menu in its top 
    left-hand corner and choosing Close, or use Ctrl+F4.


Now let's find all the pets whose owner's names start with the letter a.

29  Type 'a..' in the Owner text box.  The two dots mean: match any 
    series of any number of characters.  They also mean that the case 
    (upper or lower) of the characters that you use with the two dots 
    is ignored, so in this example 'a..' will find Amy, Angela, amy 
    and angela, but not Barbara or barbara.

30  Delete the selection conditions in the remaining fields by selecting 
    them and pressing the Delete key.

31  Choose Query again.


-----
This time the Help Box shows that 5 records have been selected and you 
can choose Report or View to look at them. 
-----


To close the query form:

32  Choose Exit.

33  Choose Exit again on the Confirm Exit dialog box.

Because this is an evaluation copy the Form Builder terminates without
saving the query form regardless of whether you answer Yes or No 
on the Do you want to keep this form? dialog box.

If you were using the full version of pwQuery and answered Yes to
Do you want to keep this form? then the Form Builder would save 
the query form in your private directory, with the name FINDAPET,
before terminating.  You could then use it to make further queries 
on the PETS table, either by opening it from the SpeedBar just like 
any other form or by integrating it into your own applications.




PARADOX FOR WINDOWS RUNTIME EDITION

Both the pwQuery query forms AND the Form Builder work correctly under
PW Runtime.  However, because PW Runtime does not support Table Views
the pwQuery View button is inoperative.  If you press it you get an
apologetic message.




TROUBLE SHOOTING

Errors while building a query form
----------------------------------

  If you get a Paradox for Windows error while the pwQuery Form Builder
  is creating a Custom-style query form it is probably because the
  combination of properties in your style sheet conflicts with pwQuery's
  form design strategy so that one of the form's objects does not fit 
  inside its container.  Confirm this by recreating the form using
  a simple style sheet such as PWQUERY.FT which comes with pwQuery. 

  TI1801 from Borland explains how to create new Designer Style Sheets
  and how to modify existing ones.



The Unexplained
---------------

  Paradox for Windows is a complex product operating in a complex 
  environment so it is perhaps not surprising that occasionally 
  circumstances arise which are not handled quite as one might wish!
  Such aberrations can effect innocent user applications, and listed 
  below are those which have been observed while using pwQuery.  
  It must be emphasised that they occur very infrequently and their 
  existence in no way makes pwQuery unusable.  They are described 
  here so that if you do encounter them you will recognize them 
  and know how to react.   

  + 'PDOXWIN caused a General Protection Fault' Windows message 
    followed by termination of Paradox for Windows.

    We have no reason to believe that this message results from an error 
    in pwQuery.  Borland do not accept that there is a fault in Paradox 
    for Windows that might cause a GPF.  Fortunately GPFs seldom occur 
    and when they do they are often related to a previous error which 
    was handled successfully.  For the moment the solution appears 
    to be to identify the original error and to avoid repeating it.

    You may not be able to restart Paradox for Windows immediately
    after a GPF, but if you close and restart Windows itself then all 
    will be well.

  + 'Paradox for Windows Error' while the pwQuery Form Builder 
    is creating a query form.

    The associated error messages read: 
 	"An error has occurred setting the property named 'Alignment' 
         of the object named 'Textnnnn' of type 'Text'."
        "Attempted to assign an illegal value to the property."

    This error occurs extremely infrequently, but totally unpredictably. 
    The value being assigned is TextAlignRight and once the error has 
    occurred once it always happens regardless of the contents or style 
    of the form that is being created. The only known work-around is 
    to reinstall Paradox for Windows whereupon all forms are created 
    successfully.  




-----
Copyright (c) 1994 by Richard Creer.  All rights reserved.  Borland and
Paradox are trademarks of Borland International Inc.  Microsoft and MS 
are trademarks of Microsoft Corporation.  Windows, as used in this 
document, refers to Microsoft's implementation of a windows system.
-----

