The easiest way to install YAZ on Windows is by downloading
an installer from
here.
The installer comes with source too - in case you wish to
compile YAZ with different Compiler options etc.
YAZ is shipped with "makefiles" for the NMAKE tool that comes
with Microsoft Visual C++. Version 6 has been tested. We expect that
YAZ should compile with version 5 as well.
Start a command prompt and switch the sub directory
WIN where the file makefile
is located. Customize the installation by editing the
makefile file (for example by using notepad).
The following summarizes the most important settings in that file:
- DEBUG
If set to 1, the software is
compiled with debugging libraries (code generation is
multi-threaded debug DLL).
If set to 0, the software is compiled with release libraries
(code generation is multi-threaded DLL).
- TCL
Specifies the name of the Tcl shell (EXE-file).
You do not need setting this or installing Tcl unless you wish
to change or add ASN.1 for YAZ.
- HAVE_ICONV, ICONV_DIR
If HAVE_ICONV is set to 1, YAZ is compiled
with iconv support. In this configuration, set
ICONV_DIR to the iconv source directory.
When satisfied with the settings in the makefile, type
If command
nmake is not found on your system
you probably haven't defined the environment variables required to
use that tool. To fix that, find and run the batch file
vcvars32.bat. You need to run it from within
the command prompt or set the environment variables "globally";
otherwise it doesn't work.
If you wish to recompile YAZ - for example if you modify
settings in the makefile you can delete
object files, etc by running.
The following files are generated upon successful compilation:
- bin/yaz.dll
YAZ multi-threaded Dynamic Link Library.
- lib/yaz.lib
Import library for yaz.dll.
- bin/yaz-client.exe
YAZ Z39.50 client application. It's a WIN32 console application.
See chapter YAZ client for more
information.
- bin/yaz-ztest.exe
Z39.50 multi-threaded test/example server. It's a WIN32
console application.
- bin/zoomsh.exe
Simple console application implemented on top of the
ZOOM functions.
The application is a command line shell that allows you to enter
simple commands to perform ZOOM operations.
- bin/zoomtst1.exe,
bin/zoomtst2.exe, ..
Several small applications that demonstrates the ZOOM API.
This section will go though the process of linking your WIN32
applications with YAZ.
Some people are confused by the fact that we use the nmake
tool to build YAZ. They think they have to do that too - in order
to make their WIN32 applications work with YAZ. The good news is that
you don't have to. You can use the integrated environment of
Visual Studio if desired for your own application.
When setting up a project or Makefile you have to set the following:
- include path
Set it to the include directory of YAZ.
- import library yaz.lib
You must link with this library. It's located in the
sub directory lib of YAZ.
- dynamic link library yaz.dll
This DLL must be in your execution path when you invoke
your application. Specifically, you should distribute this
DLL with your application.