X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fusing.xml;h=0dd2e3dced045df74c23d03d7ed3f3f5e558fcb1;hb=343901a04fab67869d432a4c93f5c6e1046ae6a5;hp=add3570971fe41547396a12ad7abf16c5816c5a4;hpb=b65837a1f4aadf842d112f5e37382d93f26da83d;p=yazproxy-moved-to-github.git diff --git a/doc/using.xml b/doc/using.xml index add3570..0dd2e3d 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,14 @@ 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 +215,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.