X-Git-Url: http://git.indexdata.com/?a=blobdiff_plain;f=doc%2Fsru_z3950.xml;h=df973ed0786bdb8ad4111b9bd9841500343d54d7;hb=6e933ec5c63455f83f146aee997e4e10070620a9;hp=37d7e604cead8513df9bd7dc5bc6008369caf994;hpb=5753479ffa8e178463d65fb549f405dd71baa9bd;p=metaproxy-moved-to-github.git diff --git a/doc/sru_z3950.xml b/doc/sru_z3950.xml index 37d7e60..df973ed 100644 --- a/doc/sru_z3950.xml +++ b/doc/sru_z3950.xml @@ -1,39 +1,44 @@ - - - %common; + + %idcommon; ]> - - + + + Metaproxy + Index Data + + sru_z3950 3mp - Metaproxy Module + Metaproxy Module - + sru_z3950 - transforming SRU web service requests to Z3950 Metaproxy packages + Metaproxy Module transforming SRU web service requests to + Z39.50 Metaproxy packages - + DESCRIPTION The sru_z3950 Metaproxy filter transforms valid - SRU GET/POST/SOAP requests to Z3950 requests, and wraps the - received hit counts and XML records into suitable SRU response messages. + SRU GET/POST/SOAP requests to Z39.50 requests, and wraps the + received hit counts and XML records into suitable SRU response messages. Multiple database elements defining the names of the accepted databases are allowed in the configuration file. Each - of them must contain their own explain record, or must be empty. + of them must contain their own explain record, or must be empty. Notice that explain records come in SRU and Z39.50 flavors, and this filter requires - the SRU version. See the + the SRU version. See the ZeeReX Explain - standard pages and the + standard pages and the SRU Explain pages - for more information. + for more information. All Z39.50 packages and all HTTP packages that do not resolve to @@ -41,14 +46,14 @@ filters on the route. - The SRU explain operation is supported, + The SRU explain operation is supported, returning either the absolute minimum required by the standard, or - a full pre-defined ZeeReX explain record. + a full pre-defined ZeeReX explain record. It supports the SRU searchRetrieve operation, which - is transformed into successive Z3950 init, - search and present requests. + is transformed into successive Z39.50 init, + search and present requests. The SRU scan operation is not supported. @@ -56,9 +61,61 @@ This filter does not handle CQL-to-PQF translations. In case that the backends do not understand CQL, you need to append the - cql_pqf metaproxy filter. This filter - still needs to be implemented. - + cql_pqf metaproxy filter. + + + This module supports the following SRU extra parameters: + + + x-target + + + Specifies backend Z39.50 target. + + + + + x-max-sockets + + + Specifies maximum number of sockets to use for a Z39.50 backend + client (for one given target host/db). + + + + + x-session-id + + + Allow a user-defined session ID to be attached to filter + log that follows sru_z3950. The ID is present in the + log files and not available to the SRU webservice. In order + to log material out via SRU, the x-log-enable may be used + instead. + + + + + x-log-enable + + + Controls whether log is to be collected for filters that + sru_z3950. Log data is extra response data's log element. + A value of 1 enables logging; other value disables + logging (default). + + + + + + + + SCHEMA + + EXAMPLES @@ -77,8 +134,8 @@ ]]> - - + + SEE ALSO @@ -87,21 +144,13 @@ - + ©right;