doc/yaz-client-commands.xml

   1 <!--
   2    $Id: yaz-client-commands.xml,v 1.21 2007-11-21 09:04:46 adam Exp $
   3    Commands for YAZ client.
   4    Included in both manual and man page for yaz-client.
   5 -->
   6 <variablelist>
   7  <varlistentry id="command-open"><term>
   8    <literal>open </literal><replaceable>zurl</replaceable>
   9   </term>
  10   <listitem>
  11    <para>Opens a connection to a server. The syntax for
  12     <replaceable>zurl</replaceable> is the same as described
  13     above for connecting from the command line.
  14    </para>
  15    <para>
  16     Syntax:
  17    </para>
  18    <para>
  19     [<literal>(tcp|ssl|unix|http)':'</literal>]<replaceable>host</replaceable>
  20     [:<replaceable>port</replaceable>][/<replaceable>base</replaceable>]
  21    </para>
  22   </listitem>
  23  </varlistentry>
  24  <varlistentry><term>
  25    <literal>quit</literal>
  26   </term>
  27   <listitem>
  28    <para>Quits YAZ client</para>
  29   </listitem>
  30  </varlistentry>
  31  <varlistentry id="command-find"><term>
  32    <literal>find </literal><replaceable>query</replaceable></term>
  33   <listitem>
  34    <para>Sends a Search Request using the <replaceable>query</replaceable>
  35     given. By default the query is assumed to be PQF. See command
  36     <link linkend="command-querytype">querytype</link> for more information.
  37    </para>
  38   </listitem>
  39  </varlistentry>
  40  <varlistentry><term>
  41    <literal>delete</literal> <replaceable>setname</replaceable></term>
  42   <listitem>
  43    <para>Deletes result set with name <replaceable>setname</replaceable>
  44     on the server.</para>
  45   </listitem>
  46  </varlistentry>
  47  <varlistentry><term>
  48    <literal>base </literal><replaceable>base1</replaceable>
  49    <replaceable>base2</replaceable> ...
  50   </term>
  51   <listitem>
  52    <para>Sets the name(s) of the database(s) to search. One or more
  53     databases may be specified separated by blanks. This commands overrides
  54     the database given in <replaceable>zurl</replaceable>.
  55    </para>
  56   </listitem>
  57  </varlistentry>
  58  <varlistentry><term>
  59    <literal>show </literal>
  60    [<replaceable>start</replaceable>[+<replaceable>number</replaceable>]]
  61   </term>
  62   <listitem>
  63    <para>Fetches records by sending a Present Request from the start
  64     position given by
  65     <replaceable>start</replaceable>
  66     a number of records given by <replaceable>number</replaceable>. If
  67     <replaceable>start</replaceable> is not given, then the client
  68     will fetch from position of the last retrieved record plus 1. If
  69     <replaceable>number</replaceable> is not given, then one record will
  70     be fetched at a time.
  71    </para>
  72   </listitem>
  73  </varlistentry>
  74  <varlistentry><term>
  75    <literal>scan</literal> <replaceable>term</replaceable>
  76   </term>
  77   <listitem>
  78    <simpara>Scans
  79     database index for a term. The syntax resembles the syntax
  80     for <link linkend="command-find"><literal>find</literal></link>.
  81     If you want to scan for the word <literal>water</literal> you could
  82     write
  83    </simpara>
  84    <screen>
  85     scan water
  86    </screen>
  87    <simpara>
  88     but if you want to scan only in, say the title field, you would write
  89    </simpara>
  90    <screen>
  91     scan @attr 1=4 water
  92    </screen>
  93   </listitem>
  94  </varlistentry>
  95  <varlistentry><term>
  96    <literal>setscan</literal> <replaceable>set</replaceable> <replaceable>term</replaceable>
  97   </term>
  98   <listitem>
  99    <simpara>Scans database index for a term within a result set. This
 100     is similar to the scan command but has a result set as its first argument.
 101    </simpara>
 102   </listitem>
 103  </varlistentry>
 104  <varlistentry><term>
 105    <literal>scanpos</literal> <replaceable>pos</replaceable>
 106   </term>
 107   <listitem>
 108    <simpara>
 109     Sets preferred position for scan. This value
 110     is used in next scan. By default position is 1.
 111    </simpara>
 112   </listitem>
 113  </varlistentry>
 114  <varlistentry><term>
 115    <literal>scansize</literal> <replaceable>size</replaceable>
 116   </term>
 117   <listitem>
 118    <simpara>
 119     Sets number of entries to be returned by scan. Default
 120     number of entries is 20.
 121    </simpara>
 122   </listitem>
 123  </varlistentry>
 124  <varlistentry><term>
 125    <literal>scanstep</literal> <replaceable>step</replaceable>
 126   </term>
 127   <listitem>
 128    <simpara>
 129     Set step-size for scan. This value is used in next scan
 130     sent to the target. By default step-size is 0.
 131    </simpara>
 132   </listitem>
 133  </varlistentry>
 134  <varlistentry id="sortspec"><term>
 135    <literal>sort</literal> <replaceable>sortspecs</replaceable>
 136   </term>
 137   <listitem>
 138    <para>Sorts a result set. The sort command takes a
 139     sequence of space-separated sort specifications, with each sort
 140     specification consisting of two space-separated words (so that the
 141     whole specification list is made up of an even number of words).
 142     The first word of each specification
 143     holds a field (sort criterion) and the second holds flags.
 144     If the sort criterion includes <literal>=</literal> it is assumed
 145     that the <literal>SortKey</literal> is of type
 146     <literal>sortAttributes</literal> using Bib-1: in this case
 147     the integer before <literal>=</literal> is
 148     the attribute type and the integer following <literal>=</literal>
 149     is the attribute value.
 150     If no <literal>=</literal> is in the criterion it is treated as a
 151     sortfield of type InternationalString.
 152     The flags word of each sort specification must consist of
 153     <literal>s</literal>
 154     for case sensitive or <literal>i</literal> for case insensitive, and
 155     <literal>&lt;</literal> for ascending order or <literal>&gt;</literal>
 156     for descending order.
 157    </para>
 158   </listitem>
 159  </varlistentry>
 160  <varlistentry><term>
 161    <literal>sort+</literal>
 162   </term>
 163   <listitem>
 164    <para>Same as <literal>sort</literal> but stores the sorted
 165     result set in a new result set.
 166    </para>
 167   </listitem>
 168  </varlistentry>
 169  <varlistentry><term>
 170    <literal>authentication</literal> <replaceable>openauth</replaceable>
 171   </term>
 172   <listitem>
 173    <para>Sets up a authentication string if a server requires
 174     authentication (v2 OpenStyle). The authentication string is first
 175     sent to the server when the
 176     <link linkend="command-open"><literal>open</literal></link> command is
 177     issued and the Z39.50 Initialize Request is sent, so this command
 178     must be used before <literal>open</literal> in order to be effective.
 179     A common convention for the <replaceable>authopen</replaceable> string
 180     is that the username - and password is separated by a slash, e.g.
 181     <literal>myusername/mysecret</literal>.
 182    </para>
 183   </listitem>
 184  </varlistentry>
 185
 186  <varlistentry><term>
 187    <literal>sru</literal> <replaceable>method</replaceable> <replaceable>version</replaceable>
 188   </term>
 189   <listitem>
 190    <para>Selects SRU method and version.
 191     Must be one of <literal>POST</literal>,
 192     <literal>GET</literal>, <literal>SOAP</literal> (default). Version
 193     should be either 1.1 or 1.2. Other versions are allowed - for testing
 194     purposes (version negotiation with SRU server).
 195    </para>
 196   </listitem>
 197  </varlistentry>
 198
 199  <varlistentry><term>
 200    <literal>list_all</literal>
 201   </term>
 202   <listitem>
 203    <para>This command displays status and values for many settings.
 204    </para>
 205   </listitem>
 206  </varlistentry>
 207
 208  <varlistentry><term>
 209    <literal>lslb</literal> <replaceable>n</replaceable>
 210   </term>
 211   <listitem>
 212    <para>Sets the limit for when no records should be returned
 213     together with the search result.
 214     See the
 215     <ulink
 216      url="http://www.loc.gov/z3950/agency/markup/04.html#3.2.2.1.6">
 217      Z39.50 standard
 218     </ulink>
 219     for more details.
 220    </para>
 221   </listitem>
 222  </varlistentry>
 223
 224  <varlistentry><term>
 225    <literal>ssub</literal> <replaceable>n</replaceable>
 226   </term>
 227   <listitem>
 228    <para>Sets the limit for when all records should be returned with
 229     the search result.
 230     See the
 231     <ulink
 232      url="http://www.loc.gov/z3950/agency/markup/04.html#3.2.2.1.6">
 233      Z39.50 standard
 234     </ulink> for more details.
 235    </para>
 236   </listitem>
 237  </varlistentry>
 238
 239  <varlistentry><term>
 240    <literal>mspn</literal> <replaceable>n</replaceable>
 241   </term>
 242   <listitem>
 243    <para>Sets the number of records should be returned if the
 244     number of records in the result set is between the values of
 245     <literal>lslb</literal> and <literal>ssub</literal>.
 246     See the
 247     <ulink
 248      url="http://www.loc.gov/z3950/agency/markup/04.html#3.2.2.1.6">
 249      Z39.50 standard
 250     </ulink>
 251     for more details.
 252    </para>
 253   </listitem>
 254  </varlistentry>
 255  <varlistentry><term>
 256    <literal>status</literal>
 257   </term>
 258   <listitem>
 259    <para>Displays the values of <literal>lslb</literal>,
 260     <literal>ssub</literal> and <literal>mspn</literal>.
 261    </para>
 262   </listitem>
 263  </varlistentry>
 264  <varlistentry><term>
 265    <literal>setname</literal>
 266   </term>
 267   <listitem>
 268    <para>Switches named result sets on and off. Default is on.
 269    </para>
 270   </listitem>
 271  </varlistentry>
 272  <varlistentry><term>
 273    <literal>cancel</literal>
 274   </term>
 275   <listitem>
 276    <para>Sends a Trigger Resource Control Request to the target.
 277    </para>
 278   </listitem>
 279  </varlistentry>
 280  <varlistentry><term>
 281    <literal>format</literal> <replaceable>oid</replaceable>
 282   </term>
 283   <listitem>
 284    <para>Sets the preferred transfer syntax for retrieved records.
 285     yaz-client supports all the record syntaxes that currently
 286     are registered. See
 287     <ulink
 288      url="http://www.loc.gov/z3950/agency/defns/oids.html#5">
 289      Z39.50 Standard
 290     </ulink>
 291     for more details. Commonly used records syntaxes include usmarc,
 292     sutrs, grs1 and xml.
 293    </para>
 294   </listitem>
 295  </varlistentry>
 296  <varlistentry><term>
 297    <literal>elements</literal> <replaceable>e</replaceable>
 298   </term>
 299   <listitem>
 300    <para>Sets the element set name for the records. Many targets support
 301     element sets are B (for brief) and F (for full).
 302    </para>
 303   </listitem>
 304  </varlistentry>
 305  <varlistentry><term>
 306    <literal>close</literal>
 307   </term>
 308   <listitem>
 309    <para>Sends a Z39.50 Close APDU and closes connection with the peer
 310    </para>
 311   </listitem>
 312  </varlistentry>
 313  <varlistentry id="command-querytype"><term>
 314    <literal>querytype</literal> <replaceable>type</replaceable>
 315   </term>
 316   <listitem>
 317    <para>Sets the query type as used by command
 318    <link linkend="command-find"><literal>find</literal></link>.
 319     The following is supported:
 320     <literal>prefix</literal> for
 321         <link linkend="PQF">Prefix Query Notation</link> (Type-1 Query);
 322     <literal>ccl</literal> for CCL search (Type-2 Query),
 323     <literal>cql</literal> for CQL (Type-104 search with CQL OID),
 324     <literal>ccl2rpn</literal> for
 325         <link linkend="CCL">CCL</link> to RPN conversion (Type-1 Query).
 326     <literal>cql2rpn</literal> for
 327         CQL to RPN conversion (Type-1 Query).
 328    </para>
 329   </listitem>
 330  </varlistentry>
 331  <varlistentry><term>
 332    <literal>attributeset</literal> <replaceable>set</replaceable>
 333   </term>
 334   <listitem>
 335    <para>
 336     Sets attribute set OID for prefix queries (RPN, Type-1).
 337    </para>
 338   </listitem>
 339  </varlistentry>
 340  <varlistentry><term>
 341    <literal>refid</literal> <replaceable>id</replaceable>
 342   </term>
 343   <listitem>
 344    <para>Sets reference ID for Z39.50 Request(s).
 345    </para>
 346   </listitem>
 347  </varlistentry>
 348  <varlistentry><term>
 349    <literal>itemorder</literal>
 350    <replaceable>type</replaceable> <replaceable>no</replaceable>
 351   </term>
 352   <listitem>
 353    <para>Sends an Item Order Request using the ILL External.
 354     <replaceable>type</replaceable> is either 1 or 2 which corresponds to
 355     ILL-Profile 1 and 2 respectively. The <replaceable>no</replaceable>
 356     is the Result Set position of the record to be ordered.
 357    </para>
 358   </listitem>
 359  </varlistentry>
 360  <varlistentry><term>
 361    <literal>update</literal>
 362    <replaceable>action</replaceable>
 363    <replaceable>recid</replaceable>
 364    <replaceable>doc</replaceable>
 365   </term>
 366   <listitem>
 367    <para>Sends Item Update Request. The <replaceable>action</replaceable>
 368     argument must be the action type: one of <literal>insert</literal>,
 369     <literal>replace</literal>, <literal>delete</literal> and
 370     <literal>update</literal>. The second argument,
 371     <replaceable>recid</replaceable>, is the
 372     record identifier (any string). Third argument which is optional is
 373     the record document for the request. If doc is a quoted string
 374     (double quotes) the string content is used verbatim. If doc is not
 375     a quoted string, it is assumed to be a filename which is read, then
 376     sent as the docuemnt content. If doc is omitted, the last received
 377     record (as parf of present response or piggybacked search response)
 378     is used for the update.
 379    </para>
 380   </listitem>
 381  </varlistentry>
 382
 383  <varlistentry><term>
 384    <literal>source</literal>
 385    <replaceable>filename</replaceable>
 386   </term>
 387   <listitem>
 388    <para>Executes list of commands from
 389     file <replaceable>filename</replaceable>, just like source on
 390     most UNIX shells. A single dot (<literal>.</literal>) can be used
 391     as an alternative.
 392    </para>
 393   </listitem>
 394  </varlistentry>
 395
 396  <varlistentry><term>
 397    <literal>!</literal>
 398    <replaceable>args</replaceable>
 399   </term>
 400   <listitem>
 401    <para>Executes command <replaceable>args</replaceable> in subshell
 402     using the <literal>system</literal> call.
 403    </para>
 404   </listitem>
 405  </varlistentry>
 406
 407  <varlistentry><term>
 408    <literal>push_command</literal>
 409    <replaceable>command</replaceable>
 410   </term>
 411   <listitem>
 412    <para>The push_command takes another command as its argument.
 413     That command is then added to the history information (so
 414     you can retrieve it later). The command itself is not
 415     executed. This command only works if you have GNU readline/history
 416     enabled.
 417    </para>
 418   </listitem>
 419  </varlistentry>
 420
 421  <varlistentry><term>
 422    <literal>set_apdufile</literal>
 423    <replaceable>filename</replaceable>
 424   </term>
 425   <listitem>
 426    <para>Sets that APDU should be logged to file
 427     <replaceable>filename</replaceable>. Another way to achieve
 428     APDU log is by using command-line option <literal>-a</literal>.
 429    </para>
 430   </listitem>
 431  </varlistentry>
 432
 433  <varlistentry><term>
 434    <literal>set_auto_reconnect</literal>
 435    <replaceable>flag</replaceable>
 436   </term>
 437   <listitem>
 438    <para>Specifies whether YAZ client automatically reconnect if
 439     target closes connection (Z39.50 only).
 440    </para>
 441    <para>
 442     <replaceable>flag</replaceable> must be either
 443     <literal>on</literal> or <literal>off</literal>.
 444    </para>
 445   </listitem>
 446  </varlistentry>
 447
 448  <varlistentry id="command-set-auto-wait"><term>
 449    <literal>set_auto_wait</literal>
 450    <replaceable>flag</replaceable>
 451   </term>
 452   <listitem>
 453    <para>Specifies whether YAZ client should wait for
 454    response protocol packages after a request.
 455    By default YAZ client waits (on) for response packages immediately
 456    after a command (find, show) has been issued. If <literal>off</literal>
 457    is used, YAZ client does not attempt to receive packages automatically.
 458    These will have to be manually received when command
 459    <link linkend="command-wait-response">
 460     <literal>wait_response</literal>
 461    </link> is used.
 462    </para>
 463    <para>
 464    <replaceable>flag</replaceable> must be either
 465    <literal>on</literal> or <literal>off</literal>.
 466    </para>
 467   </listitem>
 468  </varlistentry>
 469
 470  <varlistentry><term>
 471    <literal>set_marcdump</literal>
 472    <replaceable>filename</replaceable>
 473   </term>
 474   <listitem>
 475    <para>Specifies that all retrieved records should be appended to
 476     file <replaceable>filename</replaceable>. This command does the
 477     thing as option <literal>-m</literal>.
 478    </para>
 479   </listitem>
 480  </varlistentry>
 481
 482  <varlistentry><term>
 483    <literal>schema</literal>
 484    <replaceable>schemaid</replaceable>
 485   </term>
 486   <listitem>
 487    <para>Specifies schema for retrieval.
 488     Schema may be specified as an OID for Z39.50.
 489     For SRU, schema is a simple string URI.
 490    </para>
 491   </listitem>
 492  </varlistentry>
 493
 494  <varlistentry id="command-charset"><term>
 495    <literal>charset</literal>
 496    <replaceable>negotiationcharset</replaceable>
 497    [<replaceable>displaycharset</replaceable>]
 498    [[<replaceable>marccharset</replaceable>]]
 499   </term>
 500   <listitem>
 501    <para>Specifies character set (encoding) for Z39.50
 502     negotiation / SRU encoding and/or character set for output (terminal).
 503    </para>
 504    <para>
 505     <replaceable>negotiationcharset</replaceable> is the name
 506     of the character set to be negotiated by the server. The special name
 507     <literal>-</literal> for <replaceable>negotiationcharset</replaceable>
 508     specifies <emphasis>no</emphasis> character set to be negotiated.
 509    </para>
 510    <para>
 511     If <replaceable>displaycharset</replaceable> is given, it specifies name
 512     of the character set of the output (on the terminal on which
 513     YAZ client is running). To disable conversion of characters
 514     to the output encoding, the special name <literal>-</literal> (dash)
 515     can be used.
 516     If the special name <literal>auto</literal> is given, YAZ client will
 517     convert strings to the encoding of the
 518     terminal as returned by <function>nl_langinfo</function> call.
 519    </para>
 520    <para>
 521     If <replaceable>marcharset</replaceable> is given, it specifies name
 522     of the character set of retrieved MARC records from server. See
 523     also <literal>marcharset</literal> command.
 524    </para>
 525    <note>
 526     <para>
 527      Since character set negotation takes effect in the Z39.50
 528      Initialize Request you should issue this command before
 529      command <link linkend="command-open"><literal>open</literal></link>
 530      is used.
 531     </para>
 532    </note>
 533    <note>
 534     <para>
 535      MARC records are not covered by Z39.50 character set negotiation,
 536      so that's why there is a separate character that must be known
 537      in order to do meaningful converson(s).
 538     </para>
 539    </note>
 540   </listitem>
 541  </varlistentry>
 542
 543  <varlistentry><term>
 544    <literal>negcharset</literal>
 545    <replaceable>charset</replaceable>
 546   </term>
 547   <listitem>
 548    <para>Specifies character set for negotiation (Z39.50). The
 549     argument is the same as second argument for command
 550     <link linkend="command-charset"><literal>charset</literal></link>.
 551    </para>
 552   </listitem>
 553  </varlistentry>
 554
 555  <varlistentry><term>
 556    <literal>displaycharset</literal>
 557    <replaceable>charset</replaceable>
 558   </term>
 559   <listitem>
 560    <para>Specifies character set for output (display). The
 561     argument is the same as second argument for command
 562     <link linkend="command-charset"><literal>charset</literal></link>.
 563    </para>
 564   </listitem>
 565  </varlistentry>
 566
 567  <varlistentry><term>
 568    <literal>marccharset</literal>
 569    <replaceable>charset</replaceable>
 570   </term>
 571   <listitem>
 572    <para>Specifies character set for retrieved MARC records so
 573     that YAZ client can display them in a character suitable
 574     for your display. See <literal>charset</literal> command.
 575     If <literal>auto</literal> is given, YAZ will assume
 576     that MARC21/USMARC is using MARC8/UTF8 and ISO-8859-1
 577     for all other MARC variants. The charset argument is the
 578     same as third argument for command
 579     <link linkend="command-charset"><literal>charset</literal></link>.
 580    </para>
 581   </listitem>
 582  </varlistentry>
 583
 584  <varlistentry><term>
 585    <literal>querycharset</literal>
 586    <replaceable>charset</replaceable>
 587   </term>
 588   <listitem>
 589    <para>Specifies character set for query terms for Z39.50 RPN
 590     queries and Z39.50 Scan Requests (termListAndStartPoint).
 591     This is a pure client-side conversion which converts from
 592     displayCharset to queryCharset.
 593    </para>
 594   </listitem>
 595  </varlistentry>
 596
 597  <varlistentry><term>
 598    <literal>set_cclfile</literal>
 599    <replaceable>filename</replaceable>
 600   </term>
 601   <listitem>
 602    <para>Specifies that CCL fields should be read from file
 603     file <replaceable>filename</replaceable>. This command does the
 604     thing as option <literal>-c</literal>.
 605    </para>
 606   </listitem>
 607  </varlistentry>
 608
 609  <varlistentry><term>
 610    <literal>set_cqlfile</literal>
 611    <replaceable>filename</replaceable>
 612   </term>
 613   <listitem>
 614    <para>Specifies that CQL fields should be read from file
 615     file <replaceable>filename</replaceable>. This command does the
 616     thing as option <literal>-q</literal>.
 617    </para>
 618   </listitem>
 619  </varlistentry>
 620
 621  <varlistentry><term>
 622    <literal>register_oid</literal>
 623    <replaceable>name</replaceable>
 624    <replaceable>class</replaceable>
 625    <replaceable>OID</replaceable>
 626   </term>
 627   <listitem>
 628    <para>This command allows you to register your own object
 629     identifier - so that instead of entering a long dot-notation
 630     you can use a short name instead.
 631     The <replaceable>name</replaceable> is your
 632     name for the OID, <replaceable>class</replaceable> is the
 633     class, and <replaceable>OID</replaceable> is the raw OID in
 634     dot notation. Class is one <literal>appctx</literal>,
 635     <literal>absyn</literal>, <literal>attet</literal>,
 636     <literal>transyn</literal>, <literal>diagset</literal>,
 637     <literal>recsyn</literal>, <literal>resform</literal>,
 638     <literal>accform</literal>, <literal>extserv</literal>,
 639     <literal>userinfo</literal>, <literal>elemspec</literal>,
 640     <literal>varset</literal>, <literal>schema</literal>,
 641     <literal>tagset</literal>, <literal>general</literal>.
 642     If you're in doubt use the <literal>general</literal>
 643     class.
 644    </para>
 645   </listitem>
 646  </varlistentry>
 647
 648  <varlistentry><term>
 649    <literal>register_tab</literal>
 650    <replaceable>command</replaceable>
 651    <replaceable>string</replaceable>
 652   </term>
 653   <listitem>
 654    <para>This command registers a TAB completion string for
 655     the command given.
 656    </para>
 657   </listitem>
 658  </varlistentry>
 659
 660  <varlistentry><term>
 661    <literal>sleep</literal>
 662    <replaceable>seconds</replaceable>
 663   </term>
 664   <listitem>
 665    <para>This command makes YAZ client sleep (be idle) for
 666     the number of seconds given.
 667    </para>
 668   </listitem>
 669  </varlistentry>
 670
 671  <varlistentry id="command-wait-response"><term>
 672    <literal>wait_response</literal>
 673    [ <replaceable>number</replaceable>]
 674   </term>
 675   <listitem>
 676    <para>This command makes YAZ client wait for a number of
 677     response packages from target. If <replaceable>number</replaceable> is
 678     omitted, 1 is assumed.
 679    </para>
 680    <para>This command is rarely used and is only useful if command
 681     <link linkend="command-set-auto-wait">
 682      <literal>set_auto_wait</literal>
 683     </link> is set to off.
 684    </para>
 685   </listitem>
 686  </varlistentry>
 687
 688  <varlistentry id="command-xmles"><term>
 689    <literal>xmles</literal>
 690    <replaceable>OID</replaceable>
 691    <replaceable>doc</replaceable>
 692   </term>
 693   <listitem>
 694    <para>Sends XML Extended Services request using the OID and doc given.
 695    </para>
 696   </listitem>
 697  </varlistentry>
 698
 699  <varlistentry><term>
 700    <literal>zversion</literal>
 701    <replaceable>ver</replaceable>
 702   </term>
 703   <listitem>
 704    <para>This command sets Z39.50 version for negotiation.
 705     Should be used before
 706     <link linkend="command-open"><literal>open</literal></link>.
 707     By default 3 (version 3) is used.
 708    </para>
 709   </listitem>
 710  </varlistentry>
 711
 712  <varlistentry><term>
 713    <literal>options</literal>
 714    <replaceable>op1 op2..</replaceable>
 715   </term>
 716   <listitem>
 717    <para>This command sets Z39.50 options for negotiation.
 718     Should be used before
 719    <link linkend="command-open"><literal>open</literal></link>.
 720    </para>
 721    <para>
 722     The following options are supported:
 723     <literal>search</literal>,
 724     <literal>present</literal>,
 725     <literal>delSet</literal>,
 726     <literal>resourceReport</literal>,
 727     <literal>triggerResourceCtrl</literal>,
 728     <literal>resourceCtrl</literal>,
 729     <literal>accessCtrl</literal>,
 730     <literal>scan</literal>,
 731     <literal>sort</literal>,
 732     <literal>extendedServices</literal>,
 733     <literal>level_1Segmentation</literal>,
 734     <literal>level_2Segmentation</literal>,
 735     <literal>concurrentOperations</literal>,
 736     <literal>namedResultSets</literal>,
 737     <literal>encapsulation</literal>,
 738     <literal>resultCount</literal>,
 739     <literal>negotiationModel</literal>,
 740     <literal>duplicationDetection</literal>,
 741     <literal>queryType104</literal>,
 742     <literal>pQESCorrection</literal>,
 743     <literal>stringSchema</literal>.
 744    </para>
 745   </listitem>
 746  </varlistentry>
 747
 748 </variablelist>
 749 <!-- Keep this comment at the end of the file
 750 Local variables:
 751 mode: sgml
 752 sgml-omittag:t
 753 sgml-shorttag:t
 754 sgml-minimize-attributes:nil
 755 sgml-always-quote-attributes:t
 756 sgml-indent-step:1
 757 sgml-indent-data:t
 758 sgml-parent-document: "yaz.xml"
 759 sgml-local-catalogs: nil
 760 sgml-namecase-general:t
 761 End:
 762 -->