2 Webservice requests are any that refer to filename "search.pz2". Arguments
3 are GET-style parameters. Argument 'command' is required and specifies
4 command. Any request not recognized as a webservice request as described,
5 are forwarded to the HTTP server specified in option -p.
11 Initializes a session. Returns session ID to be used in subsequent requests. Example:
13 search.pz2?command=init
19 <session>2044502273</session>
24 Keeps a session alive. An idle session will time out after one minute. The
25 ping command can be used to keep the session alive absent other activity. It
26 is suggested that any browser client have a simple alarm handler which
27 sends a ping every 50 seconds or so once a session has been initialized.
31 search.pz?command=ping&session=2044502273
41 Launches a search, parameters:
48 search.pz2?session=2044502273&command=search&query=computer
58 Provides status of ongoing search. Parameters:
64 search.pz2?session=2044502273&command=stat
69 <activeclients>3</activeclients>
70 <hits>7</hits> -- Total hitcount
71 <records>7</records> -- Total number of records fetched
72 <clients>1</clients> -- Total number of associated clients
73 <unconnected>0</unconnected> -- Number of disconnected clients
74 <connecting>0</connecting> -- Number of clients in connecting state
75 <initializing>0</initializing> -- Number of clients initializing
76 <searching>0</searching> -- ... searching
77 <presenting>0</presenting> -- ... presenting
78 <idle>1</idle> -- ... idle (not doing anything)
79 <failed>0</failed> -- ... Connection failed
80 <error>0</error> -- ... Error was produced somewhere
85 Shows records retrieved
94 If block is set, the command will hang until there are records ready
95 to display. Use this to show first records rapidly without requiring rapid
100 search.pz2?session=2044502273&command=show&start=0&num=2
106 <activeclients>3</activeclients>
112 <md-title>How to program a computer, by Jack Collins</md-title>
113 <count>2</count> <!-- Number of merged records -->
118 Computer processing of dynamic images from an Anger scintillation camera :
119 the proceedings of a workshop /
127 Retrieves a detailed record.
129 Parameters: id -- record ID as provided by the show command
133 search.pz2?session=605047297&command=record&id=3
139 The Puget Sound Region : a portfolio of thematic computer maps /
141 <md-date>1974</md-date>
142 <md-author>Mairs, John W.</md-author>
143 <md-subject>Cartography</md-subject>
148 Retrieves term list(s)
153 name -- comma-separated list of termlist names (default "subject")
157 search.pz2?session=2044502273&command=termlist&name=author,subject
162 <activeclients>3</activeclients>
165 <name>Donald Knuth</name>
166 <frequency>10</frequency>
169 <name>Robert Pirsig</name>
170 <frequency>2</frequency>
173 <list name="subject">
175 <name>Computer programming</name>
176 <frequency>10</frequency>
181 For the special termlist name "xtargets", results are returned about the targets
182 which have returned the most hits. The 'term' subtree has additional elements,
183 specifically a state and diagnostic field (in the example below, a target ID is
184 returned in place of 'name'. This may or may not change later.
187 <name>library2.mcmaster.ca</name>
188 <frequency>11734</frequency>
189 <state>Client_Idle</state>
190 <diagnostic>0</diagnostic>