---
name: "Net::Z3950::ZOOM"
section: "3pm"
platform: "linux"
package: "libnet-z3950-zoom-perl"
version: "1.32-2+b2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Z3950::ZOOM"
---

# Net::Z3950::ZOOM(3pm)

Perl extension for invoking the ZOOM-C API.

## NAME

Net::Z3950::ZOOM - Perl extension for invoking the ZOOM-C API.

## SYNOPSIS

```
 use Net::Z3950::ZOOM;
 $conn = Net::Z3950::ZOOM::connection_new($host, $port);
 $errcode = Net::Z3950::ZOOM::connection_error($conn, $errmsg, $addinfo);
 Net::Z3950::ZOOM::connection_option_set($conn, databaseName => "foo");
 # etc.
```

## DESCRIPTION

This module provides a simple thin-layer through to the ZOOM-C functions in the YAZ toolkit for Z39.50 and SRW/U communication.  You should not be using this very nasty, low-level API.  You should be using the `"ZOOM"` module instead, which implements a nice, Perlish API on top of this module, conformant to the ZOOM Abstract API described at http://zoom.z3950.org/api/

To enforce the don't-use-this-module prohibition, I am not even going to document it.  If you really, really, really want to use it, then it pretty much follows the API described in the ZOOM-C documentation at http://www.indexdata.com/yaz/doc/zoom.html

The only additional (non-ZOOM-C) function provided by this module is `event_str()`, which takes as its argument an event code such as `"Net::Z3950::ZOOM::EVENT_SEND_APDU"`, and returns a corresponding short string.

## SEE ALSO

The `"ZOOM"` module, included in the same distribution as this one.

## AUTHOR

Mike Taylor, \<mike@indexdata.com\>

## COPYRIGHT AND LICENCE

Copyright (C) 2005-2017 by Index Data.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.4 or, at your option, any later version of Perl 5 you may have available.