Fix title in explain database
[yazproxy-moved-to-github.git] / etc / fennica.xml
1 <?xml version="1.0"?>
2 <!-- $Id: fennica.xml,v 1.4 2004-08-13 13:54:51 adam Exp $ -->
3 <proxy xmlns="http://indexdata.dk/yazproxy/schema/0.8/"
4  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5  xsi:schemaLocation="http://indexdata.dk/yazproxy/schema/0.8/ yazproxy.xsd"
6 >
7   <!-- define default target and name it voyager -->
8   <target default="1" name="voyager">
9     <!-- all backend addresses as seen from this proxy .. -->
10     <url>193.166.7.194:11390</url>
11
12     <!-- set session timeout between proxy and backend target -->
13     <target-timeout>300</target-timeout>
14
15     <!-- set session timeout between client and proxy.
16     Should be lower than target-timeout -->
17     <client-timeout>180</client-timeout>
18
19     <!-- if either bandwidth or pdu limit is reached the session is no
20     longer kept alive -->
21     <keepalive>
22       <bandwidth>500000</bandwidth>
23       <pdu>500</pdu>
24     </keepalive>
25
26     <!-- client limits .. -->
27     <limit>
28       <bandwidth>200000</bandwidth>
29       <pdu>31</pdu>
30       <retrieve>50</retrieve>
31     </limit>
32
33     <!-- use attributes -->
34     <attribute type="1" value="1-13,16,17,20,21,25,27,31,33,41,42,43,48,51,54,56,57,58,59,63,1002-1005,1007,1009,1016,1018,1027,1032,1056,1074,1078,1079,1209"/>
35     <attribute type="1" value="*" error="114"/>
36
37     <!-- relation attributes -->
38     <attribute type="2" value="3"/>
39     <attribute type="2" value="*" error="117"/>
40     
41     <!-- position attributes -->
42     <attribute type="3" value="1,2,3"/>
43     <attribute type="3" value="*" error="119"/>
44
45     <!-- structure attributes -->
46     <attribute type="4" value="1,2"/>
47     <attribute type="4" value="*" error="118"/>
48
49     <!-- truncation attributes -->
50     <attribute type="5" value="1,100"/>
51     <attribute type="5" value="*" error="120"/>
52
53     <!-- completeness attributes -->
54     <attribute type="6" value="1"/>
55     <attribute type="6" value="*" error="122"/>
56
57     <!-- other types -->
58     <attribute type="*" value="*" error="113"/>
59
60     <!-- list allowed record syntaxes and possible schemas (if any);
61     reject all others at the end -->
62     <syntax type="opac"/>
63     <syntax type="finmarc" backendtype="usmarc"/>
64     <zsyntax type="usmarc"/>
65     <syntax type="usmarc" backendtype="canmarc"/>
66     <syntax type="none" backendtype="usmarc"/>
67     
68     <syntax type="xml" marcxml="1"
69       identifier="info:srw/schema/1/marcxml-v1.1" backendtype="canmarc"
70       >
71       <title>MARCXML</title>
72       <name>marcxml</name>
73     </syntax>
74     <syntax type="xml" marcxml="1" stylesheet="MARC21slim2SRWDC.xsl"
75       identifier="info:srw/schema/1/dc-v1.1"
76       >
77       <title>Dublin Core</title>
78       <name>dc</name>
79     </syntax>
80     <syntax type="xml" marcxml="1" stylesheet="MARC21slim2MODS.xsl"
81       identifier="http://www.loc.gov/mods"
82       >
83       <title>MODS v2</title>
84       <name>mods2</name>
85     </syntax>
86     <syntax type="xml" marcxml="1" stylesheet="MARC21slim2MODS3.xsl"
87       identifier="info:srw/schema/1/mods-v3.0"
88       >
89       <title>MODS v3</title>
90       <name>mods3</name>
91       <name>mods</name>
92     </syntax>
93
94     <syntax type="*" error="238"/>
95
96     <!-- keep this number of spare sessions for future sessions -->
97     <preinit>0</preinit>
98
99     <explain xmlns="http://explain.z3950.org/dtd/2.0/">
100       <serverInfo>
101         <host>indexdata.dk</host>
102         <port>9000</port>
103         <database>voyager</database>
104       </serverInfo>
105       
106       <databaseInfo>
107         <title>FENNICA</title>
108         <description lang="en" primary="true">
109           SRW/SRU/Z39.50 Gateway to FENNICA (the Finnish National Bibliography)
110         </description>
111       </databaseInfo>
112       
113       <indexInfo>
114         <set identifier="info:srw/cql-context-set/1/cql-v1.1"
115           name="cql"/>
116         <set identifier="info:srw/cql-context-set/1/dc-v1.1"
117           name="dc"/>
118         <set identifier="http://zing.z3950.org/cql/bath/2.0/"
119           name="bath"/>
120         
121         <index id="4">
122           <title>title</title>
123           <map><name set="dc">title</name></map>
124         </index>
125         <index id="21">
126           <title>subject</title>
127           <map><name set="dc">subject</name></map>
128         </index>
129         <index id="1003">
130           <title>creator</title>
131           <map><name set="dc">creator</name></map>
132           <map><name set="dc">author</name></map>
133         </index>
134         
135         <index id="1020">
136           <title>editor</title>
137           <map><name set="dc">editor</name></map>
138         </index>
139         
140         <index id="1018">
141           <title>publisher</title>
142           <map><name set="dc">publisher</name></map>
143         </index>
144         
145         <index id="62">
146           <title>description</title>
147           <map><name set="dc">description</name></map>
148         </index>
149         
150         <index id="30">
151           <title>date</title>
152           <map><name set="dc">date</name></map>
153         </index>
154         
155         <index id="1002">
156           <title>name</title>
157           <map><name set="bath">name</name></map>
158         </index>
159         
160         <index id="7">
161           <title>isbn</title>
162           <map><name set="bath">isbn</name></map>
163         </index>
164         <index id="8">
165           <title>issn</title>
166           <map><name set="bath">issn</name></map>
167         </index>
168       </indexInfo>
169
170       <schemaInfo>
171         <schema identifier="info:srw/schema/1/marcxml-v1.1"
172           sort="false" name="marcxml">
173           <title>MARCXML</title>
174         </schema>
175         
176         <schema identifier="info:srw/schema/1/dc-v1.1"
177           sort="false" name="dc">
178           <title>Dublin Core</title>
179         </schema>
180         
181         <schema identifier="http://www.loc.gov/mods"
182           sort="false" name="mods2">
183           <title>MODS v2</title>
184         </schema>
185
186         <schema identifier="info:srw/schema/1/mods-v3.0"
187           sort="false" name="mods">
188           <title>MODS v3</title>
189         </schema>
190
191       </schemaInfo>
192
193       <configInfo>
194         <default type="numberOfRecords">0</default>
195       </configInfo>
196     </explain>
197    <cql2rpn>pqf.properties</cql2rpn>
198   </target>
199
200
201   <!-- maximum number of client sessions. Remember to allow for
202      at least max-clients*2+5 sockets. Use 'ulimit -n 1040' on bash -->
203   <max-clients>500</max-clients>
204   
205   <!-- what we log. Allowed tokens: client-apdu, server-apdu,
206   client-requests, server-requests -->
207   <log>client-requests server-requests</log>
208   <!-- commentary:
209 Observerations on the Helsinki Voyager Server.  
210
211 1. Observerations:
212
213 1.1 A client must issue different OID than effective syntax OID.
214 To get USMARC, CanMarc must be sent. To get FINMARC, USMARC must be sent.
215 (OID for MARC21 and USMARC are equivalent). 
216
217 Solution: This is fixed by the 'backend' attribute for 'syntax' sections
218 in the proxy config.
219
220 1.2 Attribute 1=12 seems to work - unlike the Voyager target at LoC.
221
222 Solution: ensure that yazproxy accepts this attribute now that it seems
223 to work.
224
225 1.3 All attributes are accepted by the Server. The appropriate behavior is
226 to return a diagnostic. 
227
228 Solution: "attribute" sections in config is set to only accepts certain
229 attributes. Others are rejected with a diagnostic.
230
231 1.4 When no preferred Record syntax is provided by a client, the Voyager
232 server returns SUTRS record: Failed to retrieve record #x. The correct
233 behavior is to return a default record, say USMARC. The server could also
234 return a diagnostic, but there do not seem to be an appropriate diagnostic
235 for that one.
236
237 Solution: This is fixed by the 'backend' attribute and type='none' for
238 'syntax' sections in the proxy config.
239
240 1.5 Speed of initialize phase. The speed of initilization
241 (init-request/init-response) for the the Voyager target at Helsinki
242 seem to be acceptable.
243
244 Solution: No special precaution to limits/bandwidth needs to be taken.
245
246 1.6 Present Requests out of range. The voyager target does not return
247 a diagnostic when a client presents a record at a position out of the
248 range of a result set.
249
250 Solution: The yazproxy automatically deals with this fault.
251
252 2. List of targets:
253
254 |Database:   |HELKA  (The OPAC of the Helsinki University Libraries)     |
255 |Domain name:|193.166.7.193                                              |
256 |Port:       |7590                                                       |
257 |Database    |voyager                                                    |
258 |name:       |                                                           |
259 |Availability|24 hours a day, 7 days per week. The system is unavailable |
260 |:           |for about 15minutes daily at 1.00am GMT for routine        |
261 |            |maintenance.                                               |
262                                                                                 
263 |Database:   |FENNICA (the Finnish National Bibliography)                |
264 |Domain name:|193.166.7.194                                              |
265 |Port:       |11390                                                      |
266 |Database    |voyager                                                    |
267 |name:       |                                                           |
268 |Availability|24 hours a day, 7 days per week. The system is unavailable |
269 |:           |for about 15minutes daily at 1.00am GMT for routine        |
270 |            |maintenance.                                               |
271                                                                                 
272 |Database:   |LINDA (The Database of Finnish University Libraries)       |
273 |Domain name:|193.166.7.194                                              |
274 |Port:       |11190                                                      |
275 |Database    |Voyager                                                    |
276 |name:       |                                                           |
277 |Availability|24 hours a day, 7 days per week. The system is unavailable |
278 |:           |for about 15minutes daily at 1.00am GMT for routine        |
279 |            |maintenance.                                               |
280                                                                                 
281 |Database:   |MANDA  (Database of Major Public Libraries)                |
282 |Domain name:|193.166.7.194                                              |
283 |Port:       |11290                                                      |
284 |Database    |Voyager                                                    |
285 |name:       |                                                           |
286 |Availability|24 hours a day, 7 days per week. The system is unavailable |
287 |:           |for about 15minutes daily at 1.00am GMT for routine        |
288 |            |maintenance.                                               |
289                                                                                 
290 -->
291 </proxy>