doc/yaz-client-commands.xml

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