Rearrange sections
[yazproxy-moved-to-github.git] / doc / reference.xml
1  <chapter id="proxy-reference">
2   <title>Proxy Reference</title>
3   <section id="proxy-operation">
4    <title>Operating Environment</title>
5    <para>
6     The YAZ proxy is a single program. After startup it spawns 
7     a child process (except on Windows or if option -X is given). 
8     The child process is the core of the proxy and it handles all
9     communication with clients and servers. The parent process
10     will restart the child process if it dies unexpectedly and report
11     the reason. For options for YAZ proxy,
12     see <xref linkend="proxy-usage"/>.
13    </para>
14    <para>
15     As an option, the proxy may change user identity to a less privileged
16     user.
17    </para>
18   </section>
19   <section id="proxy-target">
20    <title>Choosing the Backend Server</title>
21    <para>
22     When the proxy receives a Z39.50 Initialize Request from a Z39.50
23     client, it determines the backend server by the following rules:
24     <orderedlist>
25      <listitem>
26       <para>If the <literal>InitializeRequest</literal> PDU from the
27        client includes an 
28        <link linkend="otherinfo-encoding"><literal>otherInfo</literal></link>
29        element with OID
30        <literal>1.2.840.10003.10.1000.81.1</literal>, then the
31        contents of that element specify the server to be used, in the
32        usual YAZ address format (typically
33        <literal>tcp:<parameter>hostname</parameter>:<parameter>port</parameter></literal>)
34        as described in
35        <ulink url="http://www.indexdata.dk/yaz/doc/comstack.addresses.tkl"
36         >the Addresses section of the YAZ manual</ulink>.
37       </para>
38      </listitem>
39
40      <listitem>
41       <para>Otherwise, the Proxy uses the default server, if one was
42        specified in the proxy configuration file. See
43        <xref linkend="proxy-config-target"/>.
44       </para>
45      </listitem>
46
47      <listitem>
48       <para>Otherwise, the Proxy uses the default server, if one was
49        specified on the command-line with the <literal>-t</literal>
50        option.
51       </para>
52      </listitem>
53      <listitem>
54       <para>Otherwise, the proxy closes the connection with
55        the client.
56       </para>
57      </listitem>
58     </orderedlist>
59    </para>
60    <para>
61     If the proxy receives an SRW/SRU request, the following rules are used.
62     <orderedlist>
63      <listitem>
64       <para>If default target has Explain information with a
65        <literal>database</literal> that matches the path of the
66         HTTP request of SRW/SRU that backend server is used for
67        SRW/SRU operation.
68        </para>
69      </listitem>
70      <listitem>
71       <para>
72        Otherwise the service will return HTTP 404 (Not found).
73       </para>
74      </listitem>
75     </orderedlist>
76    </para>
77    <note>
78     <para>
79      We know it is stupid to only check for explain in default target.
80      It means that it is only possible to offer one SRW/SRU server.
81      We expect to improve that in the next version of the YAZ proxy.
82     </para>
83    </note>
84   </section>
85   <section id="proxy-keepalive">
86    <title>Keep-alive Facility</title>
87    <para>
88     The keep-alive is a facility where the proxy keeps the connection to the
89     backend server - even if the client closes the connection to the proxy.
90    </para>
91    <para>
92     If a new or another client connects to the proxy again and requests the
93     same backend it will be reassigned to this backend. In this case, the
94     proxy sends an initialize response directly to the client and an
95     initialize handshake with the backend is omitted.
96    </para>
97    <para>
98     When a client reconnects, query and record caching works better, if the
99     proxy assigns it to the same backend as before. And the result set
100     (if any) is re-used. To achieve this, Index Data defined a session
101     cookie which identifies the backend session.
102    </para>
103    <para>
104     The cookie is defined by the client and is sent as part of the
105     Initialize Request and passed in an
106     <link linkend="otherinfo-encoding"><literal>otherInfo</literal></link>
107     element with OID <literal>1.2.840.10003.10.1000.81.2</literal>.
108    </para>
109    <para>
110     Clients that do not send a cookie as part of the initialize request
111     may still better performance, since the init handshake is saved.
112    </para>
113    <para>
114     Refer to <xref linkend="proxy-config-keepalive"/> on how to setup
115     configuration parameters for keepalive.
116     </para>
117   </section>
118   
119   
120   <section id="query-cache">
121    <title>Query Caching</title>
122    <para>
123     Simple stateless clients often send identical Z39.50 searches
124     in a relatively short period of time (e.g. in order to produce a
125     results-list page, the next page,
126     a single full-record, etc). And for many targets, it's
127     much more expensive to produce a new result set than to
128     reuse an existing one.
129    </para>
130    <para>
131     The proxy tries to solve that by remembering the last query for each
132     backend target, so that if an identical query is received next, it
133     is turned into Present Requests rather than new Search Requests.
134    </para>
135    <note>
136     <para>
137      In a future we release will will probably allows for
138      an arbitrary-sized cache for targets supporting named result sets.
139     </para>
140    </note>
141    <para>
142     You can enable/disable query caching using option -o.
143    </para>
144   </section>
145   
146   <section id="record-cache">
147    <title>Record Caching</title>
148    <para>
149     As an option, the proxy may also cache result set records for the
150     last search.
151     The proxy takes into account the Record Syntax and CompSpec.
152     The CompSpec includes simple element set names as well.
153     By default the cache is 200000 bytes per session.
154    </para>
155   </section>
156   
157   <section id="query-validation">
158    <title>Query Validation</title>
159    <para>
160     The Proxy may also be configured to trap particular attributes in
161     Type-1 queries and send Bib-1 diagnostics back to the client without
162     even consulting the backend target. This facility may be useful if
163     a target does not properly issue diagnostics when unsupported attributes
164     are send to it.
165    </para>
166   </section>
167   
168    <section id="record-validation">
169    <title>Record Syntax Validation</title>
170    <para>
171     The proxy may be configured to accept, reject or convert records.
172     When accepted, the target passes search/present requests to the
173     backend target under the assumption that the target can honor the
174     request (In fact it may not do that). When a record is rejected because
175     the record syntax is "unsupported" the proxy returns a diagnostic to the
176     client. Finally, the proxy may convert records.
177    </para>
178    <para>
179     The proxy can convert from MARC to MARCXML and thereby offer an
180     XML version of any MARC record as long as it is ISO2709 encoded.
181     If the proxy is compiled with libXSLT support it can also
182     perform XSLT on XML.
183    </para>
184   </section>
185   
186   <section id="other-optimizations">
187    <title>Other Optimizations</title>
188    <para>
189     We've had some plans to support global caching of result set records,
190     but this has not yet been implemented.
191    </para>
192   </section>
193    
194   <section id="proxy-config-file">
195    <title>Proxy Configuration File</title>
196    <para>
197     The Proxy may read a configuration file using option
198     <literal>-c</literal> followed by the filename of a config file.
199    </para>
200    <para>
201     The config file is XML based. The YAZ proxy must be compiled 
202     with <ulink url="http://www.xmlsoft.org/">libxml2</ulink> and
203     <ulink url="http://xmlsoft.org/XSLT/">libXSLT</ulink> support in
204     order for the config file facility to be enabled.
205    </para>
206    <para>
207     See <xref linkend="yazproxy-schema"/> for an XML schema
208     for the configuration.
209    </para>
210    <tip>
211     <para>To check for a config file to be well-formed, the yazproxy may
212      be invoked without specifying a listening port, i.e.
213      <screen>
214       yazproxy -c myconfig.xml
215      </screen>
216      If this does not produce errors, the file is well-formed.
217     </para>
218    </tip>
219    <section id="proxy-config-header">
220     <title>Proxy Configuration Header</title>
221     <para>
222      The proxy config file must have a root element called
223      <literal>proxy</literal> and scoped within namespace
224      <literal> xmlns="http://indexdata.dk/yazproxy/schema/0.8/</literal>.
225      All information except an optional XML header must be stored
226      within the <literal>proxy</literal> element.
227     </para>
228     <screen>
229      &lt;?xml version="1.0"?>
230      &lt;proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/">
231       &lt;!-- content here .. -->
232      &lt;/proxy>
233     </screen>
234    </section>
235    <section id="proxy-config-target">
236     <title>target</title>
237     <para>
238      The element <literal>target</literal> which may be repeated zero
239      or more times with parent element <literal>proxy</literal> contains
240      information about each backend target.
241      The <literal>target</literal> element have two attributes:
242      <literal>name</literal> which holds the logical name of the backend
243      target (required) and <literal>default</literal> (optional) which
244      (when given) specifies that the backend target is the default target -
245      equivalent to command line option <literal>-t</literal>.
246     </para>
247     <para>
248      <screen>
249      &lt;?xml version="1.0"?>
250      &lt;proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/">
251       &lt;target name="server1" default="1">
252        &lt;!-- description of server1 .. -->
253       &lt;/target>
254       &lt;target name="server2">
255        &lt;!-- description of server2 .. -->
256       &lt;/target>
257      &lt;/proxy>
258      </screen>
259     </para>
260    </section>
261    <section id="proxy-config-url">
262     <title>url</title>
263     <para>
264      The <literal>url</literal> which may be repeated one or more times
265      should be the child of the <literal>target</literal> element.
266      The CDATA of <literal>url</literal> is the Z-URL of the backend.
267     </para>
268     <para>
269      Multiple <literal>url</literal> element may be used. In that case, then
270      a client initiates a session, the proxy chooses the URL with the lowest
271      number of active sessions, thereby distributing the load. It is
272      assumed that each URL represents the same database (data).
273     </para>
274    </section>
275
276    <section id="proxy-config-target-timeout">
277     <title>target-timeout</title>
278     <para>
279      The element <literal>target-timeout</literal> is the child of element
280      <literal>target</literal> and specifies the amount in seconds before
281      a target session is shut down.
282     </para>
283     <para>
284      This can also be specified on the command line by using option
285      <literal>-T</literal>. Refer to OPTIONS in <xref linkend="proxy-usage"/>.
286     </para>
287    </section>
288
289    <section id="proxy-config-client-timeout">
290     <title>client-timeout</title>
291     <para>
292      The element <literal>client-timeout</literal> is the child of element
293      <literal>target</literal> and specifies the amount in seconds before
294      a client session is shut down.
295      </para>
296     <para>
297      This can also be specified on the command line by using option
298      <literal>-i</literal>.  Refer to OPTIONS in <xref linkend="proxy-usage"/>.
299     </para>
300    </section>
301
302    <section id="proxy-config-keepalive">
303     <title>keepalive</title>
304     <para>The <literal>keepalive</literal> element holds information about
305      the keepalive Z39.50 sessions. Keepalive sessions are proxy-to-backend
306      sessions that is no longer associated with a client session.
307     </para>
308     <para>The <literal>keepalive</literal> element which is the child of
309      the <literal>target</literal>holds two elements:
310      <literal>bandwidth</literal> and <literal>pdu</literal>.
311      The <literal>bandwidth</literal> is the maximum total bytes
312      transferred to/from the target. If a target session exceeds this
313      limit, it is shut down (and no longer kept alive). 
314      The <literal>pdu</literal> is the maximum number of requests sent
315      to the target. If a target session exceeds this limit, it is
316      shut down. The idea of these two limits is that avoid very long
317      sessions that use resources in a backend (that leaks!).
318     </para>
319     <para>
320      The following sets maximum number of bytes transferred in a
321      target session to 1 MB and maximum of requests to 400.
322      <screen>
323       &lt;keepalive>
324        &lt;bandwidth>1048576&lt;/bandwidth>
325        &lt;retrieve>400&lt;/retrieve>
326       &lt;/keepalive>
327      </screen>
328     </para>
329    </section>
330    <section id="proxy-config-limit">
331     <title>limit</title>
332     <para>
333      The <literal>limit</literal> section specifies bandwidth/pdu requests
334      limits for an active session.
335      The proxy records bandwidth/pdu requests during the last 60 seconds
336      (1 minute). The <literal>limit</literal> may include the
337      elements <literal>bandwidth</literal>, <literal>pdu</literal>,
338      and <literal>retrieve</literal>. The <literal>bandwidth</literal>
339      measures the number of bytes transferred within the last minute.
340      The <literal>pdu</literal> is the number of requests in the last
341      minute. The <literal>retrieve</literal> holds the maximum records to
342      be retrieved in one Present Request.
343     </para>
344     <para>
345      If a bandwidth/pdu limit is reached the proxy will postpone the
346      requests to the target and wait one or more seconds. The idea of the
347      limit is to ensure that clients that downloads hundreds or thousands of
348      records do not hurt other users.
349     </para>
350     <para>
351      The following sets maximum number of bytes transferred per minute to
352      500Kbytes and maximum number of requests to 40.
353      <screen>
354       &lt;limit>
355        &lt;bandwidth>524288&lt;/bandwidth>
356        &lt;retrieve>40&lt;/retrieve>
357       &lt;/limit>
358      </screen>
359     </para>
360     <note>
361      <para>
362       Typically the limits for keepalive are much higher than
363       those for session minute average.
364      </para>
365     </note>
366    </section>
367    
368    <section id="proxy-config-attribute">
369     <title>attribute</title>
370     <para>
371      The <literal>attribute</literal> element specifies accept or reject
372      or a particular attribute type, value pair.
373      Well-behaving targets will reject unsupported attributes on their
374      own. This feature is useful for targets that do not gracefully
375      handle unsupported attributes.
376     </para>
377     <para>
378      Attribute elements may be repeated. The proxy inspects the attribute
379      specifications in the order as specified in the configuration file.
380      When a given attribute specification matches a given attribute list
381      in a query, the proxy takes appropriate action (reject, accept).
382     </para>
383     <para>
384      If no attribute specifications matches the attribute list in a query,
385      it is accepted.
386     </para>
387     <para>
388      The <literal>attribute</literal> element has two required attributes:
389      <literal>type</literal> which is the Attribute Type-1 type, and
390      <literal>value</literal> which is the Attribute Type-1 value.
391      The special value/type <literal>*</literal> matches any attribute
392      type/value. A value may also be specified as a list with each
393      value separated by comma, a value may also be specified as a
394      list: low value - dash - high value.
395     </para>
396     <para>
397      If attribute <literal>error</literal> is given, that holds a 
398      Bib-1 diagnostic which is sent to the client if the particular
399      type, value is part of a query.
400     </para>
401     <para>
402      If attribute <literal>error</literal> is not given, the attribute
403      type, value is accepted and passed to the backend target.
404     </para>
405     <para>
406      A target that supports use attributes 1,4, 1000 through 1003 and
407      no other use attributes, could use the following rules:
408      <screen>
409       &lt;attribute type="1" value="1,4,1000-1003">
410       &lt;attribute type="1" value="*" error="114"/>
411      </screen>
412     </para>
413    </section>
414    <section id="proxy-config-syntax">
415     <title>syntax</title>
416     <para>
417      The <literal>syntax</literal> element specifies accept or reject
418      or a particular record syntax request from the client.
419     </para>
420     <para>
421      The <literal>syntax</literal> has one required attribute:
422      <literal>type</literal> which is the Preferred Record Syntax.
423     </para>
424     <para>
425      If attribute <literal>error</literal> is given, that holds a 
426      Bib-1 diagnostic which is sent to the client if the particular
427      record syntax is part of a present - or search request.
428     </para>
429     <para>
430      If attribute <literal>error</literal> is not given, the record syntax
431      is accepted and passed to the backend target.
432     </para>
433     <para>
434      If attribute <literal>marcxml</literal> is given, the proxy will
435      perform MARC21 to MARCXML conversion. In this case the
436      <literal>type</literal> should be XML. The proxy will use
437      preferred record syntax USMARC/MARC21 against the backend target.
438     </para>
439     <para>
440      If attribute <literal>stylesheet</literal> is given, the proxy
441      will convert XML record from server via XSLT. It is important
442      that the content from server is XML. If used in conjunction with
443      attribute <literal>marcxml</literal> the MARC to MARCXML conversion
444      takes place before the XSLT conversion takes place.
445     </para>
446     <para>
447      If attribute <literal>identifier</literal> is given that is the
448      SRW/SRU record schema identifier for the resulting output record (after
449      MARCXML and/or XSLT conversion). 
450     </para>
451     <para>
452      If sub element <literal>title</literal> is given (as child element
453      of <literal>syntax</literal>, then that is the official SRW/SRU
454      name of the resulting record schema.
455     </para>
456     <para>
457      If sub element <literal>name</literal> is given that is an alias
458      for the record schema identifier. Multiple <literal>name</literal>s
459      may be specified.
460     </para>
461     <example>
462      <title>MARCXML conversion</title>
463      <para>To accept USMARC and offer MARCXML XML plus Dublin Core (via
464       XSLT conversion) but the following configuration could be used:
465       <screen>
466        &lt;proxy>
467        &lt;target name="mytarget">
468        ..
469        &lt;syntax type="usmarc"/>
470        &lt;syntax type="xml" marcxml="1"
471         identifier="info:srw/schema/1/marcxml-v1.1"
472         &lt;title>MARCXML&lt;title>
473         &lt;name>marcxml&lt;name>
474        &lt;syntax>
475        &lt;syntax type="xml" marcxml="1" stylesheet="MARC21slim2SRWDC.xsl"
476         identifier="info:srw/schema/1/dc-v1.1">
477         &lt;title>Dublin Core&lt;title>
478         &lt;name>dc&lt;name>
479        &lt;syntax>
480        &lt;syntax type="*" error="238"/>
481        ..
482        &lt;/target>
483        &lt;/proxy>
484       </screen>
485     </para>
486     </example>
487
488    </section>
489
490    <section id="proxy-config-explain">
491     <title>explain</title>
492     <para>
493      The <literal>explain</literal> element includes Explain information
494      for SRW/SRU about the server in the target section. This
495      information must have a <literal>serverInfo</literal> element
496      with a database that this target must be available as (URL path).
497      For example,
498      <screen><![CDATA[
499       <explain xmlns="http://explain.z3950.org/dtd/2.0/">     
500         <serverInfo>
501           <host>myhost.org</host>
502           <port>8000</port>
503           <database>mydatabase</database>
504         </serverInfo>
505         <!-- remaining Explain stuff -->
506       </explain>
507       ]]>
508      </screen>
509      In the above case, the SRW/SRU service is available as
510      <literal>http://myhost.org:8000/mydatabase</literal>.
511     </para>
512     
513    </section>
514
515    <section id="proxy-config-cql2rpn">
516     <title>cql2rpn</title>
517     <para>
518      The CDATA of <literal>cql2rpn</literal> refers to CQL to a RPN conversion
519      file - for the server in the target section. This element
520      is required for SRW/SRU searches to operate against a Z39.50
521      server that doesn't support CQL. Most Z39.50 servers only support
522      Type-1/RPN so this is usually required.
523      See YAZ documentation for more information about the
524      <ulink url="http://indexdata.dk/yaz/doc/tools.tkl#tools.cql.pqf">CQL
525       to PQF</ulink> conversion. See also the
526      <filename>pqf.properties</filename> in the <filename>etc</filename> 
527      (or <replaceable>prefix/share/yazproxy</replaceable>)
528      directory of the YAZ proxy.
529     </para>
530    </section>
531    
532    <section id="proxy-config-preinit">
533     <title>preinit</title>
534     <para>
535      The element <literal>preinit</literal> is the child of element
536      <literal>target</literal> and specifies the number of spare
537      connection to a target. By default no spare connection are
538      created by the proxy. If the proxy uses a target exclusive or
539      a lot, the preinit session will ensure that target sessions
540      have been made before the client makes a connection and will therefore
541      reduce the connect-init handshake dramatically. Never set this to
542      more than 5.
543     </para>
544    </section>
545
546    <section id="proxy-config-max-clients">
547     <title>max-clients</title>
548     <para>
549      The element <literal>max-clients</literal> is the child of element
550      <literal>proxy</literal> and specifies the total number of
551      allowed connections to targets (all targets). If this limit
552      is reached the proxy will close the least recently used connection.
553     </para>
554     <para>
555      Note, that many Unix systems impose a system on the number of
556      open files allowed in a single process, typically in the 
557      range 256 (Solaris) to 1024 (Linux).
558      The proxy uses 2 sockets per session + a few files
559      for logging. As a rule of thumb, ensure that 2*max-clients + 5
560      can be opened by the proxy process.
561     </para>
562     <tip>
563      <para>
564       Using the <ulink url="http://www.gnu.org/software/bash/bash.html">
565        bash</ulink> shell, you can set the limit with
566       <literal>ulimit -n</literal><replaceable>no</replaceable>. 
567        Use <literal>ulimit -a</literal> to display limits.
568      </para>
569      </tip>
570    </section>
571
572    <section id="proxy-config-log">
573     <title>log</title>
574     <para>
575      The element <literal>log</literal> is the child of element
576      <literal>proxy</literal> and specifies what to be logged by the
577      proxy.
578      </para>
579     <para>
580      Specify the log file with command-line option <literal>-l</literal>.
581     </para>
582     <para>
583      The text of the <literal>log</literal> element is a sequence of
584      options separated by white space. See the table below:
585      <table frame="top"><title>Logging options</title>
586       <tgroup cols="2">
587        <colspec colwidth="1*"/>
588        <colspec colwidth="2*"/><thead>
589         <row>
590          <entry>Option</entry>
591          <entry>Description</entry>
592         </row>
593        </thead>
594        <tbody>
595         <row>
596          <entry><literal>client-apdu</literal></entry>
597          <entry>
598           Log APDUs as reported by YAZ for the
599           communication between the client and the proxy.
600           This facility is equivalent to the APDU logging that
601           happens when using option <literal>-a</literal>, however
602           this tells the proxy to log in the same file as given
603           by <literal>-l</literal>.
604          </entry>
605         </row>
606         <row>
607          <entry><literal>server-apdu</literal></entry>
608          <entry>
609           Log APDUs as reported by YAZ for the
610           communication between the proxy and the server (backend).
611          </entry>
612         </row>
613         <row>
614          <entry><literal>clients-requests</literal></entry>
615          <entry>
616           Log a brief description about requests transferred between
617           the client and the proxy. The name of the request and the size
618           of the APDU is logged.
619          </entry>
620         </row>
621         <row>
622          <entry><literal>server-requests</literal></entry>
623          <entry>
624           Log a brief description about requests transferred between
625           the proxy and the server (backend). The name of the request
626           and the size of the APDU is logged.
627          </entry>
628         </row>
629        </tbody>
630       </tgroup>
631      </table>
632     </para>
633     <para>
634      To log communication in details between the proxy and the backend, th
635      following configuration could be used:
636      <screen><![CDATA[
637       <target name="mytarget">
638        <log>server-apdu server-requests</log>
639       </target>
640       ]]>
641      </screen>
642     </para>
643    </section>
644   </section>
645   <section id="proxy-usage">
646    <title>Proxy Usage (man page)</title>
647    <refentry id="yazproxy-man">
648     &yaz-proxy-ref;
649    </refentry>
650   </section>
651   
652   <section id="otherinfo-encoding">
653    <title>OtherInformation Encoding</title>
654    <para>
655     The proxy uses the OtherInformation definition to carry
656     information about the target address and cookie.
657    </para>
658    <screen>
659   OtherInformation   ::= [201] IMPLICIT SEQUENCE OF SEQUENCE{
660     category           [1]   IMPLICIT InfoCategory OPTIONAL, 
661     information        CHOICE{
662       characterInfo            [2]  IMPLICIT InternationalString,
663       binaryInfo               [3]  IMPLICIT OCTET STRING,
664       externallyDefinedInfo    [4]  IMPLICIT EXTERNAL,
665       oid                      [5]  IMPLICIT OBJECT IDENTIFIER}}
666 --
667   InfoCategory ::= SEQUENCE{
668       categoryTypeId   [1]   IMPLICIT OBJECT IDENTIFIER OPTIONAL,
669       categoryValue    [2]   IMPLICIT INTEGER}
670   </screen>
671    <para>
672     The <literal>categoryTypeId</literal> is either
673     OID 1.2.840.10003.10.1000.81.1, 1.2.840.10003.10.1000.81.2
674     for proxy target and proxy cookie respectively. The
675     integer element <literal>category</literal> is set to 0.
676     The value proxy and cookie is stored in element
677     <literal>characterInfo</literal> of the <literal>information</literal>
678      choice.
679    </para>
680   </section>
681   <section id="yazproxy-schema">
682    <title>YAZ Proxy Configuration Schema</title>
683    <para>
684     Here an XML Schema for the YAZ proxy configuration file. 
685     The schema, <filename>yazproxy.xsd</filename> is located in sub
686     directory <filename>etc</filename> of the distribution.
687    </para>
688    <screen><![CDATA[
689     <?xml version="1.0"?>
690 <!-- XML Schema for YAZ proxy config file.
691     $Id: reference.xml,v 1.5 2004-04-21 13:08:21 adam Exp $
692 -->
693 <xs:schema
694   xmlns:xs="http://www.w3.org/2001/XMLSchema"
695   xmlns:exp="http://explain.z3950.org/dtd/2.0/"
696   xmlns="http://indexdata.dk/yazproxy/schema/0.8/"
697   targetNamespace="http://indexdata.dk/yazproxy/schema/0.8/"
698   >
699  <xs:import namespace="http://explain.z3950.org/dtd/2.0/" 
700       schemaLocation="zeerex-2.0.xsd"/>
701  <xs:element name="proxy">
702   <xs:complexType>
703    <xs:sequence>
704     <xs:element ref="target" minOccurs="0" maxOccurs="unbounded"/>
705     <xs:element ref="max-clients" minOccurs="0"/>
706     <xs:element ref="log" minOccurs="0"/>
707    </xs:sequence>
708   </xs:complexType>
709  </xs:element>
710
711  <xs:element name="target">
712   <xs:complexType>
713    <xs:sequence>
714      <xs:element ref="url" minOccurs="0" maxOccurs="unbounded"/>
715      <xs:element ref="target-timeout" minOccurs="0"/>
716      <xs:element ref="client-timeout" minOccurs="0"/>
717      <xs:element ref="keepalive" minOccurs="0"/>
718      <xs:element ref="limit" minOccurs="0"/>
719      <xs:element ref="attribute" minOccurs="0" maxOccurs="unbounded"/>
720      <xs:element ref="syntax" minOccurs="0" maxOccurs="unbounded"/>
721      <xs:element ref="preinit" minOccurs="0"/>
722      <xs:element name="exp:explain" minOccurs="0"/>
723      <xs:element ref="cql2rpn" minOccurs="0"/>
724    </xs:sequence>
725    <xs:attribute name="default" type="xs:string" use="optional"/>
726    <xs:attribute name="name" type="xs:string"/>
727   </xs:complexType>
728  </xs:element>
729
730  <xs:element name="url" type="xs:string"/>
731  <xs:element name="target-timeout" type="xs:integer"/>
732  <xs:element name="client-timeout" type="xs:integer"/>
733  <xs:element name="bandwidth" type="xs:integer"/>
734  <xs:element name="pdu" type="xs:integer"/>
735  <xs:element name="retrieve" type="xs:integer"/>
736  <xs:element name="preinit" type="xs:integer"/>
737  <xs:element name="cql2rpn" type="xs:string"/>
738
739  <xs:element name="keepalive">
740   <xs:complexType>
741    <xs:sequence>
742     <xs:element ref="bandwidth" minOccurs="0"/>
743     <xs:element ref="pdu" minOccurs="0"/>
744    </xs:sequence>
745   </xs:complexType>
746  </xs:element>
747  <xs:element name="limit">
748   <xs:complexType>
749    <xs:sequence>
750     <xs:element ref="bandwidth" minOccurs="0"/>
751     <xs:element ref="pdu" minOccurs="0"/>
752     <xs:element ref="retrieve" minOccurs="0"/>
753    </xs:sequence>
754   </xs:complexType>
755  </xs:element>
756  
757  <xs:element name="attribute">
758   <xs:complexType>
759    <xs:attribute name="type" type="xs:string"/>
760    <xs:attribute name="value" type="xs:string"/>
761    <xs:attribute name="error" type="xs:integer"/>
762   </xs:complexType>
763  </xs:element>
764
765  <xs:element name="syntax">
766   <xs:complexType>
767    <xs:sequence>
768     <xs:element name="title" type="xs:string" minOccurs="0"/>
769     <xs:element name="name" type="xs:string" minOccurs="0"
770                                              maxOccurs="unbounded"/>
771    </xs:sequence>
772    <xs:attribute name="error" type="xs:string" minOccurs="0"/>
773    <xs:attribute name="type" type="xs:string" minOccurs="0"/>
774    <xs:attribute name="marcxml" type="xs:string" minOccurs="0"/>
775    <xs:attribute name="identifier" type="xs:string" minOccurs="0"/>
776    <xs:attribute name="stylesheet" type="xs:string" minOccurs="0"/>
777   </xs:complexType>
778  </xs:element>
779
780  <xs:element name="max-clients" type="xs:integer"/>
781  <xs:element name="log" type="xs:string"/>
782
783 </xs:schema>
784
785 ]]>
786    </screen>
787   </section>
788  </chapter>
789
790  <!-- Keep this comment at the end of the file
791  Local variables:
792  mode: sgml
793  sgml-omittag:t
794  sgml-shorttag:t
795  sgml-minimize-attributes:nil
796  sgml-always-quote-attributes:t
797  sgml-indent-step:1
798  sgml-indent-data:t
799  sgml-parent-document: "yazproxy.xml"
800  sgml-local-catalogs: nil
801  sgml-namecase-general:t
802  End:
803  -->
804