
This directory contains several shell scripts that you can run to test or
demo the shsql test case database.  Valid output for many of the test runs
is located in the COMPARE directory for comparison w/ your output using diff(1)
(lines containing pathnames will differ).

These test scripts are designed to leave data as originally found, so they can 
be run again and again.  

Included is a simple shell script to run any available test script, and 
automatically compare its result against the known standard result:

runcompare battery1




test script	description
------------    ------------

battery1	- self-contained test battery I

battery2	- self-contained test battery II

createindexes1	- create indexes on journalcits and curcits.  
		  This may be run before invoking 'selects3', 'selects4' or 'joins1'.

selects1	- test CONTAINS, and WORD INDEX

selects2	- test retrievals using the assays table

battery3	- self-contained test of deletes and updates on a copy of the assays table

joins1		- joins, including an outer join

stream		- test 'create stream'

concur		- concurrency test.  Invokes several instances of 'concur_sub' asynchronously.

shsqloptions	- test various output formats eg. xml, etc.


[ The following tests require the larger test database, ]
[ downloadable from http://midriff.sourceforge.net      ]

createindexes50  - create indexes on nzplaces
		  This should be run before invoking the scripts below..

selects50	- test various 'select' commands on a "large" table

selects51	- select commands involving 'OR' 

joins50		- additional joins involving a "large" table

ctest1		- C program that runs nested retrievals on 2 channels.. it issues
		  a large number of retrievals on a "large" table and is useful for 
		  testing for exhausted file descriptors, etc.  
		  (to build ctest1 you'll need to go back to the sqlsrc directory and 
		  type: make ctest1)

snp50		- test that sets up a direct index on a "large" ordinary file located
		  somewhere in your file system (you need to specify) and runs a retrieval

