YAZ User's Guide and Reference
Prev | Chapter 5. The YAZ client | Next

# Invoking the YAZ client

It can be started by typing

         yaz-client [options] [zurl]

in a UNIX shell / WIN32 console. The `zurl`, specifies a Z39.50 host and, if specified, the client first tries to establish connection with the Z39.50 target on the host. Options are, as usual, are prefixed by `-` followed by a particular letter.

The following options are supported:

`-m` `fname`

  All retrieved transfer records are appended to file `fname`. All records as returned by a target(s) in Search Responses and Present Responses are appended verbatim to the file.

`-a` `fname`

  Pretty-print log of APDUs sent and received is appended to the file `fname`. If `fname` is `-` (minus) the APDU log is written to `stderr`.

`-c` `fname`

  Sets the filename for CCL fields to `fname`. If this option is not given the YAZ client reads CCL fields from file `default.bib`.

`-v` `level`

  Sets the LOG level to `level`. Level is a sequence of tokens separated by comma. Each token is a integer or a named LOG item - one of `fatal`, `debug`, `warn`, `log`, `all`, `none`.

`-p` `target`

  Specifies proxy address. When set YAZ client will connect to a proxy on the address and port given. The actual target will be specifed as part of the InitRequest to inform the proxy about actual target.

`-u` `authentication`

  Specifies authentication. Usually the form `user`/`password` is used. This option does the same thing as the `auth` command.

`-k` `kilobytes`

  Specifies the maximum messages size in kilobytes. The default maxium messages for the YAZ client is 1024 (1 MB).

In order to connect to Index Data's test Z39.50 server on `bagel.indexdata.dk`, port 210 and with the database name marc, one would have to type

        yaz-client bagel.indexdata.dk:210/marc

In order to enable APDU log and connect to localhost, port 210 (default) and database Default (default) you'd write:

        yaz-client -a - localhost

Prev | Home | Next
The YAZ client | Up | Commands