Hello Raymond,
Please see attached .txt file for sample session in Yaz. Once you have the Yaz
client installed, you work off of command line interface. In windows, Yaz opens
up a command prompt like window with a Z> prompt.
It's a very useful tool to troubleshoot what you're getting from a Z39.50
server -- in our case, it came in very useful recently to determine that the
output format from one of our Z39.50 targets was sending us some bad data (in
turn helping us determine what needed to be fixed was not in Evergreen but in
an external system, etc.)
Good luck!
George
George Duimovich
NRCan Library / Bibliothèque de RNCan
-----Original Message-----
From: [email protected]
[mailto:[email protected]] On Behalf Of
Raymond Norton
Sent: June 11, 2010 14:47
To: Evergreen Discussion Group
Subject: Re: [OPEN-ILS-GENERAL] Network errors when attempting z39.50 imports
I cleared the logs, and only get this one error when attempting to import a
record from LOC:
grep ERR /openils/var/log/*.log
/openils/var/log/osrfsys.log:open-ils.cstore 2010-06-11 13:41:41 [ERR
:3228:oils_cstore.c:5045:127628152433102] open-ils.cstore ERROR No "datatype"
attribute for field "tcn_value"
No other errors pop up until the import is attempted.
I have zero experience with the yaz-client. Would you have know what the
command would be to import a a test record via yaz?
On 6/11/2010 10:53 AM, Jason Etheridge wrote:
> On Fri, Jun 11, 2010 at 11:42 AM, Raymond Norton<[email protected]> wrote:
>
>> As a test, I logged into an evergreen demo system and imported a record from
>> LOC. Minutes later, I attempted to import the same record into my system,
>> but no go.
>>
> I'd still be tempted to use yaz-client from your server to see if
> there a connection problem (firewall, etc.) between your server and
> their Z39.50 server.
>
>
>> Wow, didn't realize there would be so many logs. Which one should I be
>> tailing to troubleshoot this?
>>
> I'd grep all of them like so:
>
> grep \\[ERR /openils/var/log/*
>
> Anything that matches is bad and noteworthy.
>
> Generally osrfsys.log is a good one to be following.
>
>
Sample YAZ session.
Authenticate if needed
Z> auth username/password
Open a connection to the target z39.50 server (210 is usually the port #)
Z> o tcp:myserver.org:210
Select a database
Z> base the-z3950-database-name
(usually something like "INNOPAC" or "UNICORN" etc.)
Select a record format
Z> format usmarc
Search for title (that what the @attr 1=4 bit says)
Z> find @attrset Bib-1 @attr 1=4 nepean
you can actually leave out the @attrset Bib-1 if you like as this is
defaulted.
Get some results back (ask for 5 from the first)
Z> show 1+5
or just show the one record.
Z> show 1
if the target responds with 'result set naming not supported' or similar then
type
Z> setname
also
Z> element F
Z> element B
toggle between brief and Full ElementSetNames (i.e. brief and full records).
Say goodbye
Z> quit
If you want to search on atrributes other than title,
replace the 4 with the relevant use atrribute number.
Use Value Refernce to Group Name Used in
Table 2
Personal name 1 Name-personal
Corporate name 2 Name-corporate
Conference name 3 Name-conference
Title 4 Title
Title series 5 Title-series
Title uniform 6 Title-uniform
ISBN 7 Identifier-ISBN
ISSN 8 Identifier-ISSN
LC card number 9 Control number-LC
BNB card number 10 Control number-BNB
BGF(sic) number 11 Control number-BNF
Local number 12 Control number-local
Dewey classification 13 Classification-Dewey
UDC classification 14 Classification-UDC
Bliss classification 15 Classification-Bliss
LC call number 16 Classification-LC
NLM call number 17 Classification-NLM
NAL call number 18 Classification-NAL
MOS call number 19 Classification-MOS
Local classification 20 Classification-local
Subject heading 21 Subject
Subject Rameau 22 Subject-RAMEAU
Meta Incognita Peninsula (Nunavut)
BDI index subject 23 Subject-BDI
INSPEC subject 24 Subject-INSPEC
MESH subject 25 Subject-MESH
PA subject 26 Subject-PA
LC subject heading 27 Subject-LC
RVM subject heading 28 Subject-RVM
Local subject index 29 Subject-local
Date 30 Date
Date of publication 31 Date-publication
Date of acquisition 32 Date-acquisition
Title-key 33 Title-key
Title collective 34 Title-collective
Title parallel 35 Title-parallel
Title cover 36 Title-cover
Title added-title-page 37 Title-added-title-page
Title caption 38 Title-caption
Title running 39 Title-running
Title spine 40 Title-spine
Title other variant 41 Title-other-variant
Title former 42 Title-former
Title abbreviated 43 Title-abbreviated
Title expanded 44 Title-expanded
Subject PRECIS 45 Subject-PRECIS
Subject RSWK 46 Subject-RSWK
Subject subdivision 47 Subject-subdivision
Number natl bibliography 48 Identifier-national-bibliography
Number legal deposit 49 Identifier-legal-deposit
Number govt publication 50 Classification-government-publication
Number publisher for music 51 Identifier-publisher-for-music
Number DB 52 Control-number-DB
Number local call 53 Identifier-local-call
Code--language 54 Code-language
Code--geographic area 55 Code-geographic-area
Code--institution 56 Code-institution
Name and title 57 Name and title
Name geographic 58 Name-geographic
Place publication 59 Name-geographic-place-publication
CODEN 60 Identifier-CODEN
Microform generation 61 Code-microform-generation
Abstract 62 Abstract
Note 63 Note
Author-title 1000 Author-name-and-title
Record type 1001 Code-record-type
Name 1002 Name
Author 1003 Author-name
Author-name personal 1004 Author-name-personal
Author-name corporate 1005 Author-name-corporate
Author-name conference 1006 Author-name-conference
Identifier--standard 1007 Identifier-standard
Subject--LC children's 1008 Subject-LC-children's
Subject name--personal 1009 Subject-name-personal
Body of text 1010 Body of text
Date/time added to database 1011 Date/time added to database
Date/time last modified 1012 Date/time last modified
Authority/format identifier 1013 Identifier-authority/format
Concept-text 1014 Concept-text
Concept-reference 1015 Concept-reference
Any 1016 Any
Server choice 1017 Server-choice
Publisher 1018 Name-publisher
Record source 1019 Record-source
Editor 1020 Name-editor
Bib-level 1021 Code-bib-level
Geographic class 1022 Code-geographic-class
Indexed by 1023 Indexed-by
Map scale 1024 Code-map-scale
Music key 1025 Music-key
Related periodical 1026 Title-related-periodical
Report number 1027 Identifier-report
Stock number 1028 Identifier-stock
Thematic number 1030 Identifier-thematic
Material type 1031 Material-type
Doc ID 1032 Identifier-document
Host item 1033 Title-host-item
Content type 1034 Content-type
Anywhere 1035 Anywhere
Author-Title-Subject 1036 Author-Title-Subject
The Relation attributes are the following: Relation
Value
Less than 1
Less than or equal 2
Equal 3
Greater or equal 4
Greater than 5
Not equal 6
Phonetic 100
Stem 101
Relevance 102
AlwaysMatches 103
************
YAZ COMMANDS
************
Currently Recognized commands;
open ('tcp'|'osi')':'[<tsel>'/']<host>[':'<port>]
quit
find <query>
base <base-name>
show <rec#>['+'<#recs>['+'<setname>]]
scan <term>
sort <sortkey> <flag> <sortkey> <flag> ...
sort+ <sortkey> <flag> <sortkey> <flag> ...
authentication <acctstring>
lslb <largeSetLowerBound>
ssub <smallSetUpperBound>
mspn <mediumSetPresentNumber>
status
setnames
cancel
format <recordsyntax>
elements <elementSetName>
close
attributeset <attrset>
querytype <type>
refid <id>
itemorder <item>
? will get you the above help