doc/proxy.xml

   1  <chapter id="proxy">
   2   <title>The YAZ Proxy</title>
   3   <para>
   4    The YAZ proxy is a transparent Z39.50-to-Z39.50 gateway.  That is,
   5    it is a Z39.50 server which has as its back-end a Z39.50 client
   6    that forwards requests on to another server (known as the
   7    <firstterm>backend target</firstterm>.)
   8   </para>
   9   <para>
  10    The YAZ Proxy is useful for debugging Z39.50 software, logging
  11    APDUs, redirecting Z39.50 packages through firewalls, etc.
  12    Furthermore, it offers facilities that often
  13    boost performance for connectionless Z39.50 clients such
  14    as web gateways.
  15   </para>
  16   <para>
  17    Unlike most other server software, the proxy runs single-threaded,
  18    single-process. Every I/O operation
  19    is non-blocking so it is very lightweight and extremely fast.
  20    It does not store any state information on the hard drive,
  21    except any log files you ask for.
  22   </para>
  23
  24   <section id="proxy-example">
  25    <title>Example: Using the Proxy to Log APDUs</title>
  26    <para>
  27     Suppose you use a commercial Z39.50 client for which you do not
  28     have source code, and it's not behaving how you think it should
  29     when running against some specific server that you have no control
  30     over.  One way to diagnose the problem is to find out what packets
  31     (APDUs) are being sent and received, but not all client
  32     applications have facilities to do APDU logging.
  33    </para>
  34    <para>
  35     No problem.  Run the proxy on a friendly machine, get it to log
  36     APDUs, and point the errant client at the proxy instead of
  37     directly at the server that's causing it problems.
  38    </para>
  39    <para>
  40     Suppose the server is running on <literal>foo.bar.com</literal>,
  41     port 18398.  Run the proxy on the machine of your choice, say
  42     <literal>your.company.com</literal> like this:
  43    </para>
  44    <screen>
  45     yaz-proxy -a - -t tcp:foo.bar.com:18398 tcp:@:9000
  46    </screen>
  47    <para>
  48     (The <literal>-a -</literal> option requests APDU logging on
  49     standard output, <literal>-t tcp:foo.bar.com:18398</literal>
  50     specifies where the backend target is, and
  51     <literal>tcp:@:9000</literal> tells the proxy to listen on port
  52     9000 and accept connections from any machine.)
  53    </para>
  54    <para>
  55     Now change your client application's configuration so that instead
  56     of connecting to <literal>foo.bar.com</literal> port 18398, it
  57     connects to <literal>your.company.com</literal> port 9000, and
  58     start it up.  It will work exactly as usual, but all the packets
  59     will be sent via the proxy, which will generate a log like this:
  60    </para>
  61    <screen><![CDATA[
  62     decode choice
  63     initRequest {
  64         referenceId OCTETSTRING(len=4) 69 6E 69 74
  65         protocolVersion BITSTRING(len=1)
  66         options BITSTRING(len=2)
  67         preferredMessageSize 1048576
  68         maximumRecordSize 1048576
  69         implementationId 'Mike Taylor (id=169)'
  70         implementationName 'Net::Z3950.pm (Perl)'
  71         implementationVersion '0.31'
  72     }
  73     encode choice
  74     initResponse {
  75         referenceId OCTETSTRING(len=4) 69 6E 69 74
  76         protocolVersion BITSTRING(len=1)
  77         options BITSTRING(len=2)
  78         preferredMessageSize 1048576
  79         maximumRecordSize 1048576
  80         result TRUE
  81         implementationId '81'
  82         implementationName 'GFS/YAZ / Zebra Information Server'
  83         implementationVersion 'YAZ 1.9.1 / Zebra 1.3.3'
  84     }
  85     decode choice
  86     searchRequest {
  87         referenceId OCTETSTRING(len=1) 30
  88         smallSetUpperBound 0
  89         largeSetLowerBound 1
  90         mediumSetPresentNumber 0
  91         replaceIndicator TRUE
  92         resultSetName 'default'
  93         databaseNames {
  94             'gils'
  95         }
  96         {
  97             smallSetElementSetNames choice
  98             generic 'F'
  99         }
 100         {
 101             mediumSetElementSetNames choice
 102             generic 'B'
 103         }
 104         preferredRecordSyntax OID: 1 2 840 10003 5 10
 105         {
 106             query choice
 107             type_1 {
 108                 attributeSetId OID: 1 2 840 10003 3 1
 109                 RPNStructure choice
 110                 {
 111                     simple choice
 112                     attributesPlusTerm {
 113                         attributes {
 114                         }
 115                         term choice
 116                         general OCTETSTRING(len=7) 6D 69 6E 65 72 61 6C
 117                     }
 118                 }
 119             }
 120         }
 121     }
 122 ]]>
 123    </screen>
 124   </section>
 125
 126   <section id="proxy-target">
 127    <title>Specifying the Backend Target</title>
 128    <para>
 129     When the proxy accepts a Z39.50 client session, it
 130     determines the backend target by the following rules:
 131     <orderedlist>
 132      <listitem>
 133       <para> If the <literal>InitializeRequest</literal> PDU from the
 134        client includes an
 135        <link linkend="otherinfo-encoding"><literal>otherInfo</literal></link>
 136        element with OID
 137        <literal>1.2.840.10003.10.1000.81.1</literal>, then the
 138        contents of that element specify the target to be used, in the
 139        usual YAZ address format (typically
 140        <literal>tcp:<parameter>hostname</parameter>:<parameter>port</parameter></literal>)
 141        as described in
 142        <ulink url="http://www.indexdata.dk/yaz/doc/comstack.addresses.php"
 143         >the Addresses section of the YAZ manual</ulink>.
 144       </para>
 145      </listitem>
 146      <listitem>
 147       <para> Otherwise, the Proxy uses the default target, if one was
 148        specified on the command-line with the <literal>-t</literal>
 149        option. A default target can also be specified in the
 150        XML Config file.
 151       </para>
 152      </listitem>
 153      <listitem>
 154       <para> Otherwise, the proxy closes the connection with
 155        the client.
 156       </para>
 157      </listitem>
 158     </orderedlist>
 159    </para>
 160   </section>
 161   <section id="proxy-keepalive">
 162    <title>Keep-alive Facility</title>
 163    <para>
 164     The keep-alive is a facility where the proxy keeps the connection to the
 165     backend - even if the client closes the connection to the proxy.
 166    </para>
 167    <para>
 168     If a new or another client connects to the proxy again and requests the
 169     same backend it will be reassigned to this backend. In this case, the
 170     proxy sends an initialize response directly to the client and an
 171     initialize handshake with the backend is omitted.
 172    </para>
 173    <para>
 174     When a client reconnects, query and record caching works better, if the
 175     proxy assigns it to the same backend as before. And the result set
 176     (if any) is re-used. To achieve this, Index Data defined a session
 177     cookie which identifies the backend session.
 178    </para>
 179    <para>
 180     The cookie is defined by the client and is sent as part of the
 181     Initialize Request and passed in an
 182     <link linkend="otherinfo-encoding"><literal>otherInfo</literal></link>
 183     element with OID <literal>1.2.840.10003.10.1000.81.2</literal>.
 184    </para>
 185    <para>
 186     Clients that do not send a cookie as part of the initialize request
 187     may still better performance, since the init handshake is saved.
 188    </para>
 189   </section>
 190
 191   <section id="query-cache">
 192    <title>Query Caching</title>
 193    <para>
 194     Simple stateless clients often send identical Z39.50 searches
 195     in a relatively short period of time (e.g. in order to produce a
 196     results-list page, the next page,
 197     a single full-record, etc). And for many targets, it's
 198     much more expensive to produce a new result set than to
 199     reuse an existing one.
 200    </para>
 201    <para>
 202     The proxy tries to solve that by remembering the last query for each
 203     backend target, so that if an identical query is received next, it
 204     is turned into Present Requests rather than new Search Requests.
 205    </para>
 206    <note>
 207     <para>
 208      In a future we release will will probably allows for
 209      an arbitrary-sized cache for targets supporting named result sets.
 210     </para>
 211    </note>
 212    <para>
 213     You can enable/disable query caching using option -o.
 214    </para>
 215   </section>
 216
 217   <section id="record-cache">
 218    <title>Record Caching</title>
 219    <para>
 220     As an option, the proxy may also cache result set records for the
 221     last search.
 222     The proxy takes into account the Record Syntax and CompSpec.
 223     The CompSpec includes simple element set names as well.
 224     By default the cache is 200000 bytes per session.
 225    </para>
 226   </section>
 227
 228   <section id="query-validation">
 229    <title>Query Validation</title>
 230    <para>
 231     The Proxy may also be configured to trap particular attributes in
 232     Type-1 queries and send Bib-1 diagnostics back to the client without
 233     even consulting the backend target. This facility may be useful if
 234     a target does not properly issue diagnostics when unsupported attributes
 235     are send to it.
 236    </para>
 237   </section>
 238
 239   <section id="record-validation">
 240    <title>Record Syntax Validation</title>
 241    <para>
 242     The proxy may be configured to accept, reject or convert records.
 243     When accepted, the target passes search/present requests to the
 244     backend target under the assumption that the target can honor the
 245     request (In fact it may not do that). When a record is rejected because
 246     the record syntax is "unsupported" the proxy returns a diagnostic to the
 247     client. Finally, the proxy may convert records.
 248    </para>
 249    <para>
 250     In the current version the only supported conversion is
 251     MARC21/USMARC in MARC-8 charset to MARCXML in UTF-8. Future version of
 252     the proxy may do other record/charset conversions.
 253    </para>
 254   </section>
 255
 256   <section id="other-optimizations">
 257    <title>Other Optimizations</title>
 258    <para>
 259     We've had some plans to support global caching of result set records,
 260     but this has not yet been implemented.
 261    </para>
 262   </section>
 263
 264   <section id="proxy-config-file">
 265    <title>Proxy Configuration File</title>
 266    <para>
 267     The Proxy as an option may read a configuration file using option
 268     <literal>-c</literal> followed by the filename of a config file.
 269     </para>
 270    <para>
 271     The config file is in XML format. The YAZ proxy must be compiled
 272     with <ulink url="http://www.xmlsoft.org/">libxml2</ulink> and
 273     <ulink url="http://xmlsoft.org/XSLT/">libXSLT</ulink> support in
 274     order for the config file facility to be enabled.
 275    </para>
 276    <tip>
 277     <para>To check for a config file to be well-formed, the yaz-proxy may
 278      be invoked without specifying a listening port, i.e.
 279      <screen>
 280       yaz-proxy -c myconfig.xml
 281      </screen>
 282      If this does not produce errors, the file is well-formed.
 283     </para>
 284    </tip>
 285    <section id="proxy-config-header">
 286     <title>Proxy Configuration Header</title>
 287     <para>
 288      The proxy config file must have a root element called
 289      <literal>proxy</literal>. All information except an optional XML
 290      header must be stored within the <literal>proxy</literal> element.
 291     </para>
 292     <screen>
 293      &lt;?xml version="1.0"?>
 294      &lt;proxy>
 295       &lt;!-- content here .. -->
 296      &lt;/proxy>
 297     </screen>
 298     </section>
 299    <section id="proxy-config-target">
 300     <title>Configuration: target</title>
 301     <para>
 302      The element <literal>target</literal> which may be repeated zero
 303      or more times with parent element <literal>proxy</literal> contains
 304      information about each backend target.
 305      The <literal>target</literal> element have two attributes:
 306      <literal>name</literal> which holds the logical name of the backend
 307      target (required) and <literal>default</literal> (optional) which
 308      (when given) specifies that the backend target is the default target -
 309      equivalent to command line option <literal>-t</literal>.
 310     </para>
 311     <para>
 312      <screen>
 313      &lt;?xml version="1.0"?>
 314      &lt;proxy>
 315       &lt;target name="server1" default="1">
 316        &lt;!-- description of server1 .. -->
 317       &lt;/target>
 318       &lt;target name="server2">
 319        &lt;!-- description of server2 .. -->
 320       &lt;/target>
 321      &lt;/proxy>
 322      </screen>
 323     </para>
 324    </section>
 325    <section id="proxy-config-url">
 326     <title>Configuration:url</title>
 327     <para>
 328      The <literal>url</literal> which may be repeated one or more times
 329      should be the child of the <literal>target</literal> element.
 330      The CDATA of <literal>url</literal> is the Z-URL of the backend.
 331     </para>
 332     <para>
 333      Multiple <literal>url</literal> element may be used. In that case, then
 334      a client initiates a session, the proxy chooses the URL with the lowest
 335      number of active sessions, thereby distributing the load. It is
 336      assumed that each URL represents the same database (data).
 337     </para>
 338    </section>
 339    <section id="proxy-config-keepalive">
 340     <title>Configuration: keepalive</title>
 341     <para>The <literal>keepalive</literal> element holds information about
 342      the keepalive Z39.50 sessions. Keepalive sessions are proxy-to-backend
 343      sessions that is no longer associated with a client session.
 344     </para>
 345     <para>The <literal>keepalive</literal> element which is the child of
 346      the <literal>target</literal>holds two elements:
 347      <literal>bandwidth</literal> and <literal>pdu</literal>.
 348      The <literal>bandwidth</literal> is the maximum total bytes
 349      transferred to/from the target. If a target session exceeds this
 350      limit, it is shut down (and no longer kept alive).
 351      The <literal>pdu</literal> is the maximum number of requests sent
 352      to the target. If a target session exceeds this limit, it is
 353      shut down. The idea of these two limits is that avoid very long
 354      sessions that use resources in a backend (that leaks!).
 355     </para>
 356     <para>
 357      The following sets maximum number of bytes transferred in a
 358      target session to 1 MB and maxinum of requests to 400.
 359      <screen>
 360       &lt;keepalive>
 361        &lt;bandwidth>1048576&lt;/bandwidth>
 362        &lt;retrieve>400&lt;/retrieve>
 363       &lt;/keepalive>
 364      </screen>
 365     </para>
 366    </section>
 367    <section id="proxy-config-limit">
 368     <title>Configuration: limit</title>
 369     <para>
 370      The <literal>limit</literal> section specifies bandwidth/pdu requests
 371      limits for an active session.
 372      The proxy records bandwidth/pdu requests during the last 60 seconds
 373      (1 minute). The <literal>limit</literal> may include the
 374      elements <literal>bandwidth</literal>, <literal>pdu</literal>,
 375      and <literal>retrieve</literal>. The <literal>bandwidth</literal>
 376      measures the number of bytes transferred within the last minute.
 377      The <literal>pdu</literal> is the number of requests in the last
 378      minute. The <literal>retrieve</literal> holds the maximum records to
 379      be retrieved in one Present Request.
 380     </para>
 381     <para>
 382      If a bandwidth/pdu limit is reached the proxy will postpone the
 383      requests to the target and wait one or more seconds. The idea of the
 384      limit is to ensure that clients that downloads hundreds or thousands of
 385      records do not hurt other users.
 386     </para>
 387     <para>
 388      The following sets maximum number of bytes transferred per minute to
 389      500Kbytes and maximum number of requests to 40.
 390      <screen>
 391       &lt;limit>
 392        &lt;bandwidth>524288&lt;/bandwidth>
 393        &lt;retrieve>40&lt;/retrieve>
 394       &lt;/limit>
 395      </screen>
 396     </para>
 397     <note>
 398      <para>
 399       Typically the limits for keepalive are much higher than
 400       those for session minute average.
 401      </para>
 402     </note>
 403    </section>
 404
 405    <section id="proxy-config-attribute">
 406     <title>Configuration: attribute</title>
 407     <para>
 408      The <literal>attribute</literal> element specifies accept or reject
 409      or a particular attribute type, value pair.
 410      Well-behaving targets will reject unsupported attributes on their
 411      own. This feature is useful for targets that do not gracefully
 412      handle unsupported attributes.
 413     </para>
 414     <para>
 415      Attribute elements may be repeated. The proxy inspects the attribute
 416      specifications in the order as specified in the configuration file.
 417      When a given attribute specification matches a given attribute list
 418      in a query, the proxy takes appropriate action (reject, accept).
 419     </para>
 420     <para>
 421      If no attribute specifications matches the attribute list in a query,
 422      it is accepted.
 423     </para>
 424     <para>
 425      The <literal>attribute</literal> element has two required attributes:
 426      <literal>type</literal> which is the Attribute Type-1 type, and
 427      <literal>value</literal> which is the Attribute Type-1 value.
 428      The special value/type <literal>*</literal> matches any attribute
 429      type/value. A value may also be specified as a list with each
 430      value separated by comma, a value may also be specified as a
 431      list: low value - dash - high value.
 432     </para>
 433     <para>
 434      If attribute <literal>error</literal> is given, that holds a
 435      Bib-1 diagnostic which is sent to the client if the particular
 436      type, value is part of a query.
 437     </para>
 438     <para>
 439      If attribute <literal>error</literal> is not given, the attribute
 440      type, value is accepted and passed to the backend target.
 441     </para>
 442     <para>
 443      A target that supports use attributes 1,4, 1000 through 1003 and
 444      no other use attributes, could use the following rules:
 445      <screen>
 446       &lt;attribute type="1" value="1,4,1000-1003">
 447       &lt;attribute type="1" value="*" error="114"/>
 448      </screen>
 449     </para>
 450    </section>
 451
 452    <section id="proxy-config-syntax">
 453     <title>Configuration: syntax</title>
 454     <para>
 455      The <literal>syntax</literal> element specifies accept or reject
 456      or a particular record syntax request from the client.
 457     </para>
 458     <para>
 459      The <literal>syntax</literal> has one required attribute:
 460      <literal>type</literal> which is the Preferred Record Syntax.
 461     </para>
 462     <para>
 463      If attribute <literal>error</literal> is given, that holds a
 464      Bib-1 diagnostic which is sent to the client if the particular
 465      record syntax is part of a present - or search request.
 466     </para>
 467     <para>
 468      If attribute <literal>error</literal> is not given, the record syntax
 469      is accepted and passed to the backend target.
 470     </para>
 471     <para>
 472      If attribute <literal>marcxml</literal> is given, the proxy will
 473      perform MARC21 to MARCXML conversion. In this case the
 474      <literal>type</literal> should be XML. The proxy will use
 475      preferred record syntax USMARC/MARC21 against the backend target.
 476     </para>
 477     <para>To accept USMARC and offer MARCXML XML records but reject
 478      all other requests the following configuration could be used:
 479      <screen>
 480       &lt;proxy>
 481        &lt;target name="mytarget">
 482         &lt;syntax type="usmarc"/>
 483         &lt;syntax type="xml" marcxml="1"/>
 484         &lt;syntax type="*" error="238"/>
 485        &lt;/target>
 486       &lt;/proxy>
 487      </screen>
 488     </para>
 489    </section>
 490
 491    <section id="proxy-config-target-timeout">
 492     <title>Configuration: target-timeout</title>
 493     <para>
 494      The element <literal>target-timeout</literal> is the child of element
 495      <literal>target</literal> and specifies the amount in seconds before
 496      a target session is shut down.
 497     </para>
 498     <para>
 499      This can also be specified on the command line by using option
 500      <literal>-T</literal>. Refer to <xref linkend="proxy-usage"/>.
 501     </para>
 502    </section>
 503
 504    <section id="proxy-config-client-timeout">
 505     <title>Configuration: client-timeout</title>
 506     <para>
 507      The element <literal>client-timeout</literal> is the child of element
 508      <literal>target</literal> and specifies the amount in seconds before
 509      a client session is shut down.
 510      </para>
 511     <para>
 512      This can also be specified on the command line by using option
 513      <literal>-i</literal>. Refer to <xref linkend="proxy-usage"/>.
 514     </para>
 515    </section>
 516
 517    <section id="proxy-config-preinit">
 518     <title>Configuration: preinit</title>
 519     <para>
 520      The element <literal>preinit</literal> is the child of element
 521      <literal>target</literal> and specifies the number of spare
 522      connection to a target. By default no spare connection are
 523      created by the proxy. If the proxy uses a target exclusive or
 524      a lot, the preinit session will ensure that target sessions
 525      have been made before the client makes a connection and will therefore
 526      reduce the connect-init handshake dramatically. Never set this to
 527      more than 5.
 528     </para>
 529    </section>
 530
 531    <section id="proxy-config-max-clients">
 532     <title>Configuration: max-clients</title>
 533     <para>
 534      The element <literal>max-clients</literal> is the child of element
 535      <literal>proxy</literal> and specifies the total number of
 536      allowed connections to targets (all targets). If this limit
 537      is reached the proxy will close the least recently used connection.
 538     </para>
 539     <para>
 540      Note, that many Unix systems impose a system on the number of
 541      open files allowed in a single process, typically in the
 542      range 256 (Solaris) to 1024 (Linux).
 543      The proxy uses 2 sockets per session + a few files
 544      for logging. As a rule of thumb, ensure that 2*max-clients + 5
 545      can be opened by the proxy process.
 546     </para>
 547     <tip>
 548      <para>
 549       Using the <ulink url="http://www.gnu.org/software/bash/bash.html">
 550        bash</ulink> shell, you can set the limit with
 551       <literal>ulimit -n</literal><replaceable>no</replaceable>.
 552        Use <literal>ulimit -a</literal> to display limits.
 553      </para>
 554      </tip>
 555    </section>
 556
 557    <section id="proxy-config-log">
 558     <title>Configuration: log</title>
 559     <para>
 560      The element <literal>log</literal> is the child of element
 561      <literal>proxy</literal> and specifies what to be logged by the
 562      proxy.
 563      </para>
 564     <para>
 565      Specify the log file with command-line option <literal>-l</literal>.
 566     </para>
 567     <para>
 568      The text of the <literal>log</literal> element is a sequence of
 569      options separated by white space. See the table below:
 570      <table frame="top"><title>Logging options</title>
 571       <tgroup cols="2">
 572        <colspec colwidth="1*" colname="option"/>
 573        <colspec colwidth="2*" colname="description"/>
 574        <thead>
 575         <row>
 576          <entry>Option</entry>
 577          <entry>Description</entry>
 578         </row>
 579        </thead>
 580        <tbody>
 581         <row>
 582          <entry><literal>client-apdu</literal></entry>
 583          <entry>
 584           Log APDUs as reported by YAZ for the
 585           communication between the client and the proxy.
 586           This facility is equivalent to the APDU logging that
 587           happens when using option <literal>-a</literal>, however
 588           this tells the proxy to log in the same file as given
 589           by <literal>-l</literal>.
 590          </entry>
 591         </row>
 592         <row>
 593          <entry><literal>server-apdu</literal></entry>
 594          <entry>
 595           Log APDUs as reported by YAZ for the
 596           communication between the proxy and the server (backend).
 597          </entry>
 598         </row>
 599         <row>
 600          <entry><literal>clients-requests</literal></entry>
 601          <entry>
 602           Log a brief description about requests transferred between
 603           the client and the proxy. The name of the request and the size
 604           of the APDU is logged.
 605          </entry>
 606         </row>
 607         <row>
 608          <entry><literal>server-requests</literal></entry>
 609          <entry>
 610           Log a brief description about requests transferred between
 611           the proxy and the server (backend). The name of the request
 612           and the size of the APDU is logged.
 613          </entry>
 614         </row>
 615        </tbody>
 616       </tgroup>
 617      </table>
 618     </para>
 619     <para>
 620      To log communication in details between the proxy and the backend, th
 621      following configuration could be used:
 622     <screen><![CDATA[
 623      <target name="mytarget">
 624       <log>server-apdu server-requests</log>
 625      </target>
 626 ]]>
 627      </screen>
 628     </para>
 629    </section>
 630
 631   </section>
 632   <section id="proxy-usage">
 633    <title>Proxy Usage</title>
 634    <para>
 635    </para>
 636    <refentry id="yaz-proxy">
 637     &yaz-proxy-ref;
 638    </refentry>
 639   </section>
 640   <section id="otherinfo-encoding"><title>OtherInformation Encoding</title>
 641    <para>
 642     The proxy uses the OtherInformation definition to carry
 643     information about the target address and cookie.
 644    </para>
 645    <screen>
 646   OtherInformation   ::= [201] IMPLICIT SEQUENCE OF SEQUENCE{
 647     category           [1]   IMPLICIT InfoCategory OPTIONAL,
 648     information        CHOICE{
 649       characterInfo            [2]  IMPLICIT InternationalString,
 650       binaryInfo               [3]  IMPLICIT OCTET STRING,
 651       externallyDefinedInfo    [4]  IMPLICIT EXTERNAL,
 652       oid                      [5]  IMPLICIT OBJECT IDENTIFIER}}
 653 --
 654   InfoCategory ::= SEQUENCE{
 655       categoryTypeId   [1]   IMPLICIT OBJECT IDENTIFIER OPTIONAL,
 656       categoryValue    [2]   IMPLICIT INTEGER}
 657   </screen>
 658    <para>
 659      The <literal>categoryTypeId</literal> is either
 660      OID 1.2.840.10003.10.1000.81.1, 1.2.840.10003.10.1000.81.2
 661      for proxy target and proxy cookie respectively. The
 662      integer element <literal>category</literal> is set to 0.
 663      The value proxy and cookie is stored in element
 664      <literal>characterInfo</literal> of the <literal>information</literal>
 665      choice.
 666     </para>
 667    </section>
 668  </chapter>
 669  <!-- Keep this comment at the end of the file
 670  Local variables:
 671  mode: sgml
 672  sgml-omittag:t
 673  sgml-shorttag:t
 674  sgml-minimize-attributes:nil
 675  sgml-always-quote-attributes:t
 676  sgml-indent-step:1
 677  sgml-indent-data:t
 678  sgml-parent-document: "yaz++.xml"
 679  sgml-local-catalogs: nil
 680  sgml-namecase-general:t
 681  End:
 682  -->
 683