Skip to main content
ExLibris

Knowledge Assistant

BETA
 
  • Subscribe by RSS
  • Back
    Voyager

     

    Ex Libris Knowledge Center
    1. Search site
      Go back to previous article
      1. Sign in
        • Sign in
        • Forgot password
    1. Home
    2. Voyager
    3. Knowledge Articles
    4. Brief overview of how Voyager constructs responses to an external Z39.50 query

    Brief overview of how Voyager constructs responses to an external Z39.50 query

    1. Last updated
    2. Save as PDF
    3. Share
      1. Share
      2. Tweet
      3. Share
    1. Question
    2. Answer
    3. Additional Information
    • Product: Voyager
    • Relevant for Installation Type: Multi-Tenant Direct, Dedicated-Direct, Local, TotalCare

     

    Question

    Brief overview of how Voyager constructs responses to an external Z39.50 query.

    Answer

    A good tool for determining this information is yaz-client (see Additional Information below for link and example response).  Yaz-client is free and open source.

    The following is a simple example of a yaz-client response to an external Z39.50 query:

    Start yaz-client.

    Connect to your server (assumes default port of 7090, change as needed):
    Z> open your.server.edu:7090/voyager

    Find a known record by voyager id (BIB_ID):
    Z> find @1=12 BIB_ID
    Sent searchRequest.
    Received SearchResponse.
    Search was a success.
    Number of hits: 1
    records returned: 0

    Don't worry about "records returned", what matters is number of hits.  Since you searched for a known BIB ID, you should have 1 hit.

    Switch to "opac" format in yaz-client, to see holdings and item/circulation info:
    Z> form opac

    Display the record:
    Z> show 1

    You should see the bib record in readable MARC format, followed by:

    1) One or more "Data holdings" records, numbered starting with 0.  This is basic data from the holdings record(s).

    2) If you have item records, one or more "volume" records, numbered starting with 0.  This is enum/chron (e.g., volume numbers) from each item.

    3) If you have item records, one or more "circulation" records, numbered starting with 0.  This shows item availability, according to your circulation rules.  availableNow: 1 means the item technically is available (not charged out).  Value of 0 means not available (probably charged out, could be other reasons).

    Note: If you don't have item records you won't see volume or circulation data. 

    Additional Information

    Yaz-client is available here: http://www.indexdata.com/yaz

    Yaz-client documentation is available here: https://software.indexdata.com/yaz/doc/yaz-client.html

    Example of external query response: z3950_external_query_response_example.txt


    • Article last edited: 21-Nov-2020
    View article in the Exlibris Knowledge Center
    1. Back to top
      • Booleans don't work after a certain number of search terms
      • Brief overview of making simple changes to queries in Voyager Prepackaged Access Reports
    • Was this article helpful?

    Recommended articles

    1. Article type
      Topic
      Language
      English
      Product
      Voyager
    2. Tags
      This page has no tags.
    1. © Copyright 2025 Ex Libris Knowledge Center
    2. Powered by CXone Expert ®
    • Term of Use
    • Privacy Policy
    • Contact Us
    2025 Ex Libris. All rights reserved