X-Git-Url: http://jsfdemo.indexdata.com/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fyaz-ztest-man.xml;h=a6002e662fa5e5d7f213ad89abfc375118243f3b;hb=f7291976f3a89b9695650b3624cbc514490ccb28;hp=965c15aad27a5d085ff14fe506966c45d9b0859b;hpb=d940392c53c32ccf76fb287cc5b997b9e921a431;p=yaz-moved-to-github.git
diff --git a/doc/yaz-ztest-man.xml b/doc/yaz-ztest-man.xml
index 965c15a..a6002e6 100644
--- a/doc/yaz-ztest-man.xml
+++ b/doc/yaz-ztest-man.xml
@@ -1,5 +1,5 @@
-
%local;
@@ -15,26 +15,28 @@
YAZ
&version;
+ Index Data
-
+
yaz-ztest
8
+ System management commands
-
+
yaz-ztest
- Z39.50 Test Server
+ Z39.50/SRU Test Server
-
+
&gfs-synopsis;
DESCRIPTION
- yaz-ztest is a Z39.50 test server that uses
- the YAZ generic frontend server API.
- The server acts as a real Z39.50 server but does not use a database.
+ yaz-ztest is a Z39.50/SRU test server that uses
+ the YAZ generic frontend server (GFS) API.
+ The server acts as a real Z39.50/SRU server but does not use a database.
It returns a random hit count and returns a subset of a few built-in
records.
@@ -58,6 +60,52 @@
OPTIONS
&gfs-options;
+
+ TESTING
+
+ yaz-ztest normally returns a random hit count between
+ 0 and 24. However, if a query term includes leading digits, then the
+ integer value of that term is used as hit count. This allows testers
+ to return any number of hits. yaz-ztest includes
+ 24 MARC records for testing. Hit counts exceeding 24 will make
+ yaz-ztest return the same record batch over and over..
+ So record at position 1, 25, 49, etc .. are equivalent.
+
+
+ The following databases are honored by yaz-ztest:
+ Default, slow
+ and db.* (all databases with prefix "db"). Any
+ other database will make yaz-ztest return diagnostic
+ 109: "Database unavailable".
+
+
+ Options for search may be included in the form or URL get arguments
+ included as part of the Z39.50 database name. The following
+ database options are present: search-delay,
+ present-delay, fetch-delay
+ and seed.
+
+
+ The former, delay type options, specify
+ a fake delay (sleep) that yaz-ztest will perform
+ when searching, presenting, fetching records respectively.
+ The value of the delay may either be a fixed floating point
+ value which specifies the delay in seconds.
+ Alternatively the value may be given as two floating point numbers
+ separated by colon, which wil make yaz-ztest perform
+ a random sleep between the first and second number.
+
+
+ The database parameter seed takes an integer
+ as value. This will call srand with this integer to
+ ensure that the random behavior can be re-played.
+
+
+ Suppose we want searches to take between 0.1 and 0.5 seconds and
+ a fetch to take 0.2 second. To access test database Default we'd use:
+ Default?search-delay=0.1:0.5&fetch-delay=0.2.
+
+
GFS CONFIGURATION AND VIRTUAL HOSTS
&gfs-virtual;