X-Git-Url: http://lists.indexdata.dk/cgi-bin?a=blobdiff_plain;f=doc%2Fyaz-ztest-man.xml;h=30bcba10aae1b3ba32a5aef63bf0ac05d7e5bf02;hb=refs%2Ftags%2Fv5.14.0;hp=14f743c4e2fe7f10061bee6b3fc5c74ebfcb1aff;hpb=f3027244f210c7014b46dc564e868bbdf10560e2;p=yaz-moved-to-github.git
diff --git a/doc/yaz-ztest-man.xml b/doc/yaz-ztest-man.xml
index 14f743c..30bcba1 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.
@@ -62,14 +64,30 @@
TESTING
yaz-ztest normally returns a random hit count between
- 0 and 24. However, if a query term includes leading digits, then the
+ 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
+ 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.
+ For XML if no element set is given or element has value "marcxml",
+ MARCXML is returned (each of the 24 dummy records converted from
+ ISO2709 to XML). For element set OP, OPAC XML is returned.
+
+
+ yaz-ztest may also return predefined XML records (for testing).
+ This is enabled if YAZ_ZTEST_XML_FETCH environment
+ variable is defined. A record is fetched form a file (one record per file).
+ The path for the filename is
+ FE.d.xml
+ where F is the YAZ_ZTEST_XML_FETCH value
+ (possibly
+ empty), E is element-set,
+ d is record position (starting from 1).
+
+
The following databases are honored by yaz-ztest:
Default, slow
and db.* (all databases with prefix "db"). Any
@@ -94,7 +112,7 @@
a random sleep between the first and second number.
- The database parameter seed takes an integer
+ 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.
@@ -131,15 +149,7 @@