This file is indexed.

/usr/share/doc/refdb/refdb-manual/ch23s03.html is in refdb-doc 1.0.2-3ubuntu1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Commented abstract representation of the client/server protocol</title><link rel="stylesheet" type="text/css" href="manual.css" /><meta name="generator" content="DocBook XSL Stylesheets V1.79.1" /><link rel="home" href="index.html" title="RefDB handbook" /><link rel="up" href="ch23.html" title="Chapter 23. The RefDB client/server communication protocol" /><link rel="prev" href="ch23s02.html" title="Basic principles" /><link rel="next" href="ch23s04.html" title="Tools for the client-server protocol" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Commented abstract representation of the client/server protocol</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch23s02.html">Prev</a> </td><th width="60%" align="center">Chapter 23. The RefDB client/server communication protocol</th><td width="20%" align="right"> <a accesskey="n" href="ch23s04.html">Next</a></td></tr></table><hr /></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="idp73109152"></a>Commented abstract representation of the client/server protocol</h2></div></div></div><p>This chapter tries to explain the client/server protocol of all currently supported RefDB commands using an abstract representation which should be fairly easy to port to any real programming language.</p><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp73110576"></a>First stage</h3></div></div></div><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td>6\0\0\0\0</td><td> </td><td> </td><td>the current protocol version, a terminated string of up to 16 characters. The whole string will be converted to an integer internally. The current protocol version of RefDB is a compile-time constant which is defined in <code class="filename">src/connect.h</code>.</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>ABC-DE-FG-HI\0\0\0\0</td><td>ok</td><td>the ok status message, followed by the randomly generated encryption string</td></tr><tr><td> </td><td> </td><td> </td><td>error</td><td>there is no server response in case of a refused remote connection</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-102">102</a>, <a class="link" href="ch23s03.html#cs-status-103">103</a>, <a class="link" href="ch23s03.html#cs-status-104">104</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>an error status message, ending the dialog</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>command\0\0\0\0</td><td> </td><td>ok</td><td>the ok status message, followed by the command proper. See below for details.</td></tr><tr><td> </td><td>
		<a class="link" href="ch23s03.html#cs-status-112">112</a>
	      </td><td> </td><td>error</td><td>the error status code signalling a client error</td></tr></tbody></table></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="idp73098448"></a>Second stage</h3></div></div></div><p>The second stage is the more interesting part of the protocol, as it is here where the commands differ. The following section briefly explain the inner workings of the commands and show an abstract representation of the protocol.</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73099840"></a>addlink</h4></div></div></div><p>The internal API command <span class="command"><strong>addlink</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-addlink" title="addlink">refdbc: addlink</a>. </p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>addlink [options] link-spec [link-spec...]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated addlink command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-803">803</a>
		</td><td>partial success, aborted after unrecoverable error</td><td>the error message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-417">417</a>, <a class="link" href="ch23s03.html#cs-status-233">233</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73092464"></a>addnote</h4></div></div></div><p>The internal API command <span class="command"><strong>addnote</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-addnote" title="addnote">refdbc: addnote</a>. </p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>addnote [options] filename\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated addnote command sting</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-701">701</a>
		</td><td>warning</td><td>the warning message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-204">204</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string denoting the number of bytes that the client wants to transmit</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-401">401</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem reading the input data, ending the session</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, ending the session</td></tr><tr><td>5</td><td>&lt;data&gt;</td><td> </td><td>ok</td><td>the previously announced number of data bytes</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-400">400</a>&lt;message&gt;\0\0\0\0</td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-408">408</a> or <a class="link" href="ch23s03.html#cs-status-413">413</a></td><td>ok</td><td>the message status denoting success of the previous add or update action</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-702">702</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td>7</td><td>see step 3</td><td> </td><td>ok</td><td>repeat loop until end of data</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td>8</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-403">403</a>&lt;result message&gt;\0\0\0\0</td><td>ok</td><td>the ok status signalling that a chunk has been added successfully, followed by the terminated server result message, finishing the dialog</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73168480"></a>addref, updateref, checkref</h4></div></div></div><p>The <a class="link" href="re11.html#app-c-command-addref" title="addref">addref</a> and <a class="link" href="re11.html#app-c-command-updateref" title="updateref">updateref</a> commands send bibliographic data in various formats to the database in order to add or update them, respectively. The related <a class="link" href="re11.html#app-c-command-checkref" title="checkref">checkref</a> command also sends bibliographic data to the server in order to check for duplicates. The client/server protocols differ slightly based on the type of data transferred. RIS data are transmitted one dataset at a time, whereas XML data are streamed in chunks of a defined size.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>XXref -s ris [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated addref command sting</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-701">701</a>
		</td><td>warning</td><td>the warning message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-401">401</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string denoting the number of bytes that the client wants to transmit</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-401">401</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem reading the input data, ending the session</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, ending the session</td></tr><tr><td>5</td><td>&lt;data&gt;</td><td> </td><td>ok</td><td>the previously announced number of data bytes</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-400">400</a>&lt;message&gt;\0\0\0\0</td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-408">408</a>&lt;message&gt;\0\0\0\0 or <a class="link" href="ch23s03.html#cs-status-413">413</a>&lt;message&gt;\0\0\0\0</td><td>ok</td><td>the message status denoting success of the previous add or update action, followed by the current value of the dataset counter</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-702">702</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td>7</td><td>see step 3</td><td> </td><td>ok</td><td>repeat loop until end of data</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td>8</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>&lt;data&gt;\0\0\0\0
		</td><td>ok</td><td>the ok status signalling that a chunk has been added successfully, followed by an optional terminated string containing a result message</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>10</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>11</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div><p>And now the slightly different protocol for risx data:</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>addref -s risx [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated addref command sting</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-701">701</a>
		</td><td>warning</td><td>the warning message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-204">204</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string denoting the number of bytes that the client wants to transmit</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-401">401</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem reading the input data, ending the session</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, ending the session</td></tr><tr><td>5</td><td>&lt;data&gt;</td><td> </td><td>ok</td><td>the previously announced number of data bytes</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-400">400</a>&lt;message&gt;\0\0\0\0</td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-408">408</a>&lt;message&gt;\0\0\0\0 or <a class="link" href="ch23s03.html#cs-status-413">413</a>&lt;message&gt;\0\0\0\0</td><td>ok</td><td>the message status denoting success of the previous add or update action, followed by the current value of the dataset counter</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-702">702</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td>7</td><td>see step 3</td><td> </td><td>ok</td><td>repeat loop until end of data</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td>8</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>&lt;data&gt;\0\0\0\0
		</td><td>ok</td><td>the ok status signalling that a chunk has been added successfully, followed by an optional terminated string containing the result message</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>10</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>11</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73758704"></a>addstyle</h4></div></div></div><p>The internal API command <span class="command"><strong>addstyle</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-addstyle" title="addstyle">refdba: addstyle</a>. </p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>addstyle [options] filename\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated addstyle command sting</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-104">104</a>, <a class="link" href="ch23s03.html#cs-status-105">105</a>, <a class="link" href="ch23s03.html#cs-status-106">106</a>, <a class="link" href="ch23s03.html#cs-status-107">107</a>, <a class="link" href="ch23s03.html#cs-status-108">108</a>, <a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-203">203</a>, <a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-206">206</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string denoting the number of bytes that the client wants to transmit</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-401">401</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem reading the input data, ending the session</td></tr><tr><td>4</td><td> </td><td>000</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, ending the session</td></tr><tr><td>5</td><td>&lt;data&gt;</td><td> </td><td>ok</td><td>the previously announced number of data bytes</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-400">400</a>&lt;message&gt;\0\0\0\0</td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td>7</td><td>see step 3</td><td> </td><td>ok</td><td>repeat loop until end of data</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td>8</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-403">403</a>&lt;result message&gt;\0\0\0\0</td><td>ok</td><td>the ok status signalling that a chunk has been added successfully, followed by the terminated server result message, finishing the dialog</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73824512"></a>adduser</h4></div></div></div><p>The internal API command <span class="command"><strong>adduser</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-adduser" title="adduser">refdba: adduser</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>adduser [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated adduser command sting</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a><a class="link" href="ch23s03.html#cs-status-224">224</a> or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;names&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing a list of names</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;summary&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-205">205</a>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem, ending the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73856080"></a>addword</h4></div></div></div><p>The internal API command <span class="command"><strong>addword</strong></span> handles both the <a class="link" href="re06.html#app-a-command-addword" title="addword">refdba: addword</a> and the <a class="link" href="re06.html#app-a-command-deleteword" title="deleteword">refdba: deleteword</a> client commands.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>addword [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated addword command sting</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing the word list</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-112">112</a>
		</td><td> </td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>7</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73893408"></a>confserv</h4></div></div></div><p>The internal API command <span class="command"><strong>confserv</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-confserv" title="confserv">refdba: confserv</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>confserv command [argument]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated confserv command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-301">301</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a>, <a class="link" href="ch23s03.html#cs-status-839">839</a>, <a class="link" href="ch23s03.html#cs-status-840">840</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73922656"></a>createdb</h4></div></div></div><p>The internal API command <span class="command"><strong>createdb</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-createdb" title="createdb">refdba: createdb</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>createdb [options]dbname\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated createdb command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-111">111</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73949744"></a>deletedb</h4></div></div></div><p>The internal API command <span class="command"><strong>deletedb</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-deletedb" title="deletedb">refdba: deletedb</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>deletedb [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated deletedb command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp73976832"></a>deletenote</h4></div></div></div><p>The internal API command <span class="command"><strong>deletenote</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-deletenote" title="deletenote">refdbc: deletenote</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>deletenote [options] &lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated adduser command sting containing the number of bytes required to store the ID list.</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-111">111</a>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;ID-list&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing a list of note IDs</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;data&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status, followed by a report about the delete actions</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-412">412</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the message status saying that there was a problem, ending the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;summary&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status, followed by a command summary</td></tr><tr><td>7</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74015216"></a>deleteref</h4></div></div></div><p>The internal API command <span class="command"><strong>deleteref</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-deleteref" title="deleteref">refdbc: deleteref</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>deleteref [options] &lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated adduser command sting containing the number of bytes required to store the ID list.</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;ID-list&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing a list of reference IDs</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;data&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status, followed by a report about the delete actions</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-412">412</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the message status saying that there was a problem, ending the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;summary&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status, followed by a command summary</td></tr><tr><td>7</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74052880"></a>deletestyle</h4></div></div></div><p>The internal API command <span class="command"><strong>deletestyle</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-deletestyle" title="deletestyle">refdba: deletestyle</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>deletestyle {regexp}\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated deletestyle command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-234">234</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74080704"></a>getau, geted, getas, getkw, getjo, getjf, getj1, getj2</h4></div></div></div><p>These internal API commands correspond to the client commands <a class="link" href="re11.html#app-c-command-getau" title="getau, geted, getas, getax">refdbc: getau</a>, <a class="link" href="re11.html#app-c-command-geted">refdbc: geted</a>, <a class="link" href="re11.html#app-c-command-getas">refdbc: getas</a>, <a class="link" href="re11.html#app-c-command-getkw" title="getkw">refdbc: getkw</a>, <a class="link" href="re11.html#app-c-command-getjo" title="getjo, getjf, getj1, getj2">refdbc: getjo</a>, <a class="link" href="re11.html#app-c-command-getjf">refdbc: getjf</a>, <a class="link" href="re11.html#app-c-command-getj1">refdbc: getj1</a>, <a class="link" href="re11.html#app-c-command-getj2">refdbc: getj2</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>getXX [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-208">208</a>, <a class="link" href="ch23s03.html#cs-status-234">234</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74113584"></a>getbib</h4></div></div></div><p>The internal API command <span class="command"><strong>getbib</strong></span> is used by the <a class="link" href="ch15.html" title="Chapter 15. Tools for bibliographies">refdbib</a> tool to retrieve cooked SGML and XML bibliographies.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>getbib [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated getbib command string.</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status, meaning no style spec will be transmitted (jump to 4)</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td>ok</td><td>the ok message status, meaning the style spec will be transmitted</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-241">241</a>, <a class="link" href="ch23s03.html#cs-status-701">701</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status, terminating the dialog</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-242">242</a>
		</td><td>error</td><td>the error message status, finishing the dialog</td></tr><tr><td>5</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string denoting the number of bytes that the client wants to transmit</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-401">401</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem reading the input data, ending the session</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, ending the session</td></tr><tr><td>7</td><td>&lt;data&gt;</td><td> </td><td>ok</td><td>the previously announced number of data bytes</td></tr><tr><td>8</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-400">400</a>&lt;message&gt;\0\0\0\0</td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>10</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td>ok</td><td>the ok status for the last chunk of data</td></tr><tr><td>11</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>12</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;summary&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by the terminated command summary string.</td></tr><tr><td>13</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, finishing the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74193328"></a>getnote, countnote</h4></div></div></div><p>The internal API command <span class="command"><strong>getnote</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-getnote" title="getnote">refdbc: getnote</a> and <a class="link" href="re11.html#app-c-command-countnote" title="countnote">refdbc: countnote</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>getnote [options] &lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated getref command sting containing the number of bytes required to store the query string</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;query-string&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing the query</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-404">404</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting a complete dataset, followed by a terminated string containing the dataset</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-402">402</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting the last chunk of data (usually a "footer"), followed by a terminated string containing the data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-234">234</a>, <a class="link" href="ch23s03.html#cs-status-701">701</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-402">402</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting the last chunk of data (usually a "footer"), see step 2</td></tr><tr><td>7</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-702">702</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>8</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74241904"></a>getref, countref</h4></div></div></div><p>The internal API command <span class="command"><strong>getref</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-getref" title="getref">refdbc: getref</a> and <a class="link" href="re11.html#app-c-command-countref" title="countref">refdbc: countref</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>getref [options] &lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated getref command sting containing the number of bytes required to store the query string (including the terminal NULL bytes)</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-301">301</a>
		</td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;query-string&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing the query</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-404">404</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting a complete dataset, followed by a terminated string containing the dataset</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-402">402</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting the last chunk of data (usually a "footer"), followed by a terminated string containing the data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-234">234</a>, <a class="link" href="ch23s03.html#cs-status-701">701</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-402">402</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting the last chunk of data (usually a "footer"), see step 2</td></tr><tr><td>7</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-702">702</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>8</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74293632"></a>getrefx</h4></div></div></div><p>The internal API command <span class="command"><strong>getrefx</strong></span> is used by the <a class="link" href="ch15.html" title="Chapter 15. Tools for bibliographies">refdbib</a> tool to retrieve raw SGML and XML bibliographies.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>getrefx [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated getbib command string.</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-701">701</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status, terminating the dialog</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string denoting the number of bytes that the client wants to transmit</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td> </td><td>ok</td><td>the message status saying that all data have been sent, ending the loop over all datasets</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td> </td><td>ok</td><td>the message status saying that the current dataset has been sent completely</td></tr><tr><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-401">401</a>
		</td><td> </td><td>error</td><td>the message status saying that there was a problem reading the input data, ending the session</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, ending the session</td></tr><tr><td>5</td><td>&lt;data&gt;</td><td> </td><td>ok</td><td>the previously announced number of data bytes</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-403">403</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-400">400</a>&lt;message&gt;\0\0\0\0</td><td>error</td><td>the error status, followed by a terminated, server-generated error message specifying the error</td></tr><tr><td>7</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>8</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-404">404</a>
		</td><td>ok</td><td>the ok status for a successfully transmitted chunk of data</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-402">402</a>
		</td><td>ok</td><td>the ok status for the last chunk of data</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-234">234</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a>, <a class="link" href="ch23s03.html#cs-status-702">702</a>
		</td><td>error</td><td>the error message status</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>10</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;summary&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by the terminated command summary string.</td></tr><tr><td>11</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, finishing the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74363664"></a>getstyle</h4></div></div></div><p>The internal API command <span class="command"><strong>getstyle</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-getstyle" title="getstyle">refdba: getstyle</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>getstyle [options][regexp]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated getstyle command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74384336"></a>gettexbib</h4></div></div></div><p>The internal API command <span class="command"><strong>gettexbib</strong></span> is used by the <a class="link" href="ch15.html" title="Chapter 15. Tools for bibliographies">refdbib</a> tool to retrieve bibtex bibliographies.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>gettexbib [options] data-size\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated gettexbib command string. The only non-option argument is the size, in bytes, of the ID data to be sent, including the terminator.</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status, terminating the dialog</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>id-data\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated ID list. This is a whitespace separated list of ID or CK values.</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-404">404</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting a complete dataset, followed by a terminated string containing the dataset</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-402">402</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting the last chunk of data (usually a "footer"), followed by a terminated string containing the data</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-234">234</a>, <a class="link" href="ch23s03.html#cs-status-269">269</a>, <a class="link" href="ch23s03.html#cs-status-701">701</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a>, or <a class="link" href="ch23s03.html#cs-status-842">842</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-402">402</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status denoting the last chunk of data (usually a "footer"), see step 4</td></tr><tr><td>7</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>8</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-702">702</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>9</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74436976"></a>listdb</h4></div></div></div><p>The internal API command <span class="command"><strong>listdb</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-listdb" title="listdb">refdbc: listdb</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>listdb [regexp]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated listdb/selectdb command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-225">225</a>, <a class="link" href="ch23s03.html#cs-status-226">226</a>, <a class="link" href="ch23s03.html#cs-status-802">802</a>, or <a class="link" href="ch23s03.html#cs-status-802">802</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74466208"></a>liststyle</h4></div></div></div><p>The internal API command <span class="command"><strong>liststyle</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-liststyle" title="liststyle">refdbc: liststyle</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>liststyle [options][regexp]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated liststyle command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74493296"></a>listuser</h4></div></div></div><p>The internal API command <span class="command"><strong>listuser</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-listuser" title="listuser">refdba: listuser</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>listuser [options] regexp\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated listuser command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-207">207</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74521104"></a>listword</h4></div></div></div><p>The internal API command <span class="command"><strong>listword</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-listword" title="listword">refdba: listword</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>listword regexp\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated listword command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-207">207</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74548896"></a>pickref</h4></div></div></div><p>The internal API command <span class="command"><strong>pickref</strong></span> handles the client commands <a class="link" href="re11.html#app-c-command-pickref" title="pickref">refdbc: pickref</a> and <a class="link" href="re11.html#app-c-command-dumpref" title="dumpref">dumpref</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>pickref [options] &lt;bytes&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated pickref command sting containing the number of bytes required to store the ID list.</td></tr><tr><td>2</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td>ok</td><td>the ok message status</td></tr><tr><td> </td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-111">111</a>
		  <a class="link" href="ch23s03.html#cs-status-801">801</a>
		</td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;ID-list&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by a terminated string containing a list of note IDs</td></tr><tr><td>4</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;data&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status, followed by a report about the pick or dump actions</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-412">412</a>, <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the message status saying that there was a problem, ending the session</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>6</td><td> </td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000&lt;summary&gt;\0\0\0\0</a>
		</td><td>ok</td><td>the ok message status, followed by a command summary</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-227">227</a>, <a class="link" href="ch23s03.html#cs-status-228">228</a>, <a class="link" href="ch23s03.html#cs-status-228">234</a></td><td>error</td><td>the error status, terminating the dialog</td></tr><tr><td>7</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74592256"></a>scankw</h4></div></div></div><p>The internal API command <span class="command"><strong>scankw</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-scankw" title="scankw">refdba: scankw</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>scankw -d &lt;databasename&gt;\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated scankw command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-208">208</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74620048"></a>selectdb</h4></div></div></div><p>The internal API command <span class="command"><strong>selectdb</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-selectdb" title="selectdb">refdbc: selectdb</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>selectdb dbname\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated listdb/selectdb command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-202">202</a>, <a class="link" href="ch23s03.html#cs-status-225">225</a>, <a class="link" href="ch23s03.html#cs-status-226">226</a>, <a class="link" href="ch23s03.html#cs-status-802">802</a>, or <a class="link" href="ch23s03.html#cs-status-802">802</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74649280"></a>viewstat</h4></div></div></div><p>The internal API command <span class="command"><strong>viewstat</strong></span> corresponds to <a class="link" href="re06.html#app-a-command-viewstat" title="viewstat">refdba: viewstat</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>viewstat [options]\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated viewstat command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-208">208</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a id="idp74677088"></a>whichdb</h4></div></div></div><p>The internal API command <span class="command"><strong>whichdb</strong></span> corresponds to <a class="link" href="re11.html#app-c-command-whichdb" title="whichdb">refdbc: whichdb</a>.</p><div class="informaltable"><table class="informaltable" border="1"><colgroup><col /><col /><col /><col /><col /></colgroup><thead><tr><th>step</th><th>client</th><th>server</th><th>message type</th><th>comment</th></tr></thead><tbody><tr><td>1</td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>whichdb\0\0\0\0</td><td> </td><td>ok</td><td>the ok message status, followed by the terminated whichdb command sting</td></tr><tr><td>2</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result</td></tr><tr><td> </td><td> </td><td><a class="link" href="ch23s03.html#cs-status-204">204</a>, <a class="link" href="ch23s03.html#cs-status-207">207</a>, or <a class="link" href="ch23s03.html#cs-status-801">801</a></td><td>error</td><td>the error message status which terminates the session</td></tr><tr><td>3</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status</td></tr><tr><td>4</td><td> </td><td><a class="link" href="ch23s03.html#cs-status-000">000</a>&lt;data&gt;\0\0\0\0</td><td>ok</td><td>the ok message status, followed by a terminated string containing the command result summary</td></tr><tr><td>5</td><td>
		  <a class="link" href="ch23s03.html#cs-status-000">000</a>
		</td><td> </td><td>ok</td><td>the ok message status, ending the dialog</td></tr></tbody></table></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a id="sect-statusmessages"></a>Status messages</h3></div></div></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The status codes which are multiples of 100 are not associated with a fixed message. Instead, clients should retrieve the terminated string sent after these codes to read the dynamically generated message.</p></div><div class="variablelist"><dl class="variablelist"><dt><a id="cs-status-000"></a><span class="term">000</span></dt><dd><p>ok</p></dd><dt><a id="cs-status-001"></a><span class="term">001</span></dt><dd><p>error</p></dd><dt><a id="cs-status-100"></a><span class="term">100</span></dt><dd><p>void</p></dd><dt><a id="cs-status-101"></a><span class="term">101</span></dt><dd><p>incorrect scramble string</p></dd><dt><a id="cs-status-102"></a><span class="term">102</span></dt><dd><p>client and server protocols do not match</p></dd><dt><a id="cs-status-103"></a><span class="term">103</span></dt><dd><p>invalid client request</p></dd><dt><a id="cs-status-104"></a><span class="term">104</span></dt><dd><p>incomplete client command</p></dd><dt><a id="cs-status-105"></a><span class="term">105</span></dt><dd><p>missing client command</p></dd><dt><a id="cs-status-106"></a><span class="term">106</span></dt><dd><p>missing client command option</p></dd><dt><a id="cs-status-107"></a><span class="term">107</span></dt><dd><p>unknown client command option</p></dd><dt><a id="cs-status-108"></a><span class="term">108</span></dt><dd><p>could not descramble password</p></dd><dt><a id="cs-status-109"></a><span class="term">109</span></dt><dd><p>timeout while reading</p></dd><dt><a id="cs-status-110"></a><span class="term">110</span></dt><dd><p>timeout while writing</p></dd><dt><a id="cs-status-111"></a><span class="term">111</span></dt><dd><p>missing client command argument</p></dd><dt><a id="cs-status-112"></a><span class="term">112</span></dt><dd><p>client aborted command</p></dd><dt><a id="cs-status-200"></a><span class="term">200</span></dt><dd><p>void</p></dd><dt><a id="cs-status-201"></a><span class="term">201</span></dt><dd><p>main database is missing</p></dd><dt><a id="cs-status-202"></a><span class="term">202</span></dt><dd><p>could not open main database</p></dd><dt><a id="cs-status-203"></a><span class="term">203</span></dt><dd><p>main database is too old or corrupt</p></dd><dt><a id="cs-status-204"></a><span class="term">204</span></dt><dd><p>could not open reference database</p></dd><dt><a id="cs-status-205"></a><span class="term">205</span></dt><dd><p>could not connect to database server</p></dd><dt><a id="cs-status-206"></a><span class="term">206</span></dt><dd><p>main database version is not supported</p></dd><dt><a id="cs-status-207"></a><span class="term">207</span></dt><dd><p>could not create result from database query</p></dd><dt><a id="cs-status-208"></a><span class="term">208</span></dt><dd><p>could not retrieve reference database metadata</p></dd><dt><a id="cs-status-209"></a><span class="term">209</span></dt><dd><p>could not create reference database</p></dd><dt><a id="cs-status-210"></a><span class="term">210</span></dt><dd><p>could not create reference database metadata</p></dd><dt><a id="cs-status-211"></a><span class="term">211</span></dt><dd><p>create t_meta failed</p></dd><dt><a id="cs-status-212"></a><span class="term">212</span></dt><dd><p>create t_refdb failed</p></dd><dt><a id="cs-status-213"></a><span class="term">213</span></dt><dd><p>create t_author failed</p></dd><dt><a id="cs-status-214"></a><span class="term">214</span></dt><dd><p>create t_keyword failed</p></dd><dt><a id="cs-status-215"></a><span class="term">215</span></dt><dd><p>create t_periodical failed</p></dd><dt><a id="cs-status-216"></a><span class="term">216</span></dt><dd><p>create t_note failed</p></dd><dt><a id="cs-status-217"></a><span class="term">217</span></dt><dd><p>create t_user failed</p></dd><dt><a id="cs-status-218"></a><span class="term">218</span></dt><dd><p>create t_xauthor failed</p></dd><dt><a id="cs-status-219"></a><span class="term">219</span></dt><dd><p>create t_xkeyword failed</p></dd><dt><a id="cs-status-220"></a><span class="term">220</span></dt><dd><p>create t_xuser failed</p></dd><dt><a id="cs-status-221"></a><span class="term">221</span></dt><dd><p>create t_xnote failed</p></dd><dt><a id="cs-status-222"></a><span class="term">222</span></dt><dd><p>could not create user group</p></dd><dt><a id="cs-status-223"></a><span class="term">223</span></dt><dd><p>could not grant user permissions</p></dd><dt><a id="cs-status-224"></a><span class="term">224</span></dt><dd><p>access control not supported</p></dd><dt><a id="cs-status-225"></a><span class="term">225</span></dt><dd><p>not a RefDB database</p></dd><dt><a id="cs-status-226"></a><span class="term">226</span></dt><dd><p>database does not exist</p></dd><dt><a id="cs-status-227"></a><span class="term">227</span></dt><dd><p>begin transaction failed</p></dd><dt><a id="cs-status-228"></a><span class="term">228</span></dt><dd><p>cannot lock tables</p></dd><dt><a id="cs-status-229"></a><span class="term">229</span></dt><dd><p>failed to remove keyword</p></dd><dt><a id="cs-status-230"></a><span class="term">230</span></dt><dd><p>failed to remove author</p></dd><dt><a id="cs-status-231"></a><span class="term">231</span></dt><dd><p>failed to remove periodical</p></dd><dt><a id="cs-status-232"></a><span class="term">232</span></dt><dd><p>failed to update main reference data</p></dd><dt><a id="cs-status-233"></a><span class="term">233</span></dt><dd><p>inserting reference data failed</p></dd><dt><a id="cs-status-234"></a><span class="term">234</span></dt><dd><p>select failed</p></dd><dt><a id="cs-status-235"></a><span class="term">235</span></dt><dd><p>database successfully created</p></dd><dt><a id="cs-status-236"></a><span class="term">236</span></dt><dd><p>assume localhost as host</p></dd><dt><a id="cs-status-237"></a><span class="term">237</span></dt><dd><p>grant user permissions successful</p></dd><dt><a id="cs-status-238"></a><span class="term">238</span></dt><dd><p>revoke user permissions successful</p></dd><dt><a id="cs-status-239"></a><span class="term">239</span></dt><dd><p>could not revoke user permissions</p></dd><dt><a id="cs-status-240"></a><span class="term">240</span></dt><dd><p>switched to database</p></dd><dt><a id="cs-status-241"></a><span class="term">241</span></dt><dd><p>failed to access style data</p></dd><dt><a id="cs-status-242"></a><span class="term">242</span></dt><dd><p>create temporary table failed</p></dd><dt><a id="cs-status-243"></a><span class="term">243</span></dt><dd><p>delete temporary table failed</p></dd><dt><a id="cs-status-244"></a><span class="term">244</span></dt><dd><p>incomplete reference data</p></dd><dt><a id="cs-status-245"></a><span class="term">245</span></dt><dd><p>failed to remove note xlink</p></dd><dt><a id="cs-status-246"></a><span class="term">246</span></dt><dd><p>failed to delete main note data</p></dd><dt><a id="cs-status-247"></a><span class="term">247</span></dt><dd><p>failed to remove user</p></dd><dt><a id="cs-status-248"></a><span class="term">248</span></dt><dd><p>failed to delete main reference data</p></dd><dt><a id="cs-status-249"></a><span class="term">249</span></dt><dd><p>failed to delete database</p></dd><dt><a id="cs-status-250"></a><span class="term">250</span></dt><dd><p>could not delete user group</p></dd><dt><a id="cs-status-251"></a><span class="term">251</span></dt><dd><p>database successfully deleted</p></dd><dt><a id="cs-status-252"></a><span class="term">252</span></dt><dd><p>personal interest list is empty</p></dd><dt><a id="cs-status-253"></a><span class="term">253</span></dt><dd><p>failed to detach dataset from user</p></dd><dt><a id="cs-status-254"></a><span class="term">254</span></dt><dd><p>sucessfully detached dataset from user</p></dd><dt><a id="cs-status-255"></a><span class="term">255</span></dt><dd><p>failed to attach dataset to user</p></dd><dt><a id="cs-status-256"></a><span class="term">256</span></dt><dd><p>sucessfully attached dataset to user</p></dd><dt><a id="cs-status-257"></a><span class="term">257</span></dt><dd><p>create t_link failed</p></dd><dt><a id="cs-status-258"></a><span class="term">258</span></dt><dd><p>create t_xlink failed</p></dd><dt><a id="cs-status-259"></a><span class="term">259</span></dt><dd><p>failed to remove ulink</p></dd><dt><a id="cs-status-260"></a><span class="term">260</span></dt><dd><p>failed to update journal names</p></dd><dt><a id="cs-status-261"></a><span class="term">261</span></dt><dd><p>failed to create citation key</p></dd><dt><a id="cs-status-262"></a><span class="term">262</span></dt><dd><p>failed to create personal list</p></dd><dt><a id="cs-status-263"></a><span class="term">263</span></dt><dd><p>successfully created personal list</p></dd><dt><a id="cs-status-264"></a><span class="term">264</span></dt><dd><p>failed to delete personal list</p></dd><dt><a id="cs-status-265"></a><span class="term">265</span></dt><dd><p>successfully deleted personal list</p></dd><dt><a id="cs-status-266"></a><span class="term">266</span></dt><dd><p>personal list not owned by current user</p></dd><dt><a id="cs-status-267"></a><span class="term">267</span></dt><dd><p>personal list does not exist</p></dd><dt><a id="cs-status-268"></a><span class="term">268</span></dt><dd><p>create t_temp_xdup failed</p></dd><dt><a id="cs-status-269"></a><span class="term">269</span></dt><dd><p>style not found</p></dd><dt><a id="cs-status-300"></a><span class="term">300</span></dt><dd><p>void</p></dd><dt><a id="cs-status-301"></a><span class="term">301</span></dt><dd><p>missing argument</p></dd><dt><a id="cs-status-302"></a><span class="term">302</span></dt><dd><p>unknown output format</p></dd><dt><a id="cs-status-400"></a><span class="term">400</span></dt><dd><p>void</p></dd><dt><a id="cs-status-401"></a><span class="term">401</span></dt><dd><p>no more data available</p></dd><dt><a id="cs-status-402"></a><span class="term">402</span></dt><dd><p>finished transferring data</p></dd><dt><a id="cs-status-403"></a><span class="term">403</span></dt><dd><p>chunk added successfully</p></dd><dt><a id="cs-status-404"></a><span class="term">404</span></dt><dd><p>finished transferring dataset</p></dd><dt><a id="cs-status-405"></a><span class="term">405</span></dt><dd><p>finished adding dataset</p></dd><dt><a id="cs-status-406"></a><span class="term">406</span></dt><dd><p>citation key</p></dd><dt><a id="cs-status-407"></a><span class="term">407</span></dt><dd><p>refused to overwrite dataset</p></dd><dt><a id="cs-status-408"></a><span class="term">408</span></dt><dd><p>dataset added successfully</p></dd><dt><a id="cs-status-409"></a><span class="term">409</span></dt><dd><p>numerical id ignored</p></dd><dt><a id="cs-status-410"></a><span class="term">410</span></dt><dd><p>numerical id nonexistent</p></dd><dt><a id="cs-status-411"></a><span class="term">411</span></dt><dd><p>citation key nonexistent</p></dd><dt><a id="cs-status-412"></a><span class="term">412</span></dt><dd><p>ID and citation key missing</p></dd><dt><a id="cs-status-413"></a><span class="term">413</span></dt><dd><p>dataset updated successfully</p></dd><dt><a id="cs-status-414"></a><span class="term">414</span></dt><dd><p>failed to add dataset</p></dd><dt><a id="cs-status-415"></a><span class="term">415</span></dt><dd><p>missing link target</p></dd><dt><a id="cs-status-416"></a><span class="term">416</span></dt><dd><p>incorrect link type</p></dd><dt><a id="cs-status-417"></a><span class="term">417</span></dt><dd><p>dataset not found</p></dd><dt><a id="cs-status-418"></a><span class="term">418</span></dt><dd><p>link already exists</p></dd><dt><a id="cs-status-419"></a><span class="term">419</span></dt><dd><p>dataset removed successfully</p></dd><dt><a id="cs-status-420"></a><span class="term">420</span></dt><dd><p>failed to remove dataset</p></dd><dt><a id="cs-status-421"></a><span class="term">421</span></dt><dd><p>link added successfully</p></dd><dt><a id="cs-status-422"></a><span class="term">422</span></dt><dd><p>only owner can fiddle with dataset</p></dd><dt><a id="cs-status-423"></a><span class="term">423</span></dt><dd><p>dataset is still in use</p></dd><dt><a id="cs-status-424"></a><span class="term">424</span></dt><dd><p>dataset is already attached to user</p></dd><dt><a id="cs-status-425"></a><span class="term">425</span></dt><dd><p>periodical name changed successfully</p></dd><dt><a id="cs-status-426"></a><span class="term">426</span></dt><dd><p>reference type changed</p></dd><dt><a id="cs-status-700"></a><span class="term">700</span></dt><dd><p>void</p></dd><dt><a id="cs-status-701"></a><span class="term">701</span></dt><dd><p>failed to initialize character set conversion</p></dd><dt><a id="cs-status-702"></a><span class="term">702</span></dt><dd><p>character set conversion failed</p></dd><dt><a id="cs-status-703"></a><span class="term">703</span></dt><dd><p>remote administration disabled</p></dd><dt><a id="cs-status-704"></a><span class="term">704</span></dt><dd><p>administration is not restricted</p></dd><dt><a id="cs-status-705"></a><span class="term">705</span></dt><dd><p>administration not permitted</p></dd><dt><a id="cs-status-706"></a><span class="term">706</span></dt><dd><p>administration permitted</p></dd><dt><a id="cs-status-707"></a><span class="term">707</span></dt><dd><p>process ID</p></dd><dt><a id="cs-status-708"></a><span class="term">708</span></dt><dd><p>application server stop submitted</p></dd><dt><a id="cs-status-709"></a><span class="term">709</span></dt><dd><p>set server IP submitted</p></dd><dt><a id="cs-status-710"></a><span class="term">710</span></dt><dd><p>set timeout submitted</p></dd><dt><a id="cs-status-711"></a><span class="term">711</span></dt><dd><p>set logfile submitted</p></dd><dt><a id="cs-status-712"></a><span class="term">712</span></dt><dd><p>set logdest submitted</p></dd><dt><a id="cs-status-713"></a><span class="term">713</span></dt><dd><p>set loglevel submitted</p></dd><dt><a id="cs-status-800"></a><span class="term">800</span></dt><dd><p>void</p></dd><dt><a id="cs-status-801"></a><span class="term">801</span></dt><dd><p>out of memory</p></dd><dt><a id="cs-status-802"></a><span class="term">802</span></dt><dd><p>failed to load cgi templates</p></dd><dt><a id="cs-status-803"></a><span class="term">803</span></dt><dd><p>command partially processed, aborted after unrecoverable error</p></dd><dt><a id="cs-status-804"></a><span class="term">804</span></dt><dd><p>suffix pool exhausted</p></dd><dt><a id="cs-status-805"></a><span class="term">805</span></dt><dd><p>REFNUMBER formatting failed</p></dd><dt><a id="cs-status-806"></a><span class="term">806</span></dt><dd><p>AUTHORLIST formatting failed</p></dd><dt><a id="cs-status-807"></a><span class="term">807</span></dt><dd><p>EDITORLIST formatting failed</p></dd><dt><a id="cs-status-808"></a><span class="term">808</span></dt><dd><p>SEDITORLIST formatting failed</p></dd><dt><a id="cs-status-809"></a><span class="term">809</span></dt><dd><p>PUBDATE formatting failed</p></dd><dt><a id="cs-status-810"></a><span class="term">810</span></dt><dd><p>PUBDATESEC formatting failed</p></dd><dt><a id="cs-status-811"></a><span class="term">811</span></dt><dd><p>TITLE formatting failed</p></dd><dt><a id="cs-status-812"></a><span class="term">812</span></dt><dd><p>BOOKTITLE formatting failed</p></dd><dt><a id="cs-status-813"></a><span class="term">813</span></dt><dd><p>SERIESTITLE formatting failed</p></dd><dt><a id="cs-status-814"></a><span class="term">814</span></dt><dd><p>JOURNALNAME formatting failed</p></dd><dt><a id="cs-status-815"></a><span class="term">815</span></dt><dd><p>VOLUME formatting failed</p></dd><dt><a id="cs-status-816"></a><span class="term">816</span></dt><dd><p>ISSUE formatting failed</p></dd><dt><a id="cs-status-817"></a><span class="term">817</span></dt><dd><p>PAGES formatting failed</p></dd><dt><a id="cs-status-818"></a><span class="term">818</span></dt><dd><p>PUBLISHER formatting failed</p></dd><dt><a id="cs-status-819"></a><span class="term">819</span></dt><dd><p>PUBPLACE formatting failed</p></dd><dt><a id="cs-status-820"></a><span class="term">820</span></dt><dd><p>SERIAL formatting failed</p></dd><dt><a id="cs-status-821"></a><span class="term">821</span></dt><dd><p>ADDRESS formatting failed</p></dd><dt><a id="cs-status-822"></a><span class="term">822</span></dt><dd><p>URL formatting failed</p></dd><dt><a id="cs-status-823"></a><span class="term">823</span></dt><dd><p>USERDEF1 formatting failed</p></dd><dt><a id="cs-status-824"></a><span class="term">824</span></dt><dd><p>USERDEF2 formatting failed</p></dd><dt><a id="cs-status-825"></a><span class="term">825</span></dt><dd><p>USERDEF3 formatting failed</p></dd><dt><a id="cs-status-826"></a><span class="term">826</span></dt><dd><p>USERDEF4 formatting failed</p></dd><dt><a id="cs-status-827"></a><span class="term">827</span></dt><dd><p>USERDEF5 formatting failed</p></dd><dt><a id="cs-status-828"></a><span class="term">828</span></dt><dd><p>MISC1 formatting failed</p></dd><dt><a id="cs-status-829"></a><span class="term">829</span></dt><dd><p>MISC2 formatting failed</p></dd><dt><a id="cs-status-830"></a><span class="term">830</span></dt><dd><p>MISC3 formatting failed</p></dd><dt><a id="cs-status-831"></a><span class="term">831</span></dt><dd><p>LINK1 formatting failed</p></dd><dt><a id="cs-status-832"></a><span class="term">832</span></dt><dd><p>LINK2 formatting failed</p></dd><dt><a id="cs-status-833"></a><span class="term">833</span></dt><dd><p>LINK3 formatting failed</p></dd><dt><a id="cs-status-834"></a><span class="term">834</span></dt><dd><p>LINK4 formatting failed</p></dd><dt><a id="cs-status-835"></a><span class="term">835</span></dt><dd><p>ABSTRACT formatting failed</p></dd><dt><a id="cs-status-836"></a><span class="term">836</span></dt><dd><p>NOTES formatting failed</p></dd><dt><a id="cs-status-837"></a><span class="term">837</span></dt><dd><p>SEPARATOR formatting failed</p></dd><dt><a id="cs-status-838"></a><span class="term">838</span></dt><dd><p>remote administration failed</p></dd><dt><a id="cs-status-839"></a><span class="term">839</span></dt><dd><p>child-&gt;parent communication failure</p></dd><dt><a id="cs-status-840"></a><span class="term">840</span></dt><dd><p>FIFO write error</p></dd><dt><a id="cs-status-841"></a><span class="term">841</span></dt><dd><p>unknown command</p></dd><dt><a id="cs-status-842"></a><span class="term">842</span></dt><dd><p>failed to load style</p></dd><dt><a id="cs-status-999"></a><span class="term">999</span></dt><dd><p>summary</p></dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch23s02.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch23.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="ch23s04.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Basic principles </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> Tools for the client-server protocol</td></tr></table></div></body></html>