NAME
z2folio - Z39.50 server for FOLIO bibliographic data
SYNOPSIS
z2folio [ -c configBase ] [ -- YAZ-options ] [ listener-address ... ]
DESCRIPTION
z2folio provides a Z39.50 server for bibliographic data in the FOLIO ILS. Because it relies on the Net::Z3950::SimpleServer modules for the server functionality, because this module is based on the YAZ toolkit, and because YAZ transparently handles all three standard IR protocols (ANSI/NISO Z39.50, SRU and SRW), it can function as a server for all three of these protocols.
The following command-line options govern how it functions:
-c configBase-
Specifies that the named
configBase.jsonshould be used as the base configuration for the functionality of the server: if this option is not specified, then the fileconfig.jsonin the working directory is used. The format of the configuration file is described separately inNet::Z3950::FOLIO::Config, and a sample configuration file,config.json, is supplied in theetcdirectory of the distribution. ---
Indicates the end of
z2folio-specific options. This is required if YAZ options are to be specified, so thatz2foliodoesn't try to interpret them itself. - YAZ-options
-
Command-line arguments subsequent to the
--option are interpreted by the YAZ backend server as described at https://software.indexdata.com/yaz/doc/server.invocation.htmlThese options provide the means to control many aspects of the gateway's functioning: for example, whether the server forks a new process for each client or runs a single process using
select(); how (if at all) to interpret incoming SRU requests; whether and how to log protocol packets for debugging. - listener-address
-
One or more YAZ-style listener addresses may be specified, and the server will accept connections on those addresses: for example,
@:9998,unix:/tmp/somesocketorssl:myhost.com:210. If no explicit listener addresses are provided, the server listens on port 9999.
SEE ALSO
- The
Net::Z3950::FOLIOmodule provides all the functionality for this program. Net::Z3950::FOLIO::Configdescribes the configuration-file format.- The
Net::Z3950::SimpleServerhandles the Z39.50 service.
AUTHOR
Mike Taylor, <mike@indexdata.com>
COPYRIGHT AND LICENSE
Copyright (C) 2018 The Open Library Foundation
This software is distributed under the terms of the Apache License, Version 2.0. See the file "LICENSE" for more information.