Z3950 SRU Servers | Best Book Buddies
  1. Koha ManualKoha Manual
  2. Koha Administration
  3. How to set up additional parameters?

Koha Administration

How to set up additional parameters?

  • Get there: More > Administration > Additional Parameters

  • Get there: More > Administration > Additional Parameters

Z39.50 is a client–server protocol for searching and retrieving information from remote computer databases, in short it's a tool used for copy cataloging.

SRU- Search/Retrieve via URL - is a standard XML-based protocol for search queries, utilizing CQL - Contextual Query Language - a standard syntax for representing queries.

Using Koha you can connect to any Z39.50 or SRU target that is publicly available or that you have the log in information to and copy both bibliographic and/or authority records from that source.

  • Get there: More > Administration > Additional Parameters > Z39.50/SRU Servers

Koha comes with a default list of Z39.50/SRU targets set up that you can add to, edit or delete

z39list

To find additional Z39.50 targets you use IndexData's IRSpy: http://irspy.indexdata.com or the Library of Congress's List of Targets http://www.loc.gov/z3950/

  • From the main Z39.50 page, click 'New Z39.50 Server'

    newz39

    • 'Z39.50 server' should be populated with a name that will help you identify the source (such as the library name).

    • 'Hostname' will be the address to the Z39.50 target.

    • 'Port' tells Koha what port to listen on to get results from this target.

    • 'Userid' and 'Password' are only required for servers that are password protected.

    • Check the 'Preselected' box if you want this target to always be selected by default.

    • 'Rank' lets you enter where in the list you'd like this target to appear.

      • If this is left blank the targets will be in alphabetical order.

    • 'Syntax' is the MARC flavor you use.

    • 'Encoding' tells the system how to read special characters.

    • 'Timeout' is helpful for targets that take a long while. You can set the timeout so that it doesn't keep trying the target if results aren't found in a reasonable amount of time.

    • 'Record type' lets you define if this is a bibliographic or an authority target.

    • 'XSLT file(s)' lets enter one or more (comma-separated) XSLT file names that you want to apply on the search results.

      • When retrieving records from external targets you may wish to automate some changes to those records. XSLT's allow you to do this. Koha ships with some sample XSLT files in the /koha-tmpl/intranet-tmpl/prog/en/xslt/ directory ready for use:

        • Del952.xsl: Remove items (MARC21/NORMARC)

        • Del995.xsl: Remove items (UNIMARC)

        • Del9LinksExcept952.xsl: Remove $9 links. Skip item fields (MARC21/NORMARC)

        • Del9LinksExcept995.xsl: Remove $9 links. Skip item fields (UNIMARC)

6.1.2.

Koha libraries with open Z39.50 targets can share and find connection information on the Koha wiki: http://wiki.koha-community.org/wiki/Koha_Open_Z39.50_Sources. You can also find open Z39.50 targets by visiting IRSpy: http://irspy.indexdata.com.

The following targets have been used successfully by other Koha libraries (in the Americas):

  • ACCESS PENNSYLVANIA 205.247.101.11:210 INNOPAC

  • CUYAHOGA COUNTY PUBLIC webcat.cuyahoga.lib.oh.us:210 INNOPAC

  • GREATER SUDBURY PUBLIC 216.223.90.51:210 INNOPAC

  • HALIFAX PUBLIC catalogue.halifaxpubliclibraries.ca:210 horizon

  • HALTON HILLS PUBLIC cat.hhpl.on.ca:210 halton_hills

  • LIBRARY OF CONGRESS lx2.loc.gov: 210 LCDB

  • LONDON PUBLIC LIBRARY catalogue.londonpubliclibrary.ca:210 INNOPAC

  • MANITOBA PUBLIC library.gov.mb.ca:210 horizon

  • MILTON PL cat.mpl.on.ca:210 horizon

  • NATIONAL LIBRARY OF WALES cat.llgc.org.uk:210 default

  • NHUPAC 199.192.6.130:211 nh_nhupac

  • OCEAN STATE LIBRARIES (RI) catalog.oslri.net:210 INNOPAC

  • OHIOLINK olc1.ohiolink.edu:210 INNOPAC

  • PUBCAT prod890.dol.state.vt.us:2300 unicorn

  • SAN JOAQUIN VALLEY PUBLIC LIBRARY SYSTEM (CA) hip1.sjvls.org:210 ZSERVER

  • SEATTLE PUBLIC LIBRARY ZSERVER.SPL.ORG:210 HORIZON

  • TORONTO PUBLIC symphony.torontopubliclibrary.ca:2200 unicorn

  • TRI-UNI 129.97.129.194:7090 voyager

  • VANCOUVER PUBLIC LIBRARY z3950.vpl.ca:210 Horizon

The following targets have been used successfully by other Koha libraries (in the Americas):

  • LIBRARIESAUSTRALIA AUTHORITIES z3950-test.librariesaustralia.nla.gov.au:210 AuthTraining Userid: ANLEZ / Password: z39.50

  • LIBRARY OF CONGRESS NAME AUTHORITIES lx2.loc.gov:210 NAF

  • LIBRARY OF CONGRESS SUBJECT AUTHORITIES lx2.loc.gov:210 SAF

  • From the main Z39.50/SRU page, click 'New SRU Server'

    newsru

    • 'Server name' should be populated with a name that will help you identify the source (such as the library name).

    • 'Hostname' will be the address to the Z39.50 target.

    • 'Port' tells Koha what port to listen on to get results from this target.

    • 'Userid' and 'Password' are only required for servers that are password protected.

    • Check the 'Preselected' box if you want this target to always be selected by default.

    • 'Rank' lets you enter where in the list you'd like this target to appear.

      • If this is left blank the targets will be in alphabetical order.

    • 'Syntax' is the MARC flavor you use.

    • 'Encoding' tells the system how to read special characters.

    • 'Timeout' is helpful for targets that take a long while. You can set the timeout so that it doesn't keep trying the target if results aren't found in a reasonable amount of time.

    • 'Additional SRU options' is where you can enter additional options of the external server here, like sru_version=1.1 or schema=marc21, etc. Note that these options are server dependent.

    • 'SRU Search field mapping' lets you add or update the mapping from the available fields on the Koha search form to the specific server dependent index names.

      • To further refine your searches, you could add the following index names to the SRU search field mappings. To do this, edit the server and click the Modify button next to this field.

        Table 2.2. SRU Mapping

        Title dc.title
        ISBN bath.isbn
        Any cql.anywhere
        Author dc.author
        ISSN bath.issn
        Subject dc.subject
        Standard ID bath.standardIdentifier


    • 'XSLT file(s)' lets enter one or more (comma-separated) XSLT file names that you want to apply on the search results.

      • When retrieving records from external targets you may wish to automate some changes to those records. XSLT's allow you to do this. Koha ships with some sample XSLT files in the /koha-tmpl/intranet-tmpl/prog/en/xslt/ directory ready for use:

        • Del952.xsl: Remove items (MARC21/NORMARC)

        • Del995.xsl: Remove items (UNIMARC)

        • Del9LinksExcept952.xsl: Remove $9 links. Skip item fields (MARC21/NORMARC)

        • Del9LinksExcept995.xsl: Remove $9 links. Skip item fields (UNIMARC)

"You are seeing this manual, thanks to Koha Community"