X-Git-Url: http://git.indexdata.com/?p=yazproxy-moved-to-github.git;a=blobdiff_plain;f=doc%2Fusing.xml;h=c2d09b6464d58e6ca089fb59a7ac4d7c57aaf4a7;hp=add3570971fe41547396a12ad7abf16c5816c5a4;hb=9b8dda8226cff9fb0ee5bf8d7c0e88e9613df63e;hpb=b65837a1f4aadf842d112f5e37382d93f26da83d diff --git a/doc/using.xml b/doc/using.xml index add3570..c2d09b6 100644 --- a/doc/using.xml +++ b/doc/using.xml @@ -5,7 +5,7 @@ This chapter includes a few examples. - The YAZ Proxy is useful for debugging SRW/SRU/Z39.50 software, logging + The YAZ Proxy is useful for debugging SRU/Z39.50 software, logging APDUs, redirecting Z39.50 packages through firewalls, etc. Furthermore, it offers facilities that often boost performance for connection-less Z39.50 clients such @@ -129,7 +129,7 @@ be achieved by creating a configuration with the following contents: - + foo.bar.com:18398 client-apdu @@ -155,11 +155,12 @@ - Offering SRW/SRU/Z39.50 service + Offering SRU/Z39.50 service - In order to offer SRW/SRU service we must be specify sufficient - information to allow the proxy to convert from SRW/SRU to Z39.50. - This involves CQL to Type-1 (also called RPN/PQF), since most + In order to offer SRU service we must be specify sufficient + information to allow the proxy to convert from SRU to Z39.50. + This involves translating CQL queries + to Type-1 (also called RPN/PQF), since most Z39.50 servers do not support CQL. The conversion is specified by the cql2rpn element. @@ -169,7 +170,7 @@ recommended). - An explain record for the SRW/SRU service must also be created. + An explain record for the SRU service must also be created. The following is a relatively simple configuration file for @@ -179,14 +180,13 @@ given by url. - The server may return USMARC/MARC21 (Z39.50/SRW/SRU) and - MARCXML (SRW/SRU only) as specified by the + The server may return USMARC/MARC21 (Z39.50/SRU) and + MARCXML (SRU only) as specified by the syntax elements. - - + indexdata.dk 240 @@ -214,12 +214,13 @@ ]]> - The conversion from CQL to RPN is specified by the + The conversion from CQL to RPN is specified by a file whose name, + relative to the working directory, is given in the cql2rpn element. - pqf.properties. - A complete BATH/DC conversion file - pqf.properties is - part of yazproxy in sub directory etc. + A complete Bath/DC conversion file, + pqf.properties is provided as part of the + yazproxy distribution in the etc + subdirectory. Explain information is embedded in the configuration file.