---
name: "Net::Z3950::Simple2ZOOM"
section: "3pm"
platform: "linux"
package: "libnet-z3950-simple2zoom-perl"
version: "1.04-1.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Net::Z3950::Simple2ZOOM"
---

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

Gateway between Z39.50 and SRU/SRW

## NAME

Net::Z3950::Simple2ZOOM - Gateway between Z39.50 and SRU/SRW

## SYNOPSIS

```
 use Net::Z3950::Simple2ZOOM;
 $s2z = new Net::Z3950::Simple2ZOOM("somefile.xml");
 $s2z->launch_server("someServer", @ARGV);
```

## DESCRIPTION

The `"Net::Z3950::Simple2ZOOM"` module provides all the application logic of a generic "Swiss Army Gateway" between Z39.50 and SRU.  It is used by the `"simple2zoom"` program, and there is probably no good reason to make any other program to use it.  For that reason, this library-level documentation is more than usually terse.

The library has only two public entry points: the `"new()"` constructor and the `"launch_server()"` method.  The synopsis above shows how they are used: a Simple2ZOOM object is created using `"new()"`, then the `"launch_server()"` method is invoked on it to -- get ready for a big surprise here -- launch the server.  (In fact, this synopsis is essentially the whole of the code of the `"simple2zoom"` program.  All the work happens inside the library.)

## METHODS

### new($configFile)

```
 $s2z = new Net::Z3950::Simple2ZOOM("somefile.xml");
```

Creates and returns a new Simple2ZOOM object, configured according to the XML file `$configFile` that is the only argument.  The format of this file is described in `"Net::Z3950::Simple2ZOOM::Config"`.

### launch\_server($label, @ARGV)

```
 $s2z->launch_server("someServer", @ARGV);
```

Launches the Simple2ZOOM server: this method never returns.  The `$label` string is used in logging, and the `@ARGV` vector of command-line arguments is interpreted by the YAZ backend server as described at http://www.indexdata.dk/yaz/doc/server.invocation.tkl

## SEE ALSO

The `"simple2zoom"` program.

The `"Net::Z3950::Simple2ZOOM::Config"` manual for the configuration-file format.

The `"Net::Z3950::SimpleServer"` module.

The `"ZOOM"` module (in the `"Net::Z3950::ZOOM"` distribution).

## AUTHOR

Sebastian Hammer \<quinn@indexdata.com\>

Mike Taylor \<mike@indexdata.com\>

## COPYRIGHT AND LICENCE

Copyright (C) 2007 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.8 or, at your option, any later version of Perl 5 you may have available.