z39.50 Search Targets

z39.50 Search Targets

Libraries are empowered to add their own Z39.50 copy cataloging targets to Koha in Koha Administration -> Additional Parameters -> Z39.50/SRU servers.

Required fields are Server name (the name of the library that will display in the cataloging module when a Z39.50 search is performed), host name (typically a URL), port, and database. IRSpy maintains a public listing of library credentials, complete with reliability. But libraries may also find other Z39.50 targets through the Koha wiki, and of course, through leveraging the personal connections of Library Land.

For Syntax in setting up a connection, most of our U.S. and Canadian partners will want to select "MARC21/USMARC." The default selected syntax is UNIMARC, which will need to be changed. Bringing in MARC21/USMARC records in UNIMARC syntax can cause system errors, so that's one place to check if records are coming in from Z39.50 with bad data.

For encoding, the two common ones are utf8 or MARC-8. Utf8 is common enough that it's reasonable to leave as a default unless records come in with bad diacritics. If that happens, then switching the encoding to MARC-8 should resolve the issues. A good quick test is searching up a record that would have something with an accent mark in a title or author, like Pokémon or Gabriel García Márquez, since those special characters will quickly display encoding issues with a � in the symbol's place. (Specialized libraries will probably need a more discipline-specific test case, but the two suggestions will work for libraries with broad collections.)

If a target is consistently not returning results, it's worth checking IRSpy for reliability and to confirm the credentials or reaching out to the library directly to find out if anything has changed - they may have migrated library systems, for example, and the information initially provided is no longer correct. For libraries that connect to OCLC via Z39.50, it's worth checking whether the login credentials in the Userid/Password fields are correct and current. Another error that sometimes pops up is making sure the port information is not doubled up (added in both the end of the hostname URL and separately in the port field in Koha's Z39.50 connection information). And, of course, a once-over for typos or trailing spaces is always a good idea.


System Preference 

Koha has system preferences that allow staff to define additional fields and subfields to display on the Z39.50 result list.
  1. AdditionalFieldsInZ3950ResultSearch: allows staff to select and display specific MARC field/subfields  in the ‘Additional fields’ column of Z39.50 search results for cataloging.
  2.  AdditionalFieldsInZ3950ResultAuthSearch: allows staff to select and display specific MARC field/subfields in the ‘Additional fields’ column of Z39.50 search results for authorities.

    • Related Articles

    • Analytical Cataloging

      Libraries sometimes make journal articles and articles within monographs and serials accessible to library patrons through analytical cataloging. Analytical cataloging creates separate bibliographic records for these articles, chapters, sections, ...
    • How to Prevent Diacritics from Misbehaving in Koha

      What are diacritics? Have you ever noticed a funky symbol in your catalog that looks like a diamond with a question mark in the middle? Here’s an example: Gabriel Garc�ia M�arquez Are you wondering what this symbol means and why it appears in your ...
    • Item Search

      If you’re responsible for Collection Development but SQL and creating custom reports feels intimidating and out of reach, Item Search is the powerful little tool you need. Item Search builds an SQL report in the background with no need to know SQL. ...
    • Importing Records into Koha

      A library that receives a file of MARC records from a vendor can import them into Koha. This is a simple process done through Koha's Cataloging Module The file of MARC records should be a file with the file extension of .mrc Go To Cataloging > Stage ...
    • Cataloging Concerns

      This feature can be set up for either staff or OPAC (or both!) and will allow staff and/or patrons to report issues with catalog records. The reported concerns will be visible in the dashboard on the main page of the staff interface and available ...