Z39.50 interface

Introduction

Z39.50 is a standard (ISO 23950 and ANSI/NISO Z39.50) that allows different information retrieval systems to communicate behind the scenes. You can get full details from the Z39.50 Maintenance Agency pages on the Library of Congress Web site: http://lcweb.loc.gov/z3950/agency/

Quick Connection Details

The most vital information you need to know to get your origin/client connected to the Copac Z39.50 target is:

Address: z3950.copac.ac.uk
Port: 210
Database name: COPAC
Record syntax: XML or SUTRS
No username or password are required.

Full Configuration Details

Accessing the target

The target is only accessible through TCP and lives at Internet address z3950.copac.ac.uk on port 210.

You must set the database name to COPAC. If the database name is set to "default" or anything else then nothing will work! This is the most common cause of problems with accessing Copac through Z39.50.

No username or password should be specified. Specifying a username and password is the second most common cause of problems. Don't do it!

Supported parts of Z39.50

Init, Search, Present, Named Result Sets, Sort and Close are supported.

Record syntaxes

XML and SUTRS are supported. There are no plans to deliver MARC records as part of the Copac service. The XML records conform to the MODS Schema.

Record Character Set

The records use the Unicode character set in UTF-8 encoding.

Element set names

Records can be retrieved in either Brief (B) or Full (F) form. The default is Full.

Other ESNs available for SUTRS records only are:

REF
This will present records in a form suitable for loading into a personal bibliographic reference manager such as Papyrus.
PRINTF
This format is the same as the format "Print format (Full)" available from the Download option of the Copac web interface.
PRINTB
This format is the same as the format "Print format (Brief)" available from the Download option of the Copac web interface.

Supported attributes

Only the BIB-1 attribute set is supported for searching Copac.

Use attributes

Title (4)
Searches the title index. When used with the structure attribute Key the term is assumed to be a derived key of the form 3,2,2,1 eg. lor,of,th,r
Realted Title (5)
Keyword search related titles, such as those found in the 7XX fields of a MARC record.
ISBN (7)
We index all ISBNs as 13 digit ISBNs. If your search term looks like a 10 digit ISBN the target will convert it to a 13 digit ISBN before permorming the search. Hence, you should be able to use 10 or 13 digit ISBNs for your search. As from 28/3/2007 this Use attribute will no longer find ISSNs.
ISSN (8)
Searches our ISSN index. As from 28/3/2007 this Use attribute will no longer find ISBNs.
Subject heading (21)
This can be used for keyword searching on subject headings.
LCSH Subject heading (27)
This can be used for keyword searching on LCSH subject headings.
Date (30 or 31)
Searches the date index. The relational operators can be used for date range searching. However, there are easier ways. Instead of using the relation operators use a hyphen to indicate a range. To search for a range of dates from 1900 to 1910 inclusive use a term like this: 1900-1910. Similarly, to find works from 2015 to date use: 2015-
Language (54)
Search for works by language. Use language codes as Fre (French) or Ger (German) etc. You can get language name to code conversions from the MARC code list for languages.
Institution (56)
Search by the contributor code.
Place publication (59)
Search for the place of publication.
Abstract (62)
Keyword search of the abstracts index.
Note (63)
Keyword search of the notes index.
Author-title(1000)
This is a derived key index and needs the first four letters of the author's surname and the first four letters of the title separated by punctuation, eg Shak,Henr
Author (1003)
Any author name, be it personal, corporate or conference.
Personal Author (1004)
Look for a author. Can be used with the Key structure attribute, when the search term should be of the form Surname, Initials, eg Dylan,B
Identifier-standard (1007)
Look for standard numbers such as ISBN or ISSN
Any (1016) and Server-choice (1017)
Searches for the given terms in all the indexes.
Publisher (1018 & 1101)
Keyword search of the publisher name index.
Local number (12), Number DB (52) and Doc ID (1032)
Search for the Copac document IDs.
Map-scale (1024)
Just enter a number eg. 500000
Material Type (1031)
If you want to select all the records we have identified as periodicals then search for the string "periodical" against this Use attribute.

The initial search for periodicals will be slow, but any subsequent searches should be much faster as the target now caches searches such a this one.

Fuzzy-scale (5005)
Just enter a number eg. 500000. The fuzzy scale search will find matching scales plus other similar scales. Most useful when searching for early maps where the original scale may have been converted into slightly different ratios in different records.

Relational attributes

Less than (1), Less than or equal (2), Equal (3), Greater or equal (4), Greater than (5).

Attributes 1,2 4, and 5 can only be used with the Date (30 or 31) Use attribute. But if you use a hyphen in your search term to indicate a range there is no need to use the Relation attributes. For example, use a search term of 2000-2010 to get a date range search.

Position attributes

Any position in field (3).

Structure attributes

Phrase (1), Word (2), Key (3) and Word List (6).

If structure is Phrase then the words will be searched for in the order given in the term. Therefore, it probably isn't a good idea to search for an author with structure as Phrase unless you know how we store our author names in the database.

If structure is Word or Word List (treated exactly the same) then order isn't preserved.

Note: When using the Key structure attribute, each part of the derived key must be separated with punctuation. All the punctuation must be supplied or the search will fail. The following are all valid:

    Lor,of,th,r
    Pri-an-pr- 
    Oli,,,
    Muc/ad/ab/n
    Levi-Lex
    Forster,EM
  

Truncation attributes

Right Truncation (1), Do Not Truncate (100)

If Right Truncation is used then the right most query term is truncated. Alternatively an asterisk can be used at the end of a query term to indicate that truncation is required -- no Truncation attribute is required.

Using truncation with terms less than 5 characters in length is very likely to cause overflow in the search engine with resulting loss of records from your result set.

Completeness attributes

Incomplete Subfield (1), Complete Subfield (3).

Complex attributes

Complex attributes are not supported.

Only Type-1 queries are supported. The boolean operators AND, OR and NOT are supported.

Sort

Only case insensitive and ordinary ascending and descending sorts are supported.

Supported attributes

The Use attributes supported for searching which can be specified for sorting are: Title (4), Date (30 or 31), Author (1003)

Implementation details

The records themselves are supplied by members of the RLUK libraries, with the addition of records for special collection materials from some other libraries. A full list of the libraries contributing data to Copac is available on our 'Libraries' page. The records accessible to the general public are not available in any MARC format.

EndNote and Reference Manager

EndNote and Reference Manager are Z39.50 clients that allow you to access Copac. If you have either of these clients and they aren't configured for Copac you can download the EndNote connection file for Copac and the Reference Manager filter file for Copac from our FAQ page.

Contact information

Any comments concerning the operation of the Z39.50 target should be sent to help@jisc.ac.uk (please state that your enquiry is for the Copac team)