# IR toolkit for tcl/tk
-# (c) Index Data 1995
+# (c) Index Data 1995-1998
# See the file LICENSE for details.
# Sebastian Hammer, Adam Dickmeiss
#
# $Log: client.tcl,v $
-# Revision 1.68 1995-09-21 13:11:49 adam
+# Revision 1.104 1998-02-12 13:32:41 adam
+# Updated configuration system.
+#
+# Revision 1.103 1998/01/30 13:30:50 adam
+# Name of target database is irtdb.tcl instead of clientrc.tcl.
+#
+# Revision 1.102 1997/11/19 13:19:54 adam
+# Font fix.
+#
+# Revision 1.101 1997/11/19 11:20:56 adam
+# New target profile format - associative arrrays instead of LONG lists.
+#
+# Revision 1.100 1997/09/09 10:19:50 adam
+# New MSV5.0 port with fewer warnings.
+#
+# Revision 1.99 1997/04/13 19:00:37 adam
+# Added support for Tcl8.0/Tk8.0.
+# New command ir-log-init to setup yaz logging facilities.
+#
+# Revision 1.98 1996/11/14 17:11:04 adam
+# Added Explain documentaion.
+#
+# Revision 1.97 1996/09/13 10:54:22 adam
+# Started work on Explain in client.
+#
+# Revision 1.96 1996/08/09 15:30:18 adam
+# Procedure destroyGW modified to handle multiple calls - probably an
+# error introduced by tk4.1 patch level 1.
+#
+# Revision 1.95 1996/07/26 09:15:08 adam
+# IrTcl version 1.2 patch level 1.
+#
+# Revision 1.94 1996/07/25 15:55:34 adam
+# IrTcl version 1.2 release.
+#
+# Revision 1.93 1996/06/28 08:43:54 adam
+# Moved towards version 1.2.
+#
+# Revision 1.92 1996/03/29 16:04:30 adam
+# Work on GRS-1 presentation.
+#
+# Revision 1.91 1996/03/27 17:00:53 adam
+# Fix: main defined when using Tk3.6; it shouldn't be.
+#
+# Revision 1.90 1996/03/20 13:54:02 adam
+# The Tcl_File structure is only manipulated in the Tk-event interface
+# in tkinit.c.
+#
+# Revision 1.89 1996/03/05 09:16:04 adam
+# Sets tearoff to off on several menus.
+#
+# Revision 1.88 1996/01/23 15:24:09 adam
+# Wrore more comments.
+#
+# Revision 1.87 1996/01/22 17:13:34 adam
+# Wrote comments.
+#
+# Revision 1.86 1996/01/22 09:29:01 adam
+# Wrote comments.
+#
+# Revision 1.85 1996/01/19 16:22:36 adam
+# New method: apduDump - returns information about last incoming APDU.
+#
+# Revision 1.84 1996/01/11 13:12:10 adam
+# Bug fix.
+#
+# Revision 1.83 1995/11/28 17:26:36 adam
+# Removed Carriage return from ir-tcl.c!
+# Removed misc. debug logs.
+#
+# Revision 1.82 1995/11/02 08:47:56 adam
+# Text widgets are flat now.
+#
+# Revision 1.81 1995/10/19 10:34:43 adam
+# More configurable client.
+#
+# Revision 1.80 1995/10/18 17:20:32 adam
+# Work on target setup in client.tcl.
+#
+# Revision 1.79 1995/10/18 16:42:37 adam
+# New settings: smallSetElementSetNames and mediumSetElementSetNames.
+#
+# Revision 1.78 1995/10/18 15:45:36 quinn
+# *** empty log message ***
+#
+# Revision 1.77 1995/10/18 15:37:46 adam
+# Piggy-back present.
+#
+# Revision 1.76 1995/10/18 15:15:20 adam
+# Fixed bug.
+#
+# Revision 1.75 1995/10/17 14:18:05 adam
+# Minor changes in presentation formats.
+#
+# Revision 1.74 1995/10/17 12:18:57 adam
+# Bug fix: when target connection closed, the connection was not
+# properly reestablished.
+#
+# Revision 1.73 1995/10/17 10:58:06 adam
+# More work on presentation formats.
+#
+# Revision 1.72 1995/10/16 17:00:52 adam
+# New setting: elementSetNames.
+# Various client improvements. Medium presentation format looks better.
+#
+# Revision 1.71 1995/10/13 15:35:27 adam
+# Relational operators may be used in search entries - changes
+# in proc index-query.
+#
+# Revision 1.70 1995/10/12 14:46:52 adam
+# Better record popup windows. Next/prev buttons in popup record windows.
+# The record position in the raw format is much more visible.
+#
+# Revision 1.69 1995/09/21 13:42:54 adam
+# Bug fixes.
+#
+# Revision 1.68 1995/09/21 13:11:49 adam
# Support of dynamic loading.
# Test script uses load command if necessary.
#
#
#
+# Procedure tk4 is defined - returns 0 if tk 3.6 - returns 1 otherwise
if {$tk_version == "3.6"} {
proc tk4 {} {
return 0
}
}
+# The following procedures deals with menu entries. The interface
+# changed from Tk 3.6 to 4.X
+
+# Procedure irmenu
+if {[tk4]} {
+ proc irmenu {w} {
+ menu $w -tearoff off
+ }
+} else {
+ proc irmenu {w} {
+ menu $w
+ }
+}
+
+# Procedure configure-enable-e {w n}
+# w is a menu
+# n menu entry number (0 is first entry)
+# Enables menu entry
+
+# Procedure configure-disable-e {w n}
+# w is a menu
+# n menu entry number (0 is first entry)
+# Disables menu entry
+
if {[tk4]} {
proc configure-enable-e {w n} {
- incr n
+# incr n
$w entryconfigure $n -state normal
}
proc configure-disable-e {w n} {
- incr n
+# incr n
$w entryconfigure $n -state disabled
}
set noFocus [list -takefocus 0]
set noFocus {}
}
+# Define dummy clock function if it is not there.
+if {[catch {clock seconds}]} {
+ proc clock {args} {
+ return {}
+ }
+}
+# Set monoFlag to 1 if screen is known not to support colors; otherwise
+# set monoFlag to 0
if {![tk4]} {
if {[tk colormodel .] == "color"} {
set monoFlag 0
set monoFlag 0
}
+# Define libdir to the IrTcl configuration directory.
+# In the line below LIBDIR will be modified during 'make install'.
set libdir LIBDIR
+
+# If the bitmaps sub directory is present with a bitmap we assume
+# the client is run from the source directory in which case we
+# set libdir the current directory.
if {[file readable bitmaps/book2]} {
set libdir .
}
+
+# Make a final check to see if libdir was set ok.
if {! [file readable ${libdir}/bitmaps/book2]} {
puts "Cannot locate system files in ${libdir}. You must either run this"
puts "program from the source directory root of ir-tcl or you must assure"
exit 1
}
+# Initialize a lot of globals.
set hotTargets {}
set hotInfo {}
set busy 0
-set profile(Default) {{} {} {210} {} 16384 8192 tcpip {} 1 {} {} Z39 1}
+set profile(Default,description) {}
+set profile(Default,host) {}
+set profile(Default,port) 210
+set profile(Default,authentication) {}
+set profile(Default,maximumRecordSize) 50000
+set profile(Default,preferredMessageSize) 30000
+set profile(Default,comstack) tcpip
+set profile(Default,namedResultSets) 1
+set profile(Default,queryRPN) 1
+set profile(Default,queryCCL) 0
+set profile(Default,protocol) Z39
+set profile(Default,windowNumber) 1
+set profile(Default,largeSetLowerBound) 2
+set profile(Default,smallSetUpperBound) 0
+set profile(Default,mediumSetPresentNumber) 0
+set profile(Default,presentChunk) 4
+set profile(Default,timeDefine) {}
+set profile(Default,timeLastInit) {}
+set profile(Default,timeLastExplain) {}
+set profile(Default,targetInfoName) {}
+set profile(Default,recentNews) {}
+set profile(Default,maxResultSets) {}
+set profile(Default,maxResultSize) {}
+set profile(Default,maxTerms) {}
+set profile(Default,multipleDatabases) 0
+set profile(Default,welcomeMessage) {}
+
set hostid Default
set settingsChanged 0
set setNo 0
set setNoLast 0
set cancelFlag 0
set scanEnable 0
-set fullMarcSeq 0
set displayFormat 1
set popupMarcdf 0
set textWrap word
set recordSyntax None
+set elementSetNames None
set delayRequest {}
+set debugMode 0
set queryTypes {Simple}
set queryButtons { { {I 0} {I 1} {I 2} } }
set setOffset 0
set setMax 0
-proc tkerror err {
- set w .tkerrorw
+if {[lindex [split $tk_version .] 0] < 5} {
+ set font(bb,normal) -Adobe-Helvetica-Medium-R-Normal-*-240-*
+ set font(bb,bold) -Adobe-Helvetica-Bold-R-Normal-*-240-*
+ set font(b,normal) -Adobe-Helvetica-Medium-R-Normal-*-180-*
+ set font(b,bold) -Adobe-Helvetica-Bold-R-Normal-*-180-*
+ set font(n,normal) -Adobe-Helvetica-Medium-R-Normal-*-120-*
+ set font(n,bold) -Adobe-Helvetica-Bold-R-Normal-*-120-*
+ set font(s,bold) -Adobe-Helvetica-Bold-R-Normal-*-100-*
+ set font(ss,bold) -Adobe-Helvetica-Bold-R-Normal-*-80-*
+} else {
+ set font(bb,normal) {Helvetica 24}
+ set font(bb,bold) {Helvetica 24 bold}
+ set font(b,normal) {Helvetica 24}
+ set font(b,bold) {Helvetica 18 bold}
+ set font(n,normal) {Helvetica 12}
+ set font(n,bold) {Helvetica 12 bold}
+ set font(s,bold) {Helvetica 10 bold}
+ set font(ss,bold) {Helvetica 8 bold}
+}
- if {[winfo exists $w]} {
- destroy $w
+# Procedure tkerror {err}
+# err error message
+# Override the Tk error handler function.
+if {1} {
+ proc tkerror err {
+ global font
+ set w .tkerrorw
+
+ if {[winfo exists $w]} {
+ destroy $w
+ }
+ toplevel $w
+ wm title $w "Error"
+
+ place-force $w .
+ top-down-window $w
+
+ label $w.top.b -bitmap error
+ message $w.top.t -aspect 300 -text "Error: $err" \
+ -font $font(b,bold)
+ pack $w.top.b $w.top.t -side left -padx 10 -pady 10
+
+ bottom-buttons $w [list {Close} [list destroy $w]] 1
}
- toplevel $w
- wm title $w "Error"
+}
+# Read tag set file (if present)
+if {[file readable "${libdir}/tagsets.tcl"]} {
+ source "${libdir}/tagsets.tcl"
+}
- place-force $w .
- top-down-window $w
+# Read the global target configuration file.
+if {[file readable "${libdir}/irtdb.tcl"]} {
+ source "${libdir}/irtdb.tcl"
+}
+# Read the local target configuration file.
+if {[file readable "irtdb.tcl"]} {
+ source "irtdb.tcl"
+}
- label $w.top.b -bitmap error
- message $w.top.t -aspect 300 -text "Error: $err" \
- -font -Adobe-Helvetica-Bold-R-Normal-*-180-*
- pack $w.top.b $w.top.t -side left -padx 10 -pady 10
+# Read the user configuration file.
+if {[file readable "~/.clientrc.tcl"]} {
+ source "~/.clientrc.tcl"
+}
- bottom-buttons $w [list {Close} [list destroy $w]] 1
+# Convert old format to new format...
+foreach target [array names profile] {
+ set timedef [clock seconds]
+ if {[string first , $target] == -1} {
+ if {![info exists profile($target,port)]} {
+ foreach n [array names profile Default,*] {
+ set profile($target,[string range $n 8 end]) $profile($n)
+ }
+ set profile($target,description) [lindex $profile($target) 0]
+ set profile($target,host) [lindex $profile($target) 1]
+ set profile($target,port) [lindex $profile($target) 2]
+ set profile($target,authentication) [lindex $profile($target) 3]
+ set profile($target,maximumRecordSize) \
+ [lindex $profile($target) 4]
+ set profile($target,preferredMessageSize) \
+ [lindex $profile($target) 5]
+ set profile($target,comstack) [lindex $profile($target) 6]
+ set profile($target,databases) [lindex $profile($target) 7]
+ set profile($target,timeDefine) $timedef
+ set profile($target,windowNumber) 1
+ }
+ unset profile($target)
+ }
+}
+
+# Assign unique ID's to each target's window number
+set wno 1
+foreach n [array names profile *,windowNumber] {
+ set profile($n) $wno
+ incr wno
}
+set profile(Default,windowNumber) $wno
+# These globals describe the current query type. They are set to the
+# first query type.
+set queryButtonsFind [lindex $queryButtons 0]
+set queryInfoFind [lindex $queryInfo 0]
+
+# Procedure read-formats
+# Read all Tcl source files in the subdirectory 'formats'.
+# The name of each source will correspond to a display format.
proc read-formats {} {
global displayFormats
global libdir
- if {[catch {set formats [glob -nocomplain ${libdir}/formats/*.tcl]}]} {
- set formats ./formats/raw.tcl
- }
+
+ set oldDir [pwd]
+ cd ${libdir}/formats
+ set formats [glob {*.[tT][cC][lL]}]
foreach f $formats {
if {[file readable $f]} {
source $f
set l [string length $f]
- set f [string range $f [string length "${libdir}/formats/"] \
- [expr $l - 5]]
+ set f [string tolower [string range $f 0 [expr $l - 5]]]
lappend displayFormats $f
}
}
+ cd $oldDir
}
+# Procedure set-wrap {m}
+# m boolean wrap mode
+# Handler to enable/disable text wrap in the main record window
proc set-wrap {m} {
global textWrap
.data.record configure -wrap $m
}
+# Procedure dputs {m}
+# m string to be printed
+# puts utility for debugging.
proc dputs {m} {
+ global debugMode
+ if {$debugMode} {
+ puts $m
+ }
}
+# Procedure apduDump {}
+# Logs BER dump of last APDU in window if debugMode is true.
+proc apduDump {} {
+ global debugMode
+
+ set w .apdu
+
+ if {$debugMode == 0} return
+ set x [z39 apduInfo]
+
+ set offset [lindex $x 1]
+ set length [lindex $x 0]
+
+ if {![winfo exists $w]} {
+ catch {destroy $w}
+ toplevelG $w
+
+ wm title $w "APDU information"
+
+ wm minsize $w 0 0
+
+ top-down-window $w
+
+ text $w.top.t -font fixed -width 60 -height 12 -wrap word \
+ -relief flat -borderwidth 0 \
+ -yscrollcommand [list $w.top.s set] -background grey85
+ scrollbar $w.top.s -command [list $w.top.t yview]
+
+ pack $w.top.s -side right -fill y
+ pack $w.top.t -expand yes -fill both
+
+ bottom-buttons $w [list {Close} [list destroy $w]] 0
+ }
+ $w.top.t insert end "Length: ${length}\n"
+ if {$offset != -1} {
+ $w.top.t insert end "Offset: ${offset}\n"
+ }
+ $w.top.t insert end [lindex $x 2]
+ $w.top.t insert end "---------------------------------\n"
+
+}
+
+# Procedure set-display-format {f}
+# f display format
+# Reformats main record window to use display format given by f
proc set-display-format {f} {
- global displayFormat
- global setNo
- global busy
+ global displayFormat setNo busy
set displayFormat $f
if {$setNo == 0} {
add-title-lines -1 10000 1
}
+# Procedure initBindings
+# Disables various default bindings for Text and Listbox widgets.
proc initBindings {} {
- set w Text
- bind $w <1> {}
- bind $w <Double-1> {}
- bind $w <Triple-1> {}
- bind $w <B1-Motion> {}
- bind $w <Shift-1> {}
- bind $w <Shift-B1-Motion> {}
- bind $w <2> {}
- bind $w <B2-Motion> {}
- bind $w <Any-KeyPress> {}
- bind $w <Return> {}
- bind $w <BackSpace> {}
- bind $w <Delete> {}
- bind $w <Control-h> {}
- bind $w <Control-d> {}
- bind $w <Control-v> {}
+ global TextBinding
+ foreach e [bind Text] {
+ set TextBinding($e) [bind Text $e]
+ bind Text $e {}
+ }
set w Listbox
bind $w <B1-Motion> {}
bind $w <Shift-B1-Motion> {}
set w Entry
}
+# Procedure TextEditable
+# Apply "standard" events to a text widget. It should be editable now.
+proc TextEditable {w} {
+ global TextBinding
+
+ foreach e [array names TextBinding] {
+ bind $w $e $TextBinding($e)
+ }
+}
+
+# Procedure post-menu {wbutton wmenu}
+# wbutton button widget
+# wmenu menu widget
+# Post menu near button. Note: not used.
proc post-menu {wbutton wmenu} {
$wmenu activate none
focus $wmenu
}
+# Procedure destroyGW {w}
+# w top level widget
+# Saves geometry of widget w in windowGeometry array. This
+# Procedure is used to save current geometry of a window before
+# it is destroyed.
+# See also topLevelG.
proc destroyGW {w} {
global windowGeometry
- set windowGeometry($w) [wm geometry $w]
+ catch {set windowGeometry($w) [wm geometry $w]}
}
+
+# Procedure topLevelG
+# w top level widget
+# Makes a new top level widget named w; sets geometry of window if it
+# exists in windowGeometry array. The destroyGW procedure is set
+# to be called when the Destroy event occurs.
proc toplevelG {w} {
global windowGeometry
bind $w <Destroy> [list destroyGW $w]
}
-if {[file readable "clientrc.tcl"]} {
- source "clientrc.tcl"
-} else {
- if {[file readable "${libdir}/clientrc.tcl"]} {
- source "${libdir}/clientrc.tcl"
- }
-}
-
-if {[file readable "~/.clientrc.tcl"]} {
- source "~/.clientrc.tcl"
-}
-
-set queryButtonsFind [lindex $queryButtons 0]
-set queryInfoFind [lindex $queryInfo 0]
-
+# Procedure top-down-window {w}
+# w window (possibly top level)
+# Makes two frames inside w called top and bot.
proc top-down-window {w} {
frame $w.top -relief raised -border 1
frame $w.bot -relief raised -border 1
pack $w.bot -fill both
}
+# Procedure top-down-ok-cancel {w ok-action g}
+# w top level widget with $w.bot-frame
+# ok-action ok script
+# g grab flag
+# Makes two buttons in the bot frame called Ok and Cancel. The
+# ok-action is executed if Ok is pressed. If Cancel is activated
+# The window is destroyed. If g is true a grab is performed on the
+# window and the procedure waits until the window is destroyed.
proc top-down-ok-cancel {w ok-action g} {
frame $w.bot.left -relief sunken -border 1
pack $w.bot.left -side left -expand yes -ipadx 2 -ipady 2 -padx 1 -pady 1
}
}
+# Procedure bottom-buttons {w buttonList g}
+# w top level widget with $w.bot-frame
+# buttonList button specifications
+# g grab flag
+# Makes a list of buttons in the $w.bot frame. The buttonList is a list
+# of button specifications. Each button specification consists of two
+# items; the first item is button label name; the second item is a script
+# of be executed when that button is executed. A grab is performed if g
+# is true and it waits for the window to be destroyed.
proc bottom-buttons {w buttonList g} {
set i 0
set l [llength $buttonList]
}
}
+# Procedure cancel-operation
+# This handler is invoked when the user wishes to cancel an operation.
+# If the system is currently busy a "Cancel" will be displayed in the
+# status area and the cancelFlag is set to true indicating that future
+# responses from the target should be ignored. The system is no longer
+# busy when this procedure exists.
proc cancel-operation {} {
- global cancelFlag
- global busy
- global delayRequest
+ global cancelFlag busy delayRequest
if {$busy} {
set cancelFlag 1
}
}
+# Procedure show-target {target base}
+# target name of target
+# base name of database
+# Displays target name and database name in the target status area.
proc show-target {target base} {
- global profile
-
- if {$target == ""} {
- .bot.a.target configure -text ""
+ if {![string length $target]} {
+ .bot.a.target configure -text {}
return
}
- if {$base == ""} {
+ if {![string length $base]} {
.bot.a.target configure -text "$target"
} else {
.bot.a.target configure -text "$target - $base"
}
}
+# Procedure show-logo {v1}
+# v1 integer level
+# This procedure maintains the book logo in the bottom of the screen.
+# It is invoked only once during initialization of windows, etc., and
+# by itself. The global 'busy' variable determines whether the logo is
+# moving or not.
proc show-logo {v1} {
- global busy
- global libdir
+ global busy libdir
if {$busy != 0} {
incr v1
}
}
}
-
+
+# Procedure show-status {status b sb}
+# status status message string
+# b busy indicator
+# sb search busy indicator
+# Display status information according to 'status' and sets the global
+# busy flag 'busy' to b if b is non-empty. If sb is non-empty it indicates
+# whether service buttons should be enabled or disabled.
proc show-status {status b sb} {
- global busy
- global scanEnable
- global setOffset
- global setMax
- global setNo
+ global busy scanEnable
+ global setOffset setMax setNo
.bot.a.status configure -text "$status"
if {$b == 1} {
.mid.search configure -state normal
if {$scanEnable} {
.mid.scan configure -state normal
+ } else {
+ configure-disable-e .top.service.m 3
}
if {$setNo == 0} {
configure-disable-e .top.service.m 1
}
}
+# Procedure show-message {msg}
+# msg message string
+# Sets message the bottom of the screen to msg.
proc show-message {msg} {
.bot.a.message configure -text "$msg"
}
+# Procedure insertWithTags {w text args}
+# w text widget
+# text string to be inserted
+# args list of tags
+# Inserts text at the insertion point in widget w. The text is tagged
+# with the tags in args.
proc insertWithTags {w text args} {
set start [$w index insert]
$w insert insert $text
}
}
+# Procedure popup-license
+# Displays LICENSE information.
proc popup-license {} {
global libdir
set w .popup-licence
top-down-window $w
- text $w.top.t -width 80 -height 10 -wrap word \
- -yscrollcommand [list $w.top.s set]
+ text $w.top.t -width 80 -height 10 -wrap word -relief flat -borderwidth 0 \
+ -font fixed -yscrollcommand [list $w.top.s set]
scrollbar $w.top.s -command [list $w.top.t yview]
pack $w.top.s -side right -fill y
bottom-buttons $w [list {Close} [list destroy $w]] 1
}
+# Procedure about-target
+# Displays various information about the current target, such
+# as implementation-name, implementation-id, etc.
proc about-target {} {
set w .about-target-w
- global hostid
+ global hostid font
toplevel $w
pack $w.top.a $w.top.p -side top -fill x
label $w.top.a.about -text "About"
- label $w.top.a.irtcl -text $hostid \
- -font -Adobe-Helvetica-Bold-R-Normal-*-240-*
+ label $w.top.a.irtcl -text $hostid -font $font(bb,bold)
pack $w.top.a.about $w.top.a.irtcl -side top
set i [z39 targetImplementationName]
bottom-buttons $w [list {Close} [list destroy $w]] 1
}
+# Procedure about-origin-logo {n}
+# n integer level
+# Displays book logo in the .about-origin-w widget
proc about-origin-logo {n} {
global libdir
set w .about-origin-w
after 140 [list about-origin-logo $n]
}
+# Procedure about-origin
+# Display various information about origin (this client).
proc about-origin {} {
set w .about-origin-w
- global libdir
+ global libdir font tk_version
if {[winfo exists $w]} {
destroy $w
pack $w.top.a $w.top.p -side top -fill x
- label $w.top.a.irtcl -text "IrTcl" \
- -font -Adobe-Helvetica-Bold-R-Normal-*-240-*
+ label $w.top.a.irtcl -text "IrTcl" -font $font(bb,bold)
label $w.top.a.logo -bitmap @${libdir}/bitmaps/book1
pack $w.top.a.irtcl $w.top.a.logo -side left -expand yes
label $w.top.p.ii -text "Implementation id: $i"
catch {set i [z39 implementationVersion]}
label $w.top.p.iv -text "Implementation version: $i"
+ set i $tk_version
+ label $w.top.p.tk -text "Tk version: $i"
- pack $w.top.p.in $w.top.p.ii $w.top.p.iv -side top -anchor nw
+ pack $w.top.p.in $w.top.p.ii $w.top.p.iv $w.top.p.tk -side top -anchor nw
about-origin-logo 1
bottom-buttons $w [list {Close} [list destroy $w] \
{License} [list popup-license]] 0
}
+# Procedure popup-marc {sno no b df}
+# sno result set number
+# no record position number
+# b popup window number
+# df display format
+# Displays record in set $sno at position $no in window .full-marc$b.
+# The global variable $popupMarcdf holds the current format method.
proc popup-marc {sno no b df} {
- global fullMarcSeq
- global displayFormats
- global popupMarcdf
+ global font displayFormats popupMarcdf
if {[z39.$sno type $no] != "DB"} {
return
}
- if {$b} {
- set w .full-marc-$fullMarcSeq
- incr fullMarcSeq
- set df $popupMarcdf
- } else {
- set w .full-marc
- set df $popupMarcdf
+ if {$b == -1} {
+ set b 0
+ while {[winfo exists .full-marc$b]} {
+ incr b
+ }
}
- if {[winfo exists $w]} {
- set new 0
- } else {
-
+ set df $popupMarcdf
+ set w .full-marc$b
+ if {![winfo exists $w]} {
toplevelG $w
wm minsize $w 0 0
pack $w.top -side top -fill both -expand yes
pack $w.bot -fill both
- text $w.top.record -width 60 -height 5 -wrap word \
- -yscrollcommand [list $w.top.s set]
+ text $w.top.record -width 60 -height 5 -wrap word -relief flat \
+ -borderwidth 0 -font fixed \
+ -yscrollcommand [list $w.top.s set] -background grey85
scrollbar $w.top.s -command [list $w.top.record yview]
global monoFlag
$w.top.record tag configure marc-id -foreground black
}
$w.top.record tag configure marc-data -foreground black
- set new 1
- }
- $w.top.record delete 0.0 end
- set recordType [z39.$sno recordType $no]
- wm title $w "$recordType record #$no"
+ $w.top.record tag configure marc-head -font $font(n,bold) \
+ -background black -foreground white
+
+ $w.top.record tag configure marc-pref -font $font(n,normal) \
+ -foreground blue
+ $w.top.record tag configure marc-text -font $font(n,normal) \
+ -foreground black
+ $w.top.record tag configure marc-it -font $font(n,normal) \
+ -foreground black
- if {$new} {
- bind $w.top.record <Return> {destroy .full-marc}
-
pack $w.top.s -side right -fill y
pack $w.top.record -expand yes -fill both
- if {$b} {
- bottom-buttons $w [list \
- {Close} [list destroy $w]] 0
- } else {
- bottom-buttons $w [list \
- {Close} [list destroy $w] \
- {Duplicate} [list popup-marc $sno $no 1 0]] 0
- menubutton $w.bot.formats -text "Format" -menu $w.bot.formats.m
- menu $w.bot.formats.m
- set i 0
- foreach f $displayFormats {
- $w.bot.formats.m add radiobutton -label $f \
- -variable popupMarcdf -value $i \
- -command [list display-$f $sno $no $w.top.record 0]
- incr i
- }
- pack $w.bot.formats -expand yes -ipadx 2 -ipady 2 \
- -padx 3 -pady 3 -side left
- }
+ bottom-buttons $w [list \
+ {Close} [list destroy $w] \
+ {Prev} {} \
+ {Next} {} \
+ {Duplicate} {}] 0
+ menubutton $w.bot.formats -text "Format" -menu $w.bot.formats.m \
+ -relief raised
+ irmenu $w.bot.formats.m
+ pack $w.bot.formats -expand yes -ipadx 2 -ipady 2 \
+ -padx 3 -pady 3 -side left
} else {
- set i 0
$w.bot.formats.m delete 0 last
- foreach f $displayFormats {
- $w.bot.formats.m add radiobutton -label $f \
- -variable popupMarcdf -value $i \
- -command [list display-$f $sno $no $w.top.record 0]
- incr i
- }
}
+ set i 0
+ foreach f $displayFormats {
+ $w.bot.formats.m add radiobutton -label $f \
+ -variable popupMarcdf -value $i \
+ -command [list popup-marc $sno $no $b 0]
+ incr i
+ }
+ $w.top.record delete 0.0 end
+ set recordType [z39.$sno recordType $no]
+ wm title $w "$recordType record #$no"
+
+ $w.bot.2 configure -command \
+ [list popup-marc $sno [expr $no-1] $b $df]
+ $w.bot.4 configure -command \
+ [list popup-marc $sno [expr $no+1] $b $df]
+ if {$no == 1} {
+ $w.bot.2 configure -state disabled
+ } else {
+ $w.bot.2 configure -state normal
+ }
+ if {[z39.$sno type [expr $no+1]] != "DB"} {
+ $w.bot.4 configure -state disabled
+ } else {
+ $w.bot.4 configure -state normal
+ }
+ $w.bot.6 configure -command [list popup-marc $sno $no -1 0]
set ffunc [lindex $displayFormats $df]
set ffunc "display-$ffunc"
$ffunc $sno $no $w.top.record 0
}
+# Procedure update-target-hotlist {target base}
+# target current target name
+# base current database name
+# Updates the global $hotTargets so that $target and $base are
+# moved to the front, i.e. they become the number 1 target/base.
+# The target menu is updated by a call to set-target-hotlist.
proc update-target-hotlist {target base} {
global hotTargets
set-target-hotlist $olen
}
+# Procedure delete-target-hotlist {target}
+# target target to be deleted
+# Updates the global $hotTargets so that $target is removed.
+# The target menu is updated by a call to set-target-hotlist.
proc delete-target-hotlist {target} {
global hotTargets
set-target-hotlist $olen
}
+# Procedure set-target-hotlist {olen}
+# olen number of hot target entries to be deleted from menu
+# Updates the target menu with the targets with the first 8 entries
+# in the $hotTargets global.
proc set-target-hotlist {olen} {
global hotTargets
if {$olen > 0} {
if {[tk4]} {
- .top.target.m delete 7 [expr 7+$olen]
+ .top.target.m delete 6 [expr 6+$olen]
} else {
.top.target.m delete 6 [expr 6+$olen]
}
foreach e $hotTargets {
set target [lindex $e 0]
set base [lindex $e 1]
- if {$base == ""} {
+ if {![string length $base]} {
.top.target.m add command -label "$i $target" -command \
[list reopen-target $target {}]
} else {
}
}
+# Procedure reopen-target {target base}
+# target target to be opened
+# base base to be used
+# Closes connection with current target and opens a new connection
+# with $target and database $base.
proc reopen-target {target base} {
close-target
open-target $target $base
update-target-hotlist $target $base
}
+# Procedure define-target-action
+# Prepares the setup of a new target. The name of the target
+# is read from the dialog .target-define dialog (procedure
+# define-target-dialog) and the target definition window is displayed by
+# a call to protocol-setup.
proc define-target-action {} {
global profile
set target [.target-define.top.target.entry get]
- if {$target == ""} {
+ if {![string length $target]} {
return
}
- foreach n [array names profile] {
- if {$n == $target} {
+ foreach n [array names profile *,host] {
+ if {![string compare $n ${target},host]} {
+ destroy .target-define
protocol-setup $n
return
}
}
- set seq [lindex $profile(Default) 12]
- dputs "seq=${seq}"
- set profile($target) $profile(Default)
- set profile(Default) [lreplace $profile(Default) 12 12 [incr seq]]
+ foreach n [array names profile Default,*] {
+ set profile($target,[string range $n 8 end]) $profile($n)
+ }
+ incr profile(Default,windowNumber)
+
protocol-setup $target
destroy .target-define
}
+# Procedure fail-response {target}
+# target current target
+# Error handler (IrTcl failback) that takes care of serious protocol
+# errors, connection lost, etc.
proc fail-response {target} {
+ global debugMode
+
set c [lindex [z39 failInfo] 0]
set m [lindex [z39 failInfo] 1]
+ if {$c == 4 || $c == 5} {
+ set debugMode 1
+ apduDump
+ }
close-target
tkerror "$m ($c)"
}
+# Procedure connect-response {target base}
+# target current target
+# base current database
+# IrTcl connect response handler.
proc connect-response {target base} {
dputs "connect-response"
- show-target $target $base
- init-request
+ init-request $target $base
}
+# Procedure open-target {target base}
+# target target to be opened
+# base database to be used
+# Opens a new connection with $target/$base.
proc open-target {target base} {
global profile
global hostid
+ global presentChunk
z39 disconnect
- z39 comstack [lindex $profile($target) 6]
- z39 protocol [lindex $profile($target) 11]
- z39 idAuthentication [lindex $profile($target) 3]
- z39 maximumRecordSize [lindex $profile($target) 4]
- z39 preferredMessageSize [lindex $profile($target) 5]
- dputs "maximumRecordSize="
- dputs [z39 maximumRecordSize]
- dputs "preferredMessageSize="
- dputs [z39 preferredMessageSize]
+ z39 comstack $profile($target,comstack)
+ z39 protocol $profile($target,protocol)
+ eval z39 idAuthentication $profile($target,authentication)
+ z39 maximumRecordSize $profile($target,maximumRecordSize)
+ z39 preferredMessageSize $profile($target,preferredMessageSize)
+ dputs "maximumRecordSize=[z39 maximumRecordSize]"
+ dputs "preferredMessageSize=[z39 preferredMessageSize]"
show-status Connecting 1 0
- if {$base == ""} {
- z39 databaseNames [lindex [lindex $profile($target) 7] 0]
- } else {
- z39 databaseNames $base
+ set x $profile($target,largeSetLowerBound)
+ if {![string length $x]} {
+ set x 2
+ }
+ z39 largeSetLowerBound $x
+
+ set x $profile($target,smallSetUpperBound)
+ if {![string length $x]} {
+ set x 0
+ }
+ z39 smallSetUpperBound $x
+
+ set x $profile($target,mediumSetPresentNumber)
+ if {![string length $x]} {
+ set x 0
}
+ z39 mediumSetPresentNumber $x
+
+ set presentChunk $profile($target,presentChunk)
+ if {![string length $presentChunk]} {
+ set presentChunk 4
+ }
+
z39 failback [list fail-response $target]
z39 callback [list connect-response $target $base]
+ show-target $target $base
update idletasks
set err [catch {
- z39 connect [lindex $profile($target) 1]:[lindex $profile($target) 2]
+ z39 connect $profile($target,host):$profile($target,port)
} errorMessage]
if {$err} {
+ set hostid Default
tkerror $errorMessage
show-status "Not connected" 0 {}
+ show-target {} {}
return
}
set hostid $target
configure-enable-e .top.target.m 2
}
+# Procedure close-target
+# Shuts down the connection with current target.
proc close-target {} {
global hostid
global cancelFlag
configure-disable-e .top.target.m 1
configure-disable-e .top.target.m 2
if {[tk4]} {
- .top.rset.m delete 2 last
+ .top.rset.m delete 1 last
} else {
.top.rset.m delete 1 last
}
configure-enable-e .top.target.m 0
}
+# Procedure load-set-action
+# Loads records from a file. The filename is read from the entry
+# .load-set.filename.entry (see function load-set)
proc load-set-action {} {
global setNoLast
show-status Ready 0 {}
}
+# Procedure load-set
+# Dialog that asks for a filename with records to be loaded
+# into a result set.
proc load-set {} {
set w .load-set
toplevel $w
focus $oldFocus
}
-proc init-request {} {
+# Procedure init-request
+# Sends an initialize request to the target. This procedure is called
+# when a connect has been established.
+proc init-request {target base} {
global cancelFlag
if {$cancelFlag} {
close-target
return
}
- z39 callback {init-response}
+ z39 callback [list init-response $target $base]
show-status Initializing 1 {}
set err [catch {z39 init} errorMessage]
if {$err} {
}
}
-proc init-response {} {
- global cancelFlag
- global scanEnable
+# Procedure init-response
+# Handles and incoming init-response. The service buttons
+# are enabled. The global $scanEnable indicates whether the target
+# supports scan.
+proc init-response {target base} {
+ global cancelFlag profile scanEnable settingsChanged
+ dputs {init-response}
+ apduDump
if {$cancelFlag} {
close-target
return
}
if {![z39 initResult]} {
- show-status Ready 0 1
set u [z39 userInformationField]
close-target
tkerror "Connection rejected by target: $u"
} else {
- if {[lsearch [z39 options] scan] >= 0} {
- set scanEnable 1
- } else {
- set scanEnable 0
- }
- show-status Ready 0 1
+ z39 failback [list explain-crash $target $base]
+ explain-check $target [list ready-response $base]
}
}
+# Procedure explain-crash
+# Handles target that dies during explain.
+proc explain-crash {target base} {
+ global profile settingsChanged
+
+ set profile($target,timeLastInit) [clock seconds]
+ set settingsChanged 1
+
+ show-message {}
+ open-target $target $base
+}
+
+# Procedure explain-check
+# Stub function to check explain. May be overwritten later.
+proc explain-check {target response} {
+ eval $response [list $target]
+}
+
+# Procedure ready-response
+# Called after a target has been initialized and, possibly, explained
+proc ready-response {base target} {
+ global profile settingsChanged scanEnable
+
+ z39 failback [list fail-response $target]
+ if {[string length $base]} {
+ set profile($target,timeLastInit) [clock seconds]
+ set settingsChanged 1
+
+ z39 databaseNames $base
+ cascade-dblist $target $base
+ show-target $target $base
+ }
+ if {[lsearch [z39 options] scan] >= 0} {
+ set scanEnable 1
+ } else {
+ set scanEnable 0
+ }
+ .data.record delete 1.0 end
+ set desc [string trim $profile($target,description)]
+ if {[string length $desc]} {
+ .data.record insert end "$desc\n\n"
+ } else {
+ .data.record insert end "$target\n\n"
+ }
+ set data [string trim $profile($target,welcomeMessage)]
+ if {[string length $data]} {
+ .data.record insert end "Welcome Message:\n$data\n\n"
+ }
+ set data [string trim $profile($target,recentNews)]
+ if {[string length $data]} {
+ .data.record insert end "News:\n$data\n"
+ }
+ show-message {}
+ show-status Ready 0 1
+}
+
+# Procedure search-request
+# bflag flag to indicate if this procedure calls itself
+# Performs a search. If $busy is 1, the search-request is performed
+# at a later time (when another response arrives). This procedure
+# sets many search-related Z39-settings. The global $setNo is set
+# to the result set number (z39.$setNo).
proc search-request {bflag} {
global setNo
global setNoLast
global cancelFlag
global delayRequest
global recordSyntax
+ global elementSetNames
set target $hostid
-
+
+ if {![string length [z39 connect]]} {
+ return
+ }
dputs "search-request"
show-message {}
if {!$bflag && $busy} {
set delayRequest {}
set query [index-query]
- if {$query==""} {
+ if {![string length $query]} {
return
}
incr setNoLast
set setNo $setNoLast
ir-set z39.$setNo z39
-
- if {[lindex $profile($target) 10] == 1} {
+
+ if {$profile($target,namedResultSets)} {
z39.$setNo setName $setNo
dputs "setName=${setNo}"
} else {
- z39.$setNo setName Default
- dputs "setName=Default"
+ z39.$setNo setName default
+ dputs "setName=default"
}
- if {[lindex $profile($target) 8] == 1} {
- z39.$setNo queryType rpn
- }
- if {[lindex $profile($target) 9] == 1} {
- z39.$setNo queryType ccl
+ if {$profile($target,queryRPN)} {
+ z39.$setNo queryType rpn
+ } elseif {$profile($target,queryCCL)} {
+ z39.$setNo queryType ccl
}
dputs Setting
dputs $recordSyntax
- if {$recordSyntax == "None" } {
+ if {![string compare $recordSyntax None]} {
z39.$setNo preferredRecordSyntax {}
} else {
z39.$setNo preferredRecordSyntax $recordSyntax
}
+ if {![string compare $elementSetNames None]} {
+ z39.$setNo elementSetNames {}
+ z39.$setNo smallSetElementSetNames {}
+ z39.$setNo mediumSetElementSetNames {}
+ } else {
+ z39.$setNo elementSetNames $elementSetNames
+ z39.$setNo smallSetElementSetNames $elementSetNames
+ z39.$setNo mediumSetElementSetNames $elementSetNames
+ }
z39 callback {search-response}
z39.$setNo search $query
show-status Searching 1 0
}
+# Procedure scan-copy {y entry}
+# y y-position of mouse pointer
+# entry a search entry in the top
+# Copies the term in the list nearest $y to the query entry specified
+# by $entry
proc scan-copy {y entry} {
set w .scan-window
set no [$w.top.list nearest $y]
.lines.$entry.e insert 0 [string range [$w.top.list get $no] 8 end]
}
+# Procedure scan-request
+# Performs a scan on term "0" with the current attributes in entry
+# specified by the global $curIndexEntry.
proc scan-request {} {
set w .scan-window
show-status Scanning 1 0
}
+# Procedure scan-term-h {attr}
+# attr attribute specification
+# This procedure is called whenever a key is released in the entry in the
+# scan window (.scan-window). A scan is then initiated with the new contents
+# of the entry as the starting term.
proc scan-term-h {attr} {
global busy
global scanTerm
z39.scan numberOfTermsRequested 5
z39.scan preferredPositionInResponse 1
dputs "${attr} \{${scanTerm}\}"
- if {$scanTerm == ""} {
+ if {![string length $scanTerm]} {
z39.scan scan "${attr} 0"
} else {
z39.scan scan "${attr} \{${scanTerm}\}"
show-status Scanning 1 0
}
+# Procedure scan-response {attr start toget}
+# attr attribute specification
+# start position of first term in the response
+# toget number of total terms to get
+# This procedure handles all scan-responses. $start specifies the list
+# entry number of the first incoming term. The $toget indicates the total
+# number of terms to be retrieved from the target. The $toget may be
+# negative in which case, scan is performed 'backwards' (- $toget is
+# the total number of terms in this case). This procedure usually calls
+# itself several times in order to get small scan-term-list chunks.
proc scan-response {attr start toget} {
global cancelFlag
global delayRequest
set w .scan-window
dputs "In scan-response"
+ apduDump
set m [z39.scan numberOfEntriesReturned]
dputs $m
dputs attr=$attr
z39.scan preferredPositionInResponse 1
set scanTerm $nScanTerm
dputs "${attr} \{${scanTerm}\}"
- if {$scanTerm == ""} {
+ if {![string length $scanTerm]} {
z39.scan scan "${attr} 0"
} else {
z39.scan scan "${attr} \{${scanTerm}\}"
show-status Ready 0 1
}
+# Procedure scan-down {attr}
+# attr attribute specification
+# This procedure is called when the user hits the Down button the scan
+# window. A new scan is initiated with a positive $toget passed to the
+# scan-response handler.
proc scan-down {attr} {
global scanView
global cancelFlag
$w.top.list yview $scanView
}
+# Procedure scan-up {attr}
+# attr attribute specification
+# This procedure is called when the user hits the Up button the scan
+# window. A new scan is initiated with a negative $toget passed to the
+# scan-response handler.
proc scan-up {attr} {
global scanView
global cancelFlag
$w.top.list yview $scanView
}
+# Procedure search-response
+# This procedure handles search-responses. If the search is successful
+# this procedure will try to retrieve a total of 20 records from the target;
+# however not more than $presentChunk records at a time. This procedure
+# affects the following globals:
+# $setOffset current record position offset
+# $setMax total number of records to be retrieved
proc search-response {} {
global setNo
global setOffset
global cancelFlag
global busy
global delayRequest
+ global presentChunk
+ apduDump
dputs "In search-response"
if {$cancelFlag} {
dputs "Handling cancel"
set setMax [z39.$setNo resultCount]
show-status Ready 0 1
set status [z39.$setNo responseStatus]
- if {[lindex $status 0] == "NSD"} {
+ if {![string compare [lindex $status 0] NSD]} {
z39.$setNo nextResultSetPosition 0
set code [lindex $status 1]
set msg [lindex $status 2]
show-status Ready 0 1
set l [format "%-4d %7d" $setNo $setMax]
.top.rset.m add command -label $l \
- -command [list add-title-lines $setNo 10000 1]
+ -command [list recall-set $setNo]
if {$setMax > 20} {
set setMax 20
}
- z39 callback {present-response}
- z39.$setNo present $setOffset 1
- show-status Retrieving 1 0
+ set no [z39.$setNo numberOfRecordsReturned]
+ dputs "Returned $no records, setOffset $setOffset"
+ add-title-lines $setNo $no $setOffset
+ set setOffset [expr $setOffset + $no]
+
+ set toGet [expr $setMax - $setOffset + 1]
+ if {$toGet > 0} {
+ if {$setOffset == 1} {
+ set toGet 1
+ } elseif {$toGet > $presentChunk} {
+ set toGet $presentChunk
+ }
+ z39 callback {present-response}
+ z39.$setNo present $setOffset $toGet
+ show-status Retrieving 1 0
+ }
}
+# Procedure present-more {number}
+# number number of records to be retrieved
+# This procedure starts a present-request. The $number variable indicates
+# the total number of records to be retrieved. The global $presentChunk
+# specifies the number of records to be retrieved at a time. If $number
+# is the empty string all remaining records in the result set are
+# retrieved.
proc present-more {number} {
global setNo
global setOffset
global busy
global cancelFlag
global delayRequest
+ global presentChunk
dputs "present-more"
if {$cancelFlag} {
show-status Ready 0 1
return
}
- if {$number == ""} {
+ if {![string length $number]} {
set setMax $max
} else {
incr setMax $number
}
}
z39 callback {present-response}
-
+
set toGet [expr $setMax - $setOffset + 1]
if {$toGet <= 0} {
return
}
- if {$toGet > 3} {
- set toGet 3
+ if {$toGet > $presentChunk} {
+ set toGet $presentChunk
}
z39.$setNo present $setOffset $toGet
show-status Retrieving 1 0
}
+# Procedure init-title-lines
+# Utility that cleans the main record window.
proc init-title-lines {} {
- .data.record delete 0.0 end
+ .data.record delete 1.0 end
}
-proc title-press {y setno} {
- show-full-marc $setno [expr 1 + [.data.list nearest $y]] 0
+# Procedure recall-set {setno}
+# setno Set number to recall
+proc recall-set {setno} {
+ add-title-lines $setno 10000 1
}
+# Procedure add-title-lines {setno no offset}
+# setno Set number
+# no Number of records
+# offset Starting offset
+# This procedure displays the records $offset .. $offset+$no-1 in result
+# set $setno in the main record window by using the display format in the
+# global $displayFormat
proc add-title-lines {setno no offset} {
global displayFormats
global displayFormat
global setNo
global busy
+ dputs "add-title-lines offset=${offset} no=${no}"
if {$setno != -1} {
set setNo $setno
} else {
}
if {$offset == 1} {
.bot.a.set configure -text $setno
- .data.record delete 0.0 end
+ .data.record delete 1.0 end
}
set ffunc [lindex $displayFormats $displayFormat]
dputs "ffunc=$ffunc"
for {set i 0} {$i < $no} {incr i} {
set o [expr $i + $offset]
set type [z39.$setno type $o]
- if {$type == ""} {
+ if {![string length $type]} {
+ dputs "no more at $o"
break
}
.data.record tag bind r$o <Any-Enter> {}
}
}
+# Procedure present-response
+# Present-response handler. The incoming records are displayed and a new
+# present request is performed until all records ($setMax) is returned
+# from the target.
proc present-response {} {
global setNo
global setOffset
global setMax
global cancelFlag
global delayRequest
+ global presentChunk
dputs "In present-response"
+ apduDump
set no [z39.$setNo numberOfRecordsReturned]
dputs "Returned $no records, setOffset $setOffset"
add-title-lines $setNo $no $setOffset
return
}
set status [z39.$setNo responseStatus]
- if {[lindex $status 0] == "NSD"} {
+ if {![string compare [lindex $status 0] NSD]} {
show-status Ready 0 1
set code [lindex $status 1]
set msg [lindex $status 2]
if {$no > 0 && $setOffset <= $setMax} {
dputs "present-request from ${setOffset}"
set toGet [expr $setMax - $setOffset + 1]
- if {$toGet > 3} {
- set toGet 3
+ if {$toGet > $presentChunk} {
+ set toGet $presentChunk
}
z39.$setNo present $setOffset $toGet
} else {
}
}
+# Procedure left-cursor {w}
+# w entry widget
+# Tries to move the cursor left in entry window $w
proc left-cursor {w} {
set i [$w index insert]
if {$i > 0} {
dputs left
}
+# Procedure right-cursor {w}
+# w entry widget
+# Tries to move the cursor right in entry window $w
proc right-cursor {w} {
set i [$w index insert]
incr i
$w icursor $i
}
+# Procedure bind-fields {list returnAction escapeAction}
+# list list of entry widgets
+# returnAction return script
+# escapeAction escape script
+# Each widget in list are assigned bindings for <Tab>, <Left>, <Right>,
+# <Return> and <Escape>.
proc bind-fields {list returnAction escapeAction} {
set max [expr [llength $list]-1]
for {set i 0} {$i < $max} {incr i} {
focus [lindex $list 0]
}
+# Procedure entry-fields {parent list tlist returnAction escapeAction}
+# list list of frame widgets
+# tlist list of text to be used as lead of each entry
+# returnAction return script
+# escapeAction escape script
+# Makes label and entry widgets in each widget in $list.
proc entry-fields {parent list tlist returnAction escapeAction} {
set alist {}
set i 0
bind-fields $alist $returnAction $escapeAction
}
+# Procedure define-target-dialog
+# Dialog that asks for new target to be defined.
proc define-target-dialog {} {
set w .target-define
top-down-ok-cancel $w {define-target-action} 1
}
-proc protocol-setup-delete {target} {
- global profile
- global settingsChanged
+# Procedure protocol-setup-delete
+# This procedure is invoked when the user tries to delete a target
+# definition. If user is sure, the target definition is deleted.
+proc protocol-setup-delete {target w} {
+ global profile settingsChanged
set a [alert "Are you sure you want to delete the target \
definition $target ?"]
if {$a} {
- set wno [lindex $profile($target) 12]
- set w .setup-${wno}
destroy $w
- unset profile($target)
+ foreach n [array names profile $target,*] {
+ unset profile($n)
+ }
set settingsChanged 1
cascade-target-list
delete-target-hotlist $target
}
}
-proc protocol-setup-action {target} {
- global profile
- global csRadioType
- global protocolRadioType
- global settingsChanged
- global RPNCheck
- global CCLCheck
- global ResultSetCheck
+# Procedure protocol-setup-action {target w}
+# target target to be defined
+# w target definition toplevel widget
+# This procedure reads all appropriate globals and makes a new/modified
+# profile for the target. The global array $profileS contains most of the
+# information the user may modify.
+proc protocol-setup-action {target w} {
+ global profile settingsChanged profileS
- set wno [lindex $profile($target) 12]
- set w .setup-${wno}
-
- set b {}
+ set dataBases {}
set settingsChanged 1
+
+ set timedef $profile($target,timeDefine)
+ if {![string length $timedef]} {
+ set timedef [clock seconds]
+ }
+ set profileS($target,timeDefine) $timedef
+
+ foreach n [array names profile $target,*] {
+ set profile($n) $profileS($n)
+ unset profileS($n)
+ }
+
set len [$w.top.databases.list size]
+ catch {unset profile($target,databases)}
for {set i 0} {$i < $len} {incr i} {
- lappend b [$w.top.databases.list get $i]
- }
- set profile($target) [list [$w.top.description.entry get] \
- [$w.top.host.entry get] \
- [$w.top.port.entry get] \
- [$w.top.idAuthentication.entry get] \
- [$w.top.maximumRecordSize.entry get] \
- [$w.top.preferredMessageSize.entry get] \
- $csRadioType \
- $b \
- $RPNCheck \
- $CCLCheck \
- $ResultSetCheck \
- $protocolRadioType \
- $wno]
+ lappend profile($target,databases) [$w.top.databases.list get $i]
+ }
cascade-target-list
delete-target-hotlist $target
- dputs $profile($target)
destroy $w
}
+# Procedure place-force {window parent}
+# window new top level widget
+# parent parent widget used as base
+# Sets geometry of $window relative to $parent window.
proc place-force {window parent} {
set g [wm geometry $parent]
wm geometry $window +${x}+${y}
}
-proc add-database-action {target} {
+# Procedure add-database-action {target w}
+# target target to be defined
+# w top level widget for the target definition
+# Adds the contents of .database-select.top.database.entry to list of
+# databases.
+proc add-database-action {target w} {
global profile
- set wno [lindex $profile($target) 12]
- set w .setup-${wno}
-
$w.top.databases.list insert end \
[.database-select.top.database.entry get]
destroy .database-select
}
-proc add-database {target} {
+# Procedure add-database {target wp}
+# target target to be defined
+# wp top level widget for the target definition
+# Makes a dialog in which the user enters new database
+proc add-database {target wp} {
global profile
set w .database-select
toplevel $w
set oldFocus [focus]
- set wno [lindex $profile($target) 12]
- place-force $w .setup-${wno}
+ place-force $w $wp
top-down-window $w
entry-fields $w.top {database} \
{{Database to add:}} \
- [list add-database-action $target] {destroy .database-select}
+ [list add-database-action $target $wp] {destroy .database-select}
- top-down-ok-cancel $w [list add-database-action $target] 1
+ top-down-ok-cancel $w [list add-database-action $target $wp] 1
focus $oldFocus
}
-proc delete-database {target} {
+
+# Procedure delete-database {target w}
+# target target to be defined
+# w top level widget for the target definition
+# Asks the user if he/she really wishes to delete a database and removes
+# the database from the database-list if requested.
+proc delete-database {target w} {
global profile
- set wno [lindex $profile($target) 12]
- set w .setup-${wno}
set l {}
foreach i [$w.top.databases.list curselection] {
set b [$w.top.databases.list get $i]
}
}
+# Procedure protocol-setup {target}
+# target target to be defined
+# Makes a dialog in which the user may modify/view a target definition
+# (profile). The $profileS - array holds the initial definition of the
+# target.
proc protocol-setup {target} {
- global profile
- global csRadioType
- global protocolRadioType
- global RPNCheck
- global CCLCheck
- global ResultSetCheck
-
- set wno [lindex $profile($target) 12]
- set w .setup-${wno}
+ global profile profileS
+
+ set bno 0
+ while {[winfo exists .setup-$bno]} {
+ incr bno
+ }
+ set w .setup-$bno
toplevelG $w
top-down-window $w
- if {$target == ""} {
+ if {![string length $target]} {
set target Default
}
- dputs target
- dputs $profile($target)
+ foreach n [array names profile $target,*] {
+ set profileS($n) $profile($n)
+ }
frame $w.top.description
frame $w.top.host
frame $w.top.port
frame $w.top.idAuthentication
- frame $w.top.maximumRecordSize
- frame $w.top.preferredMessageSize
+
frame $w.top.cs-type -relief ridge -border 2
frame $w.top.protocol -relief ridge -border 2
frame $w.top.query -relief ridge -border 2
# Maximum/preferred/idAuth ...
pack $w.top.description $w.top.host $w.top.port \
- $w.top.idAuthentication $w.top.maximumRecordSize \
- $w.top.preferredMessageSize -side top -anchor e -pady 2
+ $w.top.idAuthentication -side top -anchor e -pady 2
- entry-fields $w.top {description host port idAuthentication \
- maximumRecordSize preferredMessageSize} \
- {{Description:} {Host:} {Port:} {Id Authentication:} \
- {Maximum Record Size:} {Preferred Message Size:}} \
- [list protocol-setup-action $target] [list destroy $w]
+ entry-fields $w.top {description host port idAuthentication } \
+ {{Description:} {Host:} {Port:} {Id Authentication:}} \
+ [list protocol-setup-action $target $w] [list destroy $w]
- foreach sub {description host port idAuthentication \
- maximumRecordSize preferredMessageSize} {
+ foreach sub {description host port idAuthentication} {
dputs $sub
- bind $w.top.$sub.entry <Control-a> [list add-database $target]
- bind $w.top.$sub.entry <Control-d> [list delete-database $target]
- }
- $w.top.description.entry insert 0 [lindex $profile($target) 0]
- $w.top.host.entry insert 0 [lindex $profile($target) 1]
- $w.top.port.entry insert 0 [lindex $profile($target) 2]
- $w.top.idAuthentication.entry insert 0 [lindex $profile($target) 3]
- $w.top.maximumRecordSize.entry insert 0 [lindex $profile($target) 4]
- $w.top.preferredMessageSize.entry insert 0 [lindex $profile($target) 5]
- set csRadioType [lindex $profile($target) 6]
- set RPNCheck [lindex $profile($target) 8]
- set CCLCheck [lindex $profile($target) 9]
- set ResultSetCheck [lindex $profile($target) 10]
- set protocolRadioType [lindex $profile($target) 11]
- if {$protocolRadioType == ""} {
- set protocolRadioType Z39
- }
+ bind $w.top.$sub.entry <Control-a> [list add-database $target $w]
+ bind $w.top.$sub.entry <Control-d> [list delete-database $target $w]
+ }
+ $w.top.description.entry configure -textvariable \
+ profileS($target,description)
+ $w.top.host.entry configure -textvariable \
+ profileS($target,host)
+ $w.top.port.entry configure -textvariable \
+ profileS($target,port)
+ $w.top.idAuthentication.entry configure -textvariable \
+ profileS($target,authentication)
# Databases ....
pack $w.top.databases -side left -pady 2 -padx 2 -expand yes -fill both
label $w.top.databases.label -text "Databases"
- button $w.top.databases.add -text "Add" \
- -command [list add-database $target]
- button $w.top.databases.delete -text "Delete" \
- -command [list delete-database $target]
+ button $w.top.databases.add -text Add \
+ -command [list add-database $target $w]
+ button $w.top.databases.delete -text Delete \
+ -command [list delete-database $target $w]
if {! [tk4]} {
listbox $w.top.databases.list -geometry 14x6 \
-yscrollcommand "$w.top.databases.scroll set"
-padx 2 -pady 2
$w.top.databases.scroll config -command "$w.top.databases.list yview"
- foreach b [lindex $profile($target) 7] {
- $w.top.databases.list insert end $b
+ if {[info exists profile($target,databases)]} {
+ foreach b $profile($target,databases) {
+ $w.top.databases.list insert end $b
+ }
}
-
# Transport ...
pack $w.top.cs-type -pady 2 -padx 2 -side top -fill x
label $w.top.cs-type.label -text "Transport"
radiobutton $w.top.cs-type.tcpip -text "TCP/IP" -anchor w \
- -variable csRadioType -value tcpip
+ -variable profileS($target,comstack) -value tcpip
radiobutton $w.top.cs-type.mosi -text "MOSI" -anchor w\
- -variable csRadioType -value mosi
+ -variable profileS($target,comstack) -value mosi
pack $w.top.cs-type.label $w.top.cs-type.tcpip $w.top.cs-type.mosi \
-padx 2 -side top -fill x
label $w.top.protocol.label -text "Protocol"
radiobutton $w.top.protocol.z39v2 -text "Z39.50" -anchor w \
- -variable protocolRadioType -value Z39
+ -variable profileS($target,protocol) -value Z39
radiobutton $w.top.protocol.sr -text "SR" -anchor w \
- -variable protocolRadioType -value SR
+ -variable profileS($target,protocol) -value SR
pack $w.top.protocol.label $w.top.protocol.z39v2 $w.top.protocol.sr \
-padx 2 -side top -fill x
pack $w.top.query -pady 2 -padx 2 -side top -fill x
label $w.top.query.label -text "Query support"
- checkbutton $w.top.query.c1 -text "RPN query" -anchor w -variable RPNCheck
- checkbutton $w.top.query.c2 -text "CCL query" -anchor w -variable CCLCheck
- checkbutton $w.top.query.c3 -text "Result sets" -anchor w -variable ResultSetCheck
+ checkbutton $w.top.query.c1 -text "RPN query" -anchor w \
+ -variable profileS($target,queryRPN)
+ checkbutton $w.top.query.c2 -text "CCL query" -anchor w \
+ -variable profileS($target,queryCCL)
+ checkbutton $w.top.query.c3 -text "Result sets" -anchor w \
+ -variable profileS($target,namedResultSets)
pack $w.top.query.label -side top
pack $w.top.query.c1 $w.top.query.c2 $w.top.query.c3 \
-padx 2 -side top -fill x
# Ok-cancel
- bottom-buttons $w [list {Ok} [list protocol-setup-action $target] \
- {Delete} [list protocol-setup-delete $target] \
+ bottom-buttons $w [list {Ok} [list protocol-setup-action $target $w] \
+ {Delete} [list protocol-setup-delete $target $w] \
+ {Advanced} [list advanced-setup $target $bno] \
{Cancel} [list destroy $w]] 0
}
+# Procedure advanced-setup {target b}
+# target target to be defined
+# b window number of target top level
+# Makes a dialog in which the user may modify/view advanced settings
+# of a target definition (profile).
+proc advanced-setup {target b} {
+ global profile
+ global profileS
+
+ set w .advanced-setup-$b
+
+ toplevelG $w
+
+ wm title $w "Advanced setup $target"
+
+ top-down-window $w
+
+ if {![string length $target]} {
+ set target Default
+ }
+ dputs target
+
+ frame $w.top.largeSetLowerBound
+ frame $w.top.smallSetUpperBound
+ frame $w.top.mediumSetPresentNumber
+ frame $w.top.presentChunk
+ frame $w.top.maximumRecordSize
+ frame $w.top.preferredMessageSize
+
+ pack $w.top.largeSetLowerBound $w.top.smallSetUpperBound \
+ $w.top.mediumSetPresentNumber $w.top.presentChunk \
+ $w.top.maximumRecordSize $w.top.preferredMessageSize \
+ -side top -anchor e -pady 2
+
+ entry-fields $w.top {largeSetLowerBound smallSetUpperBound \
+ mediumSetPresentNumber presentChunk maximumRecordSize \
+ preferredMessageSize} \
+ {{Large Set Lower Bound:} {Small Set Upper Bound:} \
+ {Medium Set Present Number:} {Present Chunk:} \
+ {Maximum Record Size:} {Preferred Message Size:}} \
+ [list advanced-setup-action $target $b] [list destroy $w]
+
+ $w.top.largeSetLowerBound.entry configure -textvariable \
+ profileS($target,largeSetLowerBound)
+ $w.top.smallSetUpperBound.entry configure -textvariable \
+ profileS($target,smallSetUpperBound)
+ $w.top.mediumSetPresentNumber.entry configure -textvariable \
+ profileS($target,mediumSetPresentNumber)
+ $w.top.presentChunk.entry configure -textvariable \
+ profileS($target,presentChunk)
+ $w.top.maximumRecordSize.entry configure -textvariable \
+ profileS($target,maximumRecordSize)
+ $w.top.preferredMessageSize.entry configure -textvariable \
+ profileS($target,preferredMessageSize)
+
+ bottom-buttons $w [list {Ok} [list advanced-setup-action $target $b] \
+ {Cancel} [list destroy $w]] 0
+}
+
+# Procedure advanced-setup-action {target b}
+# target target to be defined
+# b window number of target top level
+# This procedure is called when the user hits Ok in the advanced target
+# setup dialog. The temporary result is stored in the $profileS - array.
+proc advanced-setup-action {target b} {
+ set w .advanced-setup-$b
+ global profileS
+
+ set profileS($target,LSLB) [$w.top.largeSetLowerBound.entry get]
+ set profileS($target,SSUB) [$w.top.smallSetUpperBound.entry get]
+ set profileS($target,MSPN) [$w.top.mediumSetPresentNumber.entry get]
+ set profileS($target,presentChunk) [$w.top.presentChunk.entry get]
+ set profileS($target,MRS) [$w.top.maximumRecordSize.entry get]
+ set profileS($target,PMS) [$w.top.preferredMessageSize.entry get]
+
+ dputs "advanced-setup-action"
+ destroy $w
+}
+
+# Procedure database-select-action
+# Called when the user commits a database select change. See procedure
+# database-select.
proc database-select-action {} {
set w .database-select.top
set b {}
destroy .database-select
}
+# Procedure database-select
+# Makes a dialog in which the user may select a database
proc database-select {} {
set w .database-select
global profile
-padx 2 -pady 2
$w.top.databases.scroll config -command "$w.top.databases.list yview"
- foreach b [lindex $profile($hostid) 7] {
+ foreach b $profile($hostid,databases) {
$w.top.databases.list insert end $b
}
top-down-ok-cancel $w {database-select-action} 1
focus $oldFocus
}
+# Procedure cascase-dblist-select
+proc cascade-dblist-select {target db} {
+ show-target $target $db
+ z39 databaseNames $db
+}
+
+# Procedure cascade-dblist
+# Makes the Service/database list with proper databases for the target
+proc cascade-dblist {target base} {
+ global profile
+
+ set w .top.service.m.dblist
+ $w delete 0 200
+ if {[info exists profile($target,databases)]} {
+ foreach db $profile($target,databases) {
+ $w add command -label $db \
+ -command [list cascade-dblist-select $target $db]
+ }
+ }
+}
+
+# Procedure cascade-target-list
+# Makes all target/databases available in the Target|Connect
+# menu as well as all targets in the Target|Setup menu.
+# This procedure is called whenever target definitions occur.
proc cascade-target-list {} {
global profile
destroy $sub
}
.top.target.m.clist delete 0 last
- foreach n [lsort [array names profile]] {
- if {$n != "Default"} {
- set nl [lindex $profile($n) 12]
- if {[llength [lindex $profile($n) 7]] > 1} {
- .top.target.m.clist add cascade -label $n \
- -menu .top.target.m.clist.$nl
- menu .top.target.m.clist.$nl
- foreach b [lindex $profile($n) 7] {
- .top.target.m.clist.$nl add command -label $b \
- -command [list reopen-target $n $b]
- }
- } else {
- .top.target.m.clist add command -label $n \
- -command [list reopen-target $n {}]
- }
- }
+ foreach nn [lsort [array names profile *,host]] {
+ if {[string length $profile($nn)]} {
+ set ll [expr [string length $nn] - 6]
+ set n [string range $nn 0 $ll]
+
+ set nl $profile($n,windowNumber)
+ if {[info exists profile($n,databases)]} {
+ set ndb [llength $profile($n,databases)]
+ } else {
+ set ndb 0
+ }
+ if {$ndb > 1} {
+ .top.target.m.clist add cascade -label $n \
+ -menu .top.target.m.clist.$nl
+ irmenu .top.target.m.clist.$nl
+ foreach b $profile($n,databases) {
+ .top.target.m.clist.$nl add command -label $b \
+ -command [list reopen-target $n $b]
+ }
+ } elseif {$ndb == 1} {
+ .top.target.m.clist add command -label $n -command \
+ [list reopen-target $n [lindex $profile($n,databases) 0]]
+ } else {
+ .top.target.m.clist add command -label $n -command \
+ [list reopen-target $n {}]
+ }
+ }
}
.top.target.m.slist delete 0 last
- foreach n [lsort [array names profile]] {
- if {$n != "Default"} {
- .top.target.m.slist add command -label $n \
- -command [list protocol-setup $n]
- }
+ foreach nn [lsort [array names profile *,host]] {
+ set ll [expr [string length $nn] - 6]
+ set n [string range $nn 0 $ll]
+
+ .top.target.m.slist add command -label $n \
+ -command [list protocol-setup $n]
}
}
+# Procedure query-select {i}
+# i Query type number (integer)
+# This procedure is called when the user selects a Query type. The current
+# query type information given by the globals $queryButtonsFind and
+# $queryInfoFind are affected by this operation.
proc query-select {i} {
global queryButtonsFind
global queryInfoFind
index-lines .lines 1 $queryButtonsFind $queryInfoFind activate-index
}
+# Procedure query-new-action
+# Commits a new query type definition by extending the globals
+# $queryTypes, $queryButtons and $queryInfo.
proc query-new-action {} {
global queryTypes
global queryButtons
cascade-query-list
}
+# Procedure query-new
+# Makes a dialog in which the user is requested to enter the name of a
+# new query type.
proc query-new {} {
set w .query-new
focus $oldFocus
}
+# Procedure query-delete-action {queryNo}
+# queryNo query type number (integer)
+# Procedure that deletes the query type specified by $queryNo.
proc query-delete-action {queryNo} {
global queryTypes
global queryButtons
cascade-query-list
}
+# Procedure query-delete {queryNo}
+# queryNo query type number (integer)
+# Asks if the user really want to delete a given query type; calls
+# query-delete-action if 'yes'.
proc query-delete {queryNo} {
global queryTypes
{Cancel} [list destroy $w]] 1
}
+# Procedure cascade-query-list
+# Updates the enties below Options|Query to list all query types.
proc cascade-query-list {} {
global queryTypes
set w .top.options.m.query
}
}
+# Procedure save-geometry
+# This procedure saves the per-user related settings in ~/.clientrc.tcl.
+# The geometry information stored in the global array $windowGeometry is
+# saved. Also a few other user settings, such as current display format, are
+# saved.
proc save-geometry {} {
global windowGeometry
global hotTargets
global displayFormat
global popupMarcdf
global recordSyntax
-
+ global elementSetNames
+ global hostid
+
set windowGeometry(.) [wm geometry .]
if {[catch {set f [open ~/.clientrc.tcl w]}]} {
return
}
- puts $f "set hotTargets \{ $hotTargets \}"
+ if {$hostid != "Default"} {
+ puts $f "set hostid [list $hostid]"
+ set b [z39 databaseNames]
+ puts $f "set hostbase [list $b]"
+ }
+ puts $f "set hotTargets [list $hotTargets]"
puts $f "set textWrap $textWrap"
puts $f "set displayFormat $displayFormat"
puts $f "set popupMarcdf $popupMarcdf"
puts $f "set recordSyntax $recordSyntax"
+ puts $f "set elementSetNames $elementSetNames"
foreach n [array names windowGeometry] {
- puts -nonewline $f "set \{windowGeometry($n)\} \{"
- puts -nonewline $f $windowGeometry($n)
- puts $f "\}"
+ puts -nonewline $f "set [list windowGeometry($n)] "
+ puts $f [list $windowGeometry($n)]
}
close $f
}
+# Procedure save-settings
+# This procedure saves the per-host related settings irtdb.tcl which
+# is normally kept in the directory /usr/local/lib/irtcl.
+# All query types and target defintion profiles are saved.
proc save-settings {} {
global profile
global libdir
global queryTypes
global queryButtons
global queryInfo
-
- if {![file writable "${libdir}/clientrc.tcl"]} {
- set a [alert "Cannot open ${libdir}/clientrc.tcl for writing. Do you \
- wish to save clientrc.tcl in the current directory instead?"]
- if {! $a} {
- return
- }
- set f [open "clientrc.tcl" w]
+
+ if {[file writable "${libdir}/irtdb.tcl"]} {
+ set f [open "${libdir}/irtdb.tcl" w]
} else {
- set f [open "${libdir}/clientrc.tcl" w]
+ set f [open "irtdb.tcl" w]
}
puts $f "# Setup file"
- foreach n [array names profile] {
- puts -nonewline $f "set \{profile($n)\} \{"
- puts -nonewline $f $profile($n)
- puts $f "\}"
+ foreach n [lsort [array names profile]] {
+ puts $f "set [list profile($n)] [list $profile($n)]"
}
- puts -nonewline $f "set queryTypes \{"
- puts -nonewline $f $queryTypes
- puts $f "\}"
+ puts $f "set queryTypes [list $queryTypes]"
- puts -nonewline $f "set queryButtons \{"
- puts -nonewline $f $queryButtons
- puts $f "\}"
+ puts $f "set queryButtons [list $queryButtons]"
- puts -nonewline $f "set queryInfo \{"
- puts -nonewline $f $queryInfo
- puts $f "\}"
+ puts $f "set queryInfo [list $queryInfo]"
close $f
set settingsChanged 0
}
+# Procedure alert {ask}
+# ask prompt string
+# Makes a grabbed dialog in which the user is requested to answer
+# "Ok" or "Cancel". This procedure returns 1 if the user hits "Ok"; 0
+# otherwise.
proc alert {ask} {
set w .alert
- global alertAnswer
+ global alertAnswer font
toplevel $w
set oldFocus [focus]
top-down-window $w
label $w.top.warning -bitmap warning
- message $w.top.message -text $ask -aspect 300 \
- -font -Adobe-Times-Medium-R-Normal-*-180-*
+ message $w.top.message -text $ask -aspect 300 -font $font(b,normal)
pack $w.top.warning $w.top.message -side left -pady 5 -padx 10 -expand yes
return $alertAnswer
}
+# Procedure alert-action
+# Called when the user hits "Ok" in the .alert-window.
proc alert-action {} {
global alertAnswer
set alertAnswer 1
destroy .alert
}
+# Procedure exit-action
+# This procedure is called if the user exists the application
proc exit-action {} {
global settingsChanged
if {$settingsChanged} {
- set a [alert "you haven't saved your settings. Do you wish to save?"]
- if {$a} {
- save-settings
- }
+ save-settings
}
save-geometry
exit 0
}
+# Procedure listbuttonaction {w name h user i}
+# w menubutton widget
+# name name information
+# h handler to be invoked
+# user user information to be passed to handler $h
+# i index passed as second argument to handler $h
+# Utility function to emulate a listbutton. Called when the user
+# Modifies the listbutton. See procedure listbuttonx.
proc listbuttonaction {w name h user i} {
$w configure -text [lindex $name 0]
$h [lindex $name 1] $user $i
}
-
+
+# Procedure listbuttonx {button no names handle user}
+# button menubutton widget
+# no initial value index (integer)
+# names list of name entries. The first entry in each name
+# entry is the actual name
+# handle user function to be called when the listbutton changes
+# its value
+# user user argument to the $handle function
+# Makes an extended listbutton.
proc listbuttonx {button no names handle user} {
if {[winfo exists $button]} {
$button configure -text [lindex [lindex $names $no] 0]
} else {
menubutton $button -text [lindex [lindex $names $no] 0] \
-width 10 -menu ${button}.m -relief raised -border 1
- menu ${button}.m
+ irmenu ${button}.m
+ if {[tk4]} {
+ ${button}.m configure -tearoff off
+ }
}
set i 0
foreach name $names {
}
}
+# Procedure listbutton {button no names}
+# button menubutton widget
+# no initial value index (integer)
+# names list of possible values.
+# Makes a listbutton. The functionality is emulated by the use menubutton-
+# and menu widgets.
proc listbutton {button no names} {
menubutton $button -text [lindex $names $no] -width 10 -menu ${button}.m \
-relief raised -border 1
- menu ${button}.m
+ irmenu ${button}.m
+ if {[tk4]} {
+ ${button}.m configure -tearoff off
+ }
foreach name $names {
${button}.m add command -label $name \
-command [list ${button} configure -text $name]
}
}
+# Procedure listbuttonv-action {button var names i}
+# button menubutton widget
+# var global variable to be affected
+# names list of possible names and values
+# This procedure is called when the user alters a menu created by the
+# listbuttonv procedure. The global variable $var is updated.
proc listbuttonv-action {button var names i} {
global $var
$button configure -text [lindex $names $i]
}
+# Procedure listbuttonv {button var names}
+# button menubutton widget
+# var global variable to be affected
+# names List of name/value pairs, i.e. {n1 v1 n2 v2 ...}.
+# This procedure emulates a listbutton by means of menu/menubutton widgets.
+# The global variable $var is automatically updated and set to one of the
+# values v1, v2, ...
proc listbuttonv {button var names} {
global $var
}
menubutton $button -text $n -menu ${button}.m \
-relief raised -border 1
- menu ${button}.m
+ irmenu ${button}.m
+ if {[tk4]} {
+ ${button}.m configure -tearoff off
+ }
for {set i 0} {$i < $l} {incr i 2} {
${button}.m add command -label [lindex $names $i] \
-command [list listbuttonv-action $button $var $names $i]
}
}
+# Procedure query-add-index-action {queryNo}
+# queryNo query type number (integer)
+# Handler that makes a new query index.
proc query-add-index-action {queryNo} {
set w .query-setup
#pack $w.top.lines -side left -pady 6 -padx 6 -fill y
}
+# Procedure query-add-line
+# queryNo query type number (integer)
+# Handler that adds new query line.
proc query-add-line {queryNo} {
set w .query-setup
#pack $w.top.lines -side left -pady 6 -padx 6 -fill y
}
+# Procedure query-del-line
+# queryNo query type number (integer)
+# Handler that removes query line.
proc query-del-line {queryNo} {
set w .query-setup
index-lines $w.top.lines 0 $queryButtonsTmp $queryInfoTmp activate-e-index
}
+# Procedure query-add-index
+# queryNo query type number (integer)
+# Handler that adds new query index.
proc query-add-index {queryNo} {
set w .query-add-index
focus $oldFocus
}
+# Procedure query-setup-action
+# queryNo query type number (integer)
+# Handler that updates the query information database stored in the
+# globals $queryInfo and $queryButtons. This procedure is executed when
+# the user commits the query setup changes by pressing button "Ok".
proc query-setup-action {queryNo} {
global queryButtons
global queryInfo
index-lines .lines 1 $queryButtonsFind $queryInfoFind activate-index
}
+# Procedure activate-e-index {value no i}
+# value menu name
+# no query index number
+# i menu index (integer)
+# Procedure called when listbutton is activated in the query type edit
+# window. The global $queryButtonsTmp is updated in this operation.
proc activate-e-index {value no i} {
global queryButtonsTmp
global queryIndexTmp
set queryIndexTmp $i
}
+# Procedure activate-index {value no i}
+# value menu name
+# no query index number
+# i menu index (integer)
+# Procedure called when listbutton is activated in the main query
+# window. The global $queryButtonsFind is updated in this operation.
proc activate-index {value no i} {
global queryButtonsFind
dputs "queryButtonsFind $queryButtonsFind"
}
+# Procedure update-attr
+# This procedure creates listbuttons for all bib-1 attributes except
+# the use-attribute in the .index-setup window.
+# The globals $relationTmpValue, $positionTmpValue, $structureTmpValue,
+# $truncationTmpValue and $completenessTmpValue are maintainted by the
+# listbuttons.
proc update-attr {} {
set w .index-setup
listbuttonv $w.top.relation.b relationTmpValue\
{Incomplete subfield} 1 {Complete subfield} 2 {Complete field} 3}
}
+# Procedure use-attr {init}
+# init init flag
+# This procedure creates a listbox with several Bib-1 use attributes.
+# If $init is 1 the listbox is created with the attributes. If $init
+# is 0 the current selection of the listbox is read and the global
+# $useTmpValue is set to the current use-value.
proc use-attr {init} {
set attr {
{None} 0
}
}
+# Procedure index-setup-action {oldAttr queryNo indexNo}
+# oldAttr original attributes (?)
+# queryNo query number
+# indexNo index number
+# Commits setup of a query index. The mapping from the index to
+# the Bib-1 attributes are handled by this function.
proc index-setup-action {oldAttr queryNo indexNo} {
set attr [lindex $oldAttr 0]
destroy .index-setup
}
+# Procedure index-setup {attr queryNo indexNo}
+# attr original attributes
+# queryNo query number
+# indexNo index number
+# Makes a window with settings of a given query index which the user
+# may inspect/modify.
proc index-setup {attr queryNo indexNo} {
set w .index-setup
set completenessTmpValue 0
set useTmpValue 0
+ catch {destroy $w}
+ toplevelG $w
+
+ set n [lindex $attr 0]
+ wm title $w "Index setup $n"
+
+ top-down-window $w
+
set len [llength $attr]
for {set i 1} {$i < $len} {incr i} {
set q [lindex $attr $i]
}
}
}
- if {[winfo exists $w]} {
- destroy $w
- }
- toplevelG $w
-
- set n [lindex $attr 0]
- wm title $w "Index setup $n"
-
- top-down-window $w
frame $w.top.use -relief ridge -border 2
frame $w.top.relation -relief ridge -border 2
}
+# Procedure query-edit-index {queryNo}
+# queryNo query number
+# Determines if a selection of an index is active. If one is selected
+# the index-setup dialog is started.
proc query-edit-index {queryNo} {
global queryInfoTmp
set w .query-setup
set i [lindex [$w.top.index.list curselection] 0]
- if {$i == ""} {
+ if {![string length $i]} {
return
}
set attr [lindex $queryInfoTmp $i]
index-setup $attr $queryNo $i
}
+# Procedure query-delete-index {queryNo}
+# queryNo query number
+# Determines if a selection of an index is active. If one is selected
+# the index is deleted.
proc query-delete-index {queryNo} {
global queryInfoTmp
global queryButtonsTmp
set w .query-setup
set i [lindex [$w.top.index.list curselection] 0]
- if {$i == ""} {
+ if {![string length $i]} {
return
}
set queryInfoTmp [lreplace $queryInfoTmp $i $i]
$w.top.index.list delete $i
}
+# Procedure query-setup {queryNo}
+# queryNo query number
+# Makes a dialog in which a query type an be customized.
proc query-setup {queryNo} {
set w .query-setup
listbox $w.top.index.list -yscrollcommand [list $w.top.index.scroll set]
scrollbar $w.top.index.scroll -orient vertical -border 1 \
-command [list $w.top.index.list yview]
- bind $w.top.index.list <2> [list query-edit-index $queryNo]
+ bind $w.top.index.list <Double-1> [list query-edit-index $queryNo]
pack $w.top.index.list -side left -fill both -expand yes -padx 2 -pady 2
pack $w.top.index.scroll -side right -fill y -padx 2 -pady 2
foreach x $queryInfoTmp {
$w.top.index.list insert end [lindex $x 0]
}
+
# Bottom
bottom-buttons $w [list \
- {Ok} [list query-setup-action $queryNo] \
- {Add index} [list query-add-index $queryNo] \
- {Edit index} [list query-edit-index $queryNo] \
- {Delete index} [list query-delete-index $queryNo] \
- {Cancel} [list destroy $w]] 0
+ Ok [list query-setup-action $queryNo] \
+ Add [list query-add-index $queryNo] \
+ Edit [list query-edit-index $queryNo] \
+ Delete [list query-delete-index $queryNo] \
+ Cancel [list destroy $w]] 0
}
+# Procedure index-clear
+# Handler that clears the search entry fields.
proc index-clear {} {
global queryButtonsFind
incr i
}
}
-
+
+# Procedure index-query
+# The purpose of this function is to read the user's query and convert
+# it to the prefix query that IrTcl/YAZ uses to represent an RPN query.
+# Each entry in a search fields takes the form
+# [relOp][?]term[?]
+# Here, relOp is an optional relational operator and one of:
+# > < >= <= <>
+# which sets the Bib-1 relation to greater-than, less-than, etc.
+# The ? (question-mark) is also optional. A (?) on left-side indicates
+# left truncation; (?) on right-side indicates right-truncation; (?)
+# on both sides indicates both-left-and-right truncation.
proc index-query {} {
global queryButtonsFind
global queryInfoFind
if {$term != ""} {
set attr [lrange [lindex $queryInfoFind [lindex $b 1]] 1 end]
+ set relation ""
+ set len [string length $term]
+ incr len -1
+
+ if {$len > 1} {
+ if {[string index $term 0] == ">"} {
+ if {[string index $term 1] == "=" } {
+ set term [string trim [string range $term 2 $len]]
+ set relation 4
+ } else {
+ set term [string trim [string range $term 1 $len]]
+ set relation 5
+ }
+ } elseif {[string index $term 0] == "<"} {
+ if {[string index $term 1] == "=" } {
+ set term [string trim [string range $term 2 $len]]
+ set relation 2
+ } elseif {[string index $term 1] == ">"} {
+ set term [string trim [string range $term 2 $len]]
+ set relation 6
+ } else {
+ set term [string trim [string range $term 1 $len]]
+ set relation 1
+ }
+ }
+ }
set len [string length $term]
incr len -1
set left 0
} elseif {$left} {
set term "@attr 5=2 ${term}"
}
+ if {$relation != ""} {
+ set term "@attr 2=${relation} ${term}"
+ }
foreach a $attr {
set term "@attr $a ${term}"
}
return $qs
}
+# Procedure index-focus-in {w i}
+# w index frame
+# i index number
+# This procedure handles <FocusIn> events. A red border is drawed
+# around the active search entry field when tk3.6 is used (tk4.X
+# makes a black focus border itself).
proc index-focus-in {w i} {
global curIndexEntry
set curIndexEntry $i
}
+# Procedure index-lines {w readOp buttonInfo queryInfo handle}
+# w search fields entry frame
+# realOp if true, search-request bindings are bound to the entries.
+# buttonInfo query type button information
+# queryInfo query type field information
+# handle handler called a when a 'listbutton' changes its value
+# Makes one or more search areas - with listbuttons on the left
+# and entries on the right.
proc index-lines {w realOp buttonInfo queryInfo handle} {
set i 0
foreach b $buttonInfo {
if {! [winfo exists $w.$i.e]} {
entry $w.$i.e -width 32 -relief sunken -border 1
bind $w.$i.e <FocusIn> [list index-focus-in $w $i]
- bind $w.$i.e <FocusOut> [list $w.$i configure \
- -background white]
+ if {![tk4]} {
+ bind $w.$i.e <FocusOut> [list $w.$i configure \
+ -background white]
+ }
pack $w.$i.l -side left
pack $w.$i.e -side left -fill x -expand yes
pack $w.$i -side top -fill x -padx 2 -pady 2
}
}
+# Procedure search-fields {w buttondefs}
+# w search fields entry frame
+# buttondefs button definitions
+# Makes search entry fields and listbuttons.
+# Note: This procedure is not used elsewhere. The index-lines
+# procedure is used instead.
proc search-fields {w buttondefs} {
set i 0
foreach buttondef $buttondefs {
$w.0 configure -background red
}
-if {[info exists windowGeometry(.)]} {
- set g $windowGeometry(.)
- if {$g != ""} {
- wm geometry . $g
- }
-}
+# Init: The geometry information for the main window is set - either
+# to a default value or to the value in windowGeometry(.)
+if {[catch {set g $windowGeometry(.)}]} {
+ wm geometry . 420x340
+} else {
+ wm geometry . $g
+}
+# Init: Presentation formats are read.
read-formats
+# Init: The main window is defined.
frame .top -border 1 -relief raised
frame .lines -border 1 -relief raised
frame .mid -border 1 -relief raised
pack .data -side top -fill both -expand yes
pack .bot -fill x
-menubutton .top.file -text "File" -menu .top.file.m
-menu .top.file.m
-.top.file.m add command -label "Save settings" -command {save-settings}
+# Init: Definition of File menu.
+menubutton .top.file -text File -menu .top.file.m
+irmenu .top.file.m
+.top.file.m add command -label {Save settings} -command {save-settings}
.top.file.m add separator
-.top.file.m add command -label "Exit" -command {exit-action}
-
-menubutton .top.target -text "Target" -menu .top.target.m
-menu .top.target.m
-.top.target.m add cascade -label "Connect" -menu .top.target.m.clist
-.top.target.m add command -label "Disconnect" -command {close-target}
-.top.target.m add command -label "About" -command {about-target}
-.top.target.m add cascade -label "Setup" -menu .top.target.m.slist
-.top.target.m add command -label "Setup new" -command {define-target-dialog}
+.top.file.m add command -label Exit -command {exit-action}
+
+# Init: Definition of Target menu.
+menubutton .top.target -text Target -menu .top.target.m
+irmenu .top.target.m
+.top.target.m add cascade -label Connect -menu .top.target.m.clist
+.top.target.m add command -label Disconnect -command {close-target}
+.top.target.m add command -label About -command {about-target}
+.top.target.m add cascade -label Setup -menu .top.target.m.slist
+.top.target.m add command -label {Setup new} -command {define-target-dialog}
.top.target.m add separator
set-target-hotlist 0
configure-disable-e .top.target.m 1
configure-disable-e .top.target.m 2
-menu .top.target.m.clist
-menu .top.target.m.slist
+irmenu .top.target.m.clist
+irmenu .top.target.m.slist
cascade-target-list
-menubutton .top.service -text "Service" -menu .top.service.m
-menu .top.service.m
-.top.service.m add command -label "Database" -command {database-select}
-.top.service.m add cascade -label "Present" -menu .top.service.m.present
-menu .top.service.m.present
-.top.service.m.present add command -label "10 More" \
+# Init: Definition of Service menu.
+menubutton .top.service -text Service -menu .top.service.m
+irmenu .top.service.m
+.top.service.m add cascade -label Database -menu .top.service.m.dblist
+.top.service.m add cascade -label Present -menu .top.service.m.present
+irmenu .top.service.m.present
+.top.service.m.present add command -label {10 More} \
-command [list present-more 10]
-.top.service.m.present add command -label "All" \
+.top.service.m.present add command -label All \
-command [list present-more {}]
-.top.service.m add command -label "Search" -command {search-request 0}
-.top.service.m add command -label "Scan" -command {scan-request}
+.top.service.m add command -label Search -command {search-request 0}
+.top.service.m add command -label Scan -command {scan-request}
+.top.service.m add command -label Explain -command \
+ {explain-refresh $hostid {ready-response {}} }
.top.service configure -state disabled
-menubutton .top.rset -text "Set" -menu .top.rset.m
-menu .top.rset.m
-.top.rset.m add command -label "Load" -command {load-set}
-.top.rset.m add separator
+irmenu .top.service.m.dblist
-menubutton .top.options -text "Options" -menu .top.options.m
-menu .top.options.m
-.top.options.m add cascade -label "Query" -menu .top.options.m.query
-.top.options.m add cascade -label "Format" -menu .top.options.m.formats
-.top.options.m add cascade -label "Wrap" -menu .top.options.m.wrap
-.top.options.m add cascade -label "Syntax" -menu .top.options.m.syntax
+# Init: Definition of Set menu.
+menubutton .top.rset -text Set -menu .top.rset.m
+irmenu .top.rset.m
+.top.rset.m add command -label Load -command {load-set}
+.top.rset.m add separator
-menu .top.options.m.query
-.top.options.m.query add cascade -label "Select" \
+# Init: Definition of the Options menu.
+menubutton .top.options -text Options -menu .top.options.m
+irmenu .top.options.m
+.top.options.m add cascade -label Query -menu .top.options.m.query
+.top.options.m add cascade -label Format -menu .top.options.m.formats
+.top.options.m add cascade -label Wrap -menu .top.options.m.wrap
+.top.options.m add cascade -label Syntax -menu .top.options.m.syntax
+.top.options.m add cascade -label Elements -menu .top.options.m.elements
+.top.options.m add radiobutton -label Debug -variable debugMode -value 1
+
+# Init: Definition of the Options|Query menu.
+irmenu .top.options.m.query
+.top.options.m.query add cascade -label Select \
-menu .top.options.m.query.clist
-.top.options.m.query add cascade -label "Edit" \
+.top.options.m.query add cascade -label Edit \
-menu .top.options.m.query.slist
-.top.options.m.query add command -label "New" \
+.top.options.m.query add command -label New \
-command {query-new}
-.top.options.m.query add cascade -label "Delete" \
+.top.options.m.query add cascade -label Delete \
-menu .top.options.m.query.dlist
-menu .top.options.m.query.slist
-menu .top.options.m.query.clist
-menu .top.options.m.query.dlist
+irmenu .top.options.m.query.slist
+irmenu .top.options.m.query.clist
+irmenu .top.options.m.query.dlist
cascade-query-list
-menu .top.options.m.formats
+# Init: Definition of the Options|Formats menu.
+irmenu .top.options.m.formats
set i 0
foreach f $displayFormats {
.top.options.m.formats add radiobutton -label $f -value $i \
incr i
}
-menu .top.options.m.wrap
-.top.options.m.wrap add radiobutton -label "Character" \
+# Init: Definition of the Options|Wrap menu.
+irmenu .top.options.m.wrap
+.top.options.m.wrap add radiobutton -label Character \
-value char -variable textWrap -command {set-wrap char}
-.top.options.m.wrap add radiobutton -label "Word" \
+.top.options.m.wrap add radiobutton -label Word \
-value word -variable textWrap -command {set-wrap word}
-.top.options.m.wrap add radiobutton -label "None" \
+.top.options.m.wrap add radiobutton -label None \
-value none -variable textWrap -command {set-wrap none}
-menu .top.options.m.syntax
-.top.options.m.syntax add radiobutton -label "None" \
+# Init: Definition of the Options|Syntax menu.
+irmenu .top.options.m.syntax
+.top.options.m.syntax add radiobutton -label None \
-value None -variable recordSyntax
.top.options.m.syntax add separator
-.top.options.m.syntax add radiobutton -label "USMARC" \
+.top.options.m.syntax add radiobutton -label USMARC \
-value USMARC -variable recordSyntax
-.top.options.m.syntax add radiobutton -label "UNIMARC" \
+.top.options.m.syntax add radiobutton -label UNIMARC \
-value UNIMARC -variable recordSyntax
-.top.options.m.syntax add radiobutton -label "UKMARC" \
+.top.options.m.syntax add radiobutton -label UKMARC \
-value UKMARC -variable recordSyntax
-.top.options.m.syntax add radiobutton -label "DANMARC" \
+.top.options.m.syntax add radiobutton -label DANMARC \
-value DANMARC -variable recordSyntax
-.top.options.m.syntax add radiobutton -label "FINMARC" \
+.top.options.m.syntax add radiobutton -label FINMARC \
-value FINMARC -variable recordSyntax
-.top.options.m.syntax add radiobutton -label "NORMARC" \
+.top.options.m.syntax add radiobutton -label NORMARC \
-value NORMARC -variable recordSyntax
-.top.options.m.syntax add radiobutton -label "PICAMARC" \
+.top.options.m.syntax add radiobutton -label PICAMARC \
-value PICAMARC -variable recordSyntax
.top.options.m.syntax add separator
-.top.options.m.syntax add radiobutton -label "SUTRS" \
+.top.options.m.syntax add radiobutton -label SUTRS \
-value SUTRS -variable recordSyntax
.top.options.m.syntax add separator
-.top.options.m.syntax add radiobutton -label "GRS1" \
+.top.options.m.syntax add radiobutton -label GRS1 \
-value GRS1 -variable recordSyntax
+# Init: Definition of the Options|Elements menu.
+irmenu .top.options.m.elements
+.top.options.m.elements add radiobutton -label Unspecified \
+ -value None -variable elementSetNames
+.top.options.m.elements add radiobutton -label Full \
+ -value F -variable elementSetNames
+.top.options.m.elements add radiobutton -label Brief \
+ -value B -variable elementSetNames
+
+# Init: Definition of Help menu.
menubutton .top.help -text "Help" -menu .top.help.m
-menu .top.help.m
+irmenu .top.help.m
.top.help.m add command -label "Help on help" \
-command {tkerror "Help on help not available. Sorry"}
.top.help.m add command -label "About" -command {about-origin}
+# Init: Pack menu bar items.
pack .top.file .top.target .top.service .top.rset .top.options -side left
pack .top.help -side right
+# Init: Define query area.
index-lines .lines 1 $queryButtonsFind [lindex $queryInfo 0] activate-index
button .mid.search -text Search -command {search-request 0} \
pack .mid.search .mid.scan .mid.present .mid.clear -side left \
-fill y -pady 1
-text .data.record -height 2 -width 20 -wrap none \
- -yscrollcommand [list .data.scroll set] -wrap $textWrap
+# Init: Define record area in main window.
+text .data.record -font fixed -height 2 -width 20 -wrap none -borderwidth 0 \
+ -relief flat -yscrollcommand [list .data.scroll set] \
+ -wrap $textWrap -background grey85
scrollbar .data.scroll -command [list .data.record yview]
if {[tk4]} {
.data.record configure -takefocus 0
.data.scroll configure -takefocus 0
}
+
pack .data.scroll -side right -fill y
pack .data.record -expand yes -fill both
initBindings
+# Init: Define standards tags. These are used in the display
+# format procedures.
if {! $monoFlag} {
.data.record tag configure marc-tag -foreground blue
.data.record tag configure marc-id -foreground red
.data.record tag configure marc-id -foreground black
}
.data.record tag configure marc-data -foreground black
-
+.data.record tag configure marc-head -font $font(n,normal) \
+ -foreground brown -relief raised -borderwidth 1
+.data.record tag configure marc-small-head -foreground brown
+.data.record tag configure marc-pref \
+ -font $font(n,normal) -foreground blue
+.data.record tag configure marc-text \
+ -font $font(n,normal) -foreground black
+.data.record tag configure marc-it \
+ -font $font(n,normal) -foreground black
+
+# Init: Define logo.
button .bot.logo -bitmap @${libdir}/bitmaps/book1 -command cancel-operation
if {[tk4]} {
.bot.logo configure -takefocus 0
}
+# Init: Define status information fields at the bottom.
frame .bot.a
pack .bot.a -side left -fill x
pack .bot.logo -side right -padx 2 -pady 2 -ipadx 1
-message .bot.a.target -text "" -aspect 1000 -border 1
+message .bot.a.target -text {} -aspect 2000 -border 1
label .bot.a.status -text "Not connected" -width 15 -relief \
sunken -anchor w -border 1
pack .bot.a.status .bot.a.set .bot.a.message \
-side left -padx 2 -pady 2 -ipadx 1 -ipady 1
+# Init: Determine if the IrTcl extension is already there. If
+# not, then dynamically load the IrTcl extension.
if {[catch {ir z39}]} {
set e [info sharedlibextension]
- puts -nonewline "Loading irtcl..."
- load irtcl$e
+ puts -nonewline "Loading irtcl$e ..."
+ load ${libdir}/irtcl$e irtcl
ir z39
puts "ok"
}
-#z39 logLevel all
+
+if {[file exists ${libdir}/explain.tcl]} {
+ source ${libdir}/explain.tcl
+}
+
+if {[file exists ${libdir}/setup.tcl]} {
+ source ${libdir}/setup.tcl
+}
+
+# Init: Uncomment this line if you wan't to enable logging.
+ir-log-init all irtcl irtcl.log
+
+# Init: If hostid is a valid target, a new connection will be established
+# immediately.
+if {[string compare $hostid Default]} {
+ catch {open-target $hostid $hostbase}
+}
+
+# Init: Enable the logo.
show-logo 1