=====================================================================
                              TriQuery
=====================================================================

README.TXT

  TriQuery is a free format door which can be used for creating on-line
questionnaires to get user information.  The registered version of this 
program supports up to 15 questions (limited to 8 questions if it is
unregistered), each of which can be defined as one of the following data types:
text, numeric, date, phone (N. American phone format)and boolean (Y/N).
  Individual questions can be defined as being mandatory (can't leave field
until data is entered) or optional (bypassed by pressing <return>).  Both 
questions and answers are limited to a maximum of 30 characters - this 
should be enough under normal circumstances to ask a proper question.  
After answering any/all questions, the caller will have the opportunity 
to edit any/all answers before exiting from the door.
  TriQuery also supports an optional introductory screen which the sysop
can create using any text editor or ANSI screen design progam.  This 
introductory file can be up to 22 lines long (it may work with longer
screens depending on how they were saved, but I make no gaurantees).
If the introductory screen is used the file must have the filename 
TRIQUERY.ANS.  TriQuery is compatible with almost any type of BBS which 
supports one of the door drop files listed below. TriQuery features 
several keys which allow the sysop to perform a variety of funtions while 
a caller is in the door. These are defined as follows:

          HOME      Toggle between user status window / function key window
          F6        Take 5 minutes away from time in TriQuery door
          F7        Add 5 minutes to time in TriQuery door
          F9        Quit TriQuery and return caller to BBS
          F10       Enter chat mode.  Press <esc> to exit from chat mode.

  
INPUT FILE  
----------
  Create the input file using any ASCII text editor.  The questions should
start on the first line and MUST have the following format:
          
          DBirthdate
          
          The text that you want to appear as the question
          
          character identifying the data format of the answer
            - upper case character for a mandatory question
            - lower case character for an optional question

The format codes that can be used are: D for date, P for phone, N for numeric,
B for boolean (yes/no), and T for alphanumeric text.  A space between the
format code and the text of the question is NOT required.


OUTPUT FILE
-----------
  The output file from TriQuery (TRIQUERY.DAT) is a plain ASCII file with
each line containing the answer to one question.  A blank line is inserted
between records.  As each new caller uses the program a new record is appended
to the bottom of the output file.  Because the program is free - format (i.e
there are no preset questions/orders/data types) I have included only a
very basic program for providing formatted output of the data file.  To create
a formatted output file (format is "question : answer" with a blank line between
each callers set of info) simply run the program TQFORMAT.EXE from the TriQuery 
directory.  This formatted file can now be sent to the printer for a permanent 
record of all your callers answers.


INSTALLATION
------------
  Installation of TriQuery is very straight forward.  First, create a
directory in which to put the files from the TQUERY11.ZIP file and then unzip 
the files into this directory.  Your .zip file should contain the following
files.  If it does not, then you do not have a valid copy of the program and
should try to locate a complete copy.
          
          TRIQUERY.EXE      The executable program file
          TRIQUERY.CFG      A sample configuration file
          TRIQUERY.QUE      A sample question (input) file
          TRIQUERY.ANS      A sample introductory screen
          README.TXT        This information / installation file
          REGISTER.DOC      An order form for TRIQUERY and other products
          TRIINST.EXE       An installation program
          FILE_ID.DIZ       Program Description

  To set up this program you can either run the included TRIINST.EXE
  installation program or follow the steps below.
  
  Manual Installation
  -------------------
  Modify the sample configuration file as outlined below.

          Line 1    TRIBBS              Door data file type *
          Line 2    C:\TRIBBS\          Path to the door data file
          Line 3    QUADTREE BBS        BBS Name
          Line 4    Peter Hanmore       Sysop's Name
          Line 5    38400               Locked baud rate **

          * valid door data file type are: PCB for PCBoard, GAP for
            GAP (door.sys) SF for Spitfire, RBBS for RBBS, WC for Wildcat!,
            TRIBBS for TriBBS, and WWIV for WWIV.
         ** If you do not lock your baud rate enter 0 on this line.

Next, create a batch file which will call the TRIQUERY program.  For TriBBS
boards it will look something like this:
          
          CD C:\TRIBBS\DOORS\TRIQUERY      Change to TRIQUERY Directory
          TRIQUERY TRIQUERY.CFG 15         execute program
          CD C:\TRIBBS                     return to BBS main directory
          BOARD                            batch file to reload BBS software

  The important line here is Line 2 - there are three items on this line:
First, the executable program, second the configuration file and third, 
an optional parameter for identifying a non-standard IRQ used by the 
comm port that the BBS node is using.  The other lines will be somewhat 
dependent on the type and setup of your particular BBS.  TriQuery can be
run in local mode by replacing the port # on the command line with "local".
(e.g. TRIQUERY TRIQUERY.CFG LOCAL)

The final step to getting the program up and running is to add the appropriate
command to one of your BBS menus or batch files.  To add TriQuery to a
TriBBS door menu, add the following line to the doors.mnu file:
          
          T,"SYSOP DEFINED TEXT",TRIQUERY.BAT,100
                                        
                                        Security level to access door
                               Name of batch file to execute door 
            The text you want to appear on your default menu
          The type of Door Drop file to use

To set up TriQuery on a TriBBS board as part of your new user logon procedure
you would simple add the the lines from the batch file (as shown above) to
the NEWUSER.BAT file.  For implementing with other BBS types, check your 
users manual for information on adding doors.

TriQuery was written in Turbo C++ using the TriDoor library written by
Mark Goodwin, TriSoft Inc. (c) 1994.

To register this software, please use the accompanying form in the
REGISTER.DOC.  If you try this program and would like to make suggestions
or comments about the program, please feel free to contact me at the address
below.  If you require support for this or any other of my products,
I can be contacted through the WME conferences: BBS Doors, Sysop Issues or
Programming; by phone at (807)767-4155; BBS (807)767-1185 or as a last resort
you can mail me at:
                    Peter Hanmore
                    265 Cascade Cres.
                    Thunder Bay, ON
                    Canada
                    P7B 6H9

If you have internet access, and would like to try other programs that I 
have written you can get them through anonymous ftp from ftp.iaccess.za in
the /pub/bbsing/tribbs/phanmore directory.  This site also holds many other
shareware/freeware BBS programs from a variety of other authors.
