圖一：Isite 資訊系統架構圖
曾元顯 / Yuen-Hsien Tseng
輔仁大學圖書資訊學系
Email: tseng@blue.lins.fju.edu.tw
中國圖書館學會會訊 107 期
http://blue.lins.fju.edu.tw/~tseng/papers/lacz3950-2.htm
Oct. 27, 1997
Accessed times
壹、前言
在會訊104期中我們曾介紹過Isite
Z39.50伺服器的系統架構以及實際架設的情況
[1]，文中提到此系統目前的正式版本（1.8版）還有一些錯誤（bugs），使得整個系統運作並不順暢。其最新的版本（2.0版）一直都還在在測試階段，雖然可以實際安裝使用，但是還沒有正式的安裝與使用說明文件可供參考，使用者必須憑藉過去安裝先前版本的經驗，才能加以運用。因此，本文不對新的測試版本做報導，而著重在正式版本問題解決的說明，期使讀者對正式版本有更深的認識，而能自行試用新的版本。
本文所介紹的 Z39.50 軟體是由美國網路資訊發掘與檢索中心
（CNIDR, Clearinghouse for Networked
Information Discovery and Retrieval）所發展的
Isite 資訊系統 [2]。有關本系統與Z39.50的背景介紹，請參閱前文，這裡僅重複一些必要性的說明。
Isite 軟體目前的正式版本為 1.08 版，可從CNIDR的 FTP站上取得：ftp://ftp.cnidr.org/pub/NIDR.tools/Isite/。我們安裝此版本遭遇的問題，在於透過WWW連線Isite 查詢自建的資料庫時，其檢索結果的顯示，有遺漏不完整的情況。我們利用暑假期間透過對原始程式的追蹤瞭解，將其更正解決。為解釋這些情況，底下將先介紹如何讓自建的資料庫，透過Isite資訊系統提供連線查詢。
貳、Isite與自建資料庫的連結
Isite資訊系統架構如圖一所示，可連結Isite本身的資料庫，也可連結安裝人員自行建立的資料庫。目前
Isite 系統內附有一套英文的全文檢索程式
Isearch，可用以檢索 HTML、SGML、以及無結構性文字檔案等多種文件格式。使用者也可以將已有的資料庫（如書目資料）接上，使其具備
Z39.50 檢索標準的介面。這部份的連結可透過
Isite 制訂的檢索應用程式介面 SAPI（Search
Application Programming Interface）達成。只要使用者自建的資料庫的檢索引擎其輸出與輸入符合此介面的規定，再加上對組態檔（zserver.ini
與 sapi.ini）適當的設定，即可成功連接
zserver 伺服器。
圖一顯示使用者可透過瀏覽器連上WWW伺服器，再透過zgate
與zcon兩支介面程式連上zserver
Z39.50伺服器，zserver伺服器再透過SAPI介面呼叫檢索引擎，檢索引擎將查詢資料庫的結果回報給zserver伺服器，zserver再將結果傳給zcon與zgate程式，透過他們將結果傳給WWW伺服器後，由WWW伺服器傳資料給使用者。在這些程式當中zgate是一支CGI（Common
Gateway Interface）程式 [3]，負責與WWW伺服器的連結，而zcon也是一支介面程式，負責與不同使用者的連結
[1]。圖一中虛線內的程式與檔案都由Isite系統提供，因此讀者只要準備WWW伺服器
[4]、自建的資料庫、以及其檢索引擎即可。
假設自建資料庫的名稱為MyDB, 檢索此資料庫的檢索引擎為MySearch，則建立zserver伺服器與自建資料庫的連結步驟如下：
一、修改組態檔zserver.ini以及sapi.ini的設定並將組態檔放置在適當的目錄下，使zserver瞭解到那裡呼叫MySearch檢索程式，以及到那個檔案拿取檢索結果。
二、修改MySearch檢索引擎資料輸入與輸出的格式及流向（或撰寫通道程式 (gateway) 用以呼叫MySearch以及修改MySearch的輸出格式及流向）。
三、修改gateway.html與search.html兩個使用者的介面檔，並安置在WWW伺服器可以取用的地方，讓使用者可以透過WWW介面叫用。
步驟一中的zserver.ini組態檔，必須修改兩個地方：一是將「Port=6668」改成「Port=210」，意思是將zserver的通訊埠由測試通訊埠改到規定的標準通訊埠上；另一個地方是在「DBList=TestDB」加入自建資料庫的名稱「DBList=TestDB,MyDB」，意思是告訴zserver伺服器系統內多了一個名為MyDB的資料庫。另一個組態檔sapi.ini則同樣必須修改「DBList=TestDB」使成為「DBList=TestDB,MyDB」，另外還要加入一段描述如下：
[MyDB]
Type=SCRIPT
Location=/httpd/cgi-bin/MySearch
Results=/tmp/results
意思是有一個程式MySearch可以透過SAPI呼叫，其位置在「/httpd/cgi-bin/MySearch」，此程式的結果會放在「/tmp」目錄底下以results為檔名開頭的檔案內。
步驟二中，zserver會將瀏覽器端傳來的檢索條件：「字串一[屬性,值] 字串二[屬性,值] �}」，以命令列呼叫的方式叫用MySearch，即：
$/usr/bin/MySearch /tmp/results.<pid> 字串一[屬性,值] 字串二[屬性,值] �}
其中 <pid> 是zserver給定用以識別使用者的號碼。所以MySearch可以從命令列中獲得不同使用者的查詢字串，查詢完畢後，將結果寫到 /tmp/results.<pid> 檔案去，zserver就可由此檔案讀到查詢的結果，送回給提出此項查詢的使用者。MySearch將結果寫到 /tmp/results.<pid> 時，必須遵守下列格式：
[Default]
HitCount=3
Diagnostic=0
Separator=##separator string - your choice ##
[Data]
Record data for record number 1
##separator string - your choice ##
Record data for record number 2
##separator string - your choice ##
Record data for record number 3
此檔案分為兩段，其中 [Data] 段是存放檢索結果的地方，而
[Default] 段則是設定變數的地方，其中HitCount是檢索結果的筆數，而Diagnostic的值若為0表示檢索成功，若為1表示檢索失敗，至於Separator
表示使用者可以自行定義的分隔字串，並不一定是本例中的符號。
步驟三則是設定使用者介面檔。gateway.html要改的地方有二個：一是將
<form name="POST" action="http://localhost/cgi-bin/zgate">
中的localhost改成讀者的主機位址，如
<form name="POST" action="http://lib.fju.edu.tw/cgi-bin/zgate">
第二個地方是將
<OPTION VALUE="/httpd/htdocs/search.html", localhost, 6668>TestDB
改成
<OPTION VALUE="/httpd/htdocs/search.html", lib.fju.edu.tw, 210>MyDB
gateway.html的主要目的，是讓使用者選擇一個適當的資料庫連線，所以上述步驟是將MyDB顯示在網頁中供使用者挑選，然後以通訊埠210連上zserver並進入下一個網頁search.html中。在search.html中要修改的部份是將
<form name="POST"
action="http://localhost/cgi-bin/zgate">
<input type=hidden name="host"
value="localhost">
<input type=hidden name="port"
value="6668">
<input type=hidden name="DBNAME"
value="TestDB">
改成
<form name="POST"
action="/cgi-bin/zgate">
<input type=hidden name="host"
value="Your-Host-address">
<input type=hidden name="port"
value="210">
<input type=hidden name="DBNAME"
value="MyDB">
其中host的值是伺服器主機的位址。
完成以上步驟並將各個檔案拷貝到適當的目錄後，啟動WWW伺服器與Z39.50伺服器，系統就可接受使用者的連線查詢了。
參、Isite錯誤的更正
如前所述，透過WWW連線Isite 查詢自建的資料庫時，其檢索結果的顯示有遺漏不完整的情況。如圖二（一）是使用者查詢介面，使用者選擇每頁顯示三筆結果，圖二（二）檢索結果的第一頁可以正確顯示，但翻下一頁後圖二（三）就顯示無法由此再翻下一頁。此問題看似程式的些許邏輯錯誤，但無法正確的一頁一頁瀏覽結果卻是使用者相當大的困擾。經過對原始程式碼的追蹤理解後，我們發現有三個部份要修改，才能使顯示的狀況前後一致。此三個部份都發生在Isite系統所在目錄的子目錄zdist的原始程式檔zcon.cxx內。第一個部份是將zcon.cxx檔案285行及340行的
fprintf(fp, "<input name=\"ESNAME\" value=\"B\" type=\"HIDDEN\">");
改成
fprintf(fp, "<input name=\"ESNAME\" value=\"F\" type=\"HIDDEN\">");
第二部份是將307行、334行以及346行註解起來（即在該行的最前面插入C++的註解符號：「//」兩個右斜線），讓他們變成不可執行的敘述。第三個部份則將277行與331行的字串：「More
on this record」刪除，其餘不動。如此修改後，重新編譯程式，將編譯後的可執行程式zcon拷貝到WWW的CGI程式目錄下即可。修改後的系統運作情況即可如圖三（一）與圖三（二）顯示正確結果了。
結語
目前 Isite 的
1.08 版還沒能完全符合 Z39.50 的規定，新版本
2.0 版已測試超過半年，我們曾在Linux系統上測試新版本的安裝，可惜未能成功。如果有機會、有更多的時間能在不同的Unix
版本上測試，應該可以安裝並成功架設起新版的Z39.50伺服器。
參考資料
[1] 曾元顯，"架構一個 WWW 上的 Z39.50 伺服器"，中國圖書館學會會訊，5卷1期（104），85年3月31日。Also available at http://blue.lins.fju.edu.tw/~tseng/papers/lacz3950.htm
[2] CNIDR resources for information discovery and retrieval, http://www.cnidr.org/ir/ir.html
[3] 曾元顯，"增加 Home Page 的互動性-- CGI 程式與資料庫的運用"，中國圖書館學會會訊，4卷2期（101），85年6月31日。Also available at http://blue.lins.fju.edu.tw/~tseng/cgi.htm
[4] 曾元顯，"架個
WWW 伺服器"，
中國圖書館學會會訊，4
卷
1 期（100），85
年
3 月
31 日，頁57-60。
