QPID-8091: [Broker-J] Update transaction timeout chapter in docbook
[qpid-broker-j.git] / doc / java-broker / src / docbkx / Java-Broker-Appendix-Operational-Logging-Messages.xml
1 <?xml version="1.0"?>
2 <!--
3
4 Licensed to the Apache Software Foundation (ASF) under one
5 or more contributor license agreements. See the NOTICE file
6 distributed with this work for additional information
7 regarding copyright ownership. The ASF licenses this file
8 to you under the Apache License, Version 2.0 (the
9 "License"); you may not use this file except in compliance
10 with the License. You may obtain a copy of the License at
11
12 http://www.apache.org/licenses/LICENSE-2.0
13
14 Unless required by applicable law or agreed to in writing,
15 software distributed under the License is distributed on an
16 "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
17 KIND, either express or implied. See the License for the
18 specific language governing permissions and limitations
19 under the License.
20
21 -->
22
23 <appendix xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="Java-Broker-Appendix-Operation-Logging">
24 <title>Operational Logging</title>
25
26 <para>The Broker will, by default, produce structured log messages in response to key events in
27 the lives of objects within the Broker. These concise messages are designed to allow the user to
28 understand the actions of the Broker in retrospect. This is valuable for problem diagnosis and
29 provides a useful audit trail.</para>
30 <para>Each log message includes details of the entity causing the action (e.g. a management user
31 or messaging client connection), the entity receiving the action (e.g. a queue or connection)
32 and a description of operation itself.</para>
33 <para>The log messages have the following format:</para>
34 <screen>
35 [<literal>Actor</literal>] {[<literal>Subject</literal>]} [<literal>Message Id</literal>] [<literal>Message Text</literal>]
36 </screen>
37 <para>Where:</para>
38 <itemizedlist>
39 <listitem>
40 <para><literal>Actor</literal> is the entity within the Broker that is
41 <emphasis>performing</emphasis> the action. There are actors corresponding to the Broker
42 itself, Management, Connection, and Channels. Their format is described in the <link linkend="Java-Broker-Appendix-Operation-Logging-Actor-Format">table</link> below.</para>
43 </listitem>
44 <listitem>
45 <para><literal>Subject</literal> (optional) is the entity within the Broker that is
46 <emphasis>receiving</emphasis> the action. There are subjects corresponding to the
47 Connections, Channels, Queues, Exchanges, Subscriptions, and Message Stores. Their format is
48 described in the <link linkend="Java-Broker-Appendix-Operation-Logging-Subject-Format">table</link> below.</para>
49 <para>Some actions are reflexive, in these cases the Actor and Subject will be equal.</para>
50 </listitem>
51 <listitem>
52 <para><literal>Message Id</literal> is an identifier for the type of message. It has the form
53 three alphas and four digits separated by a hyphen <literal>AAA-9999</literal>.</para>
54 </listitem>
55 <listitem>
56 <para><literal>Message Text</literal> is a textual description</para>
57 </listitem>
58 </itemizedlist>
59 <para>To illustrate, let's look at two examples.</para>
60 <para><literal><link linkend="Java-Broker-Appendix-Operation-Logging-Message-CON-1001">CON-1001</link></literal> is used when a messages client makes an AMQP connection. The
61 connection actor (<literal>con</literal>) provides us with details of the peer's connection: the
62 user id used by the client (myapp1), their IP, ephemeral port number and the name of the virtual
63 host. The message text itself gives us further details about the connection: the client id, the
64 protocol version in used, and details of the client's qpid library.</para>
65 <screen>[con:8(myapp1@/127.0.0.1:52851/default)] CON-1001 : Open : Destination : AMQP(127.0.0.1:5672) :
66 Protocol Version : 0-10 : Client ID : myapp1 : Client Version : ${project.version} : Client Product : qpid</screen>
67 <para><literal><link linkend="Java-Broker-Appendix-Operation-Logging-Message-QUE-1001">QUE-1001</link></literal> is used when a queue is created. The connection actor
68 <literal>con</literal> tells us details of the connection performing the queue creation: the
69 user id used by the client (myapp1), the IP, ephemeral port number and the name of the virtual
70 host. The queue subject tells use the queue's name (myqueue) and the virtualhost. The message
71 itself tells us more information about the queue that is being created. </para>
72
73 <screen>[con:8(myapp1@/127.0.0.1:52851/default)/ch:0] [vh(/default)/qu(myqueue)] QUE-1001 : Create : Owner: myapp1 Transient</screen>
74 <para>The first two tables that follow describe the actor and subject entities, then the later
75 provide a complete catalogue of all supported messages.</para>
76 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Actor-Format">
77 <title>Actors Entities</title>
78 <tgroup cols="2">
79 <thead>
80 <row>
81 <entry>Actor Type</entry>
82 <entry>Format and Purpose</entry>
83 </row>
84 </thead>
85 <tbody>
86 <row>
87 <entry morerows="1">Broker</entry>
88 <entry>[Broker]</entry>
89 </row>
90 <row>
91 <entry>
92 <para>Used during startup and shutdown</para>
93 </entry>
94 </row>
95 <row>
96 <entry morerows="1">Management</entry>
97 <entry>
98 [mng:<replaceable>userid</replaceable>(<replaceable>clientip</replaceable>:<replaceable>ephemeralport</replaceable>)] </entry>
99
100 </row>
101 <row>
102 <entry>
103 <para>Used for operations performed by the Web Management interfaces.</para>
104 </entry>
105 </row>
106 <row>
107 <entry morerows="1">Connection</entry>
108 <entry>
109 [con:<replaceable>connectionnumber</replaceable>(<replaceable>userid</replaceable>@/<replaceable>clientip</replaceable>:<replaceable>ephemeralport</replaceable>/<replaceable>virtualhostname</replaceable>)]</entry>
110 </row>
111 <row>
112 <entry>
113 <para>Used for operations performed by a client connection. Note that connections are
114 numbered by a sequence number that begins at 1.</para>
115 </entry>
116 </row>
117 <row>
118 <entry morerows="1">Channel</entry>
119 <entry>
120 [con:<replaceable>connectionnumber</replaceable>(<replaceable>userid</replaceable>@/<replaceable>clientip</replaceable>:<replaceable>ephemeralport</replaceable>/<replaceable>virtualhostname</replaceable>/ch:<replaceable>channelnumber</replaceable>)]</entry>
121 </row>
122 <row>
123 <entry>
124 <para>Used for operations performed by a client's channel (corresponds to the JMS
125 concept of Session). Note that channels are numbered by a sequence number that is
126 scoped by the owning connection.</para>
127 </entry>
128 </row>
129 <row>
130 <entry morerows="1">Group</entry>
131 <entry> [grp(/<replaceable>groupname</replaceable>)/vhn(/<replaceable>virtualhostnode
132 name</replaceable>)]</entry>
133 </row>
134 <row>
135 <entry>
136 <para>Used for HA. Used for operations performed by the system itself often as a result
137 of actions performed on another node..</para>
138 </entry>
139 </row>
140 </tbody>
141 </tgroup>
142 </table>
143 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Subject-Format">
144 <title>Subject Entities</title>
145 <tgroup cols="2">
146 <thead>
147 <row>
148 <entry>Subject Type</entry>
149 <entry>Format and Purpose</entry>
150 </row>
151 </thead>
152 <tbody>
153 <row>
154 <entry morerows="1">Connection</entry>
155 <entry>
156 [con:<replaceable>connectionnumber</replaceable>(<replaceable>userid</replaceable>@/<replaceable>clientip</replaceable>:<replaceable>ephemeralport</replaceable>/<replaceable>virtualhostname</replaceable>)]</entry>
157 </row>
158 <row>
159 <entry>
160 <para>A connection to the Broker.</para>
161 </entry>
162 </row>
163 <row>
164 <entry morerows="1">Channel</entry>
165 <entry>
166 [con:<replaceable>connectionnumber</replaceable>(<replaceable>userid</replaceable>@/<replaceable>clientip</replaceable>:<replaceable>ephemeralport</replaceable>/<replaceable>virtualhostname</replaceable>/ch:<replaceable>channelnumber</replaceable>)]</entry>
167 </row>
168 <row>
169 <entry>
170 <para>A client's channel within a connection.</para>
171 </entry>
172 </row>
173 <row>
174 <entry morerows="1">Subscription</entry>
175 <entry>
176 [sub:<replaceable>subscriptionnumber</replaceable>(vh(/<replaceable>virtualhostname</replaceable>)/qu(<replaceable>queuename</replaceable>)]</entry>
177 </row>
178 <row>
179 <entry>
180 <para>A subscription to a queue. This corresponds to the JMS concept of a
181 Consumer.</para>
182 </entry>
183 </row>
184 <row>
185 <entry morerows="1">Queue</entry>
186 <entry>[vh(/<replaceable>virtualhostname</replaceable>)/qu(<replaceable>queuename</replaceable>)]</entry>
187 </row>
188 <row>
189 <entry>
190 <para>A queue on a virtualhost</para>
191 </entry>
192 </row>
193 <row>
194 <entry morerows="1">Exchange</entry>
195 <entry>[vh(/<replaceable>virtualhostname</replaceable>)/ex(<replaceable>exchangetype</replaceable>/<replaceable>exchangename</replaceable>)]</entry>
196 </row>
197 <row>
198 <entry>
199 <para>An exchange on a virtualhost</para>
200 </entry>
201 </row>
202 <row>
203 <entry morerows="1">Binding</entry>
204 <entry>
205 [vh(/<replaceable>virtualhostname</replaceable>)/ex(<replaceable>exchangetype</replaceable>/<replaceable>exchangename</replaceable>)/qu(<replaceable>queuename</replaceable>)/rk(<replaceable>bindingkey</replaceable>)]</entry>
206 </row>
207 <row>
208 <entry>
209 <para>A binding between a queue and exchange with the giving binding key.</para>
210 </entry>
211 </row>
212 <row>
213 <entry morerows="1">Message Store</entry>
214 <entry>
215 [vh(/<replaceable>virtualhostname</replaceable>)/ms(<replaceable>messagestorename</replaceable>)]</entry>
216 </row>
217 <row>
218 <entry>
219 <para>A virtualhost/message store on the Broker.</para>
220 </entry>
221 </row>
222 <row>
223 <entry morerows="1">HA Group</entry>
224 <entry> [grp(/<replaceable>group name</replaceable>)]</entry>
225 </row>
226 <row>
227 <entry>
228 <para>A HA group</para>
229 </entry>
230 </row>
231 </tbody>
232 </tgroup>
233 </table>
234 <para>The following tables lists all the operation log messages that can be produced by the
235 Broker, and the describes the circumstances under which each may be seen.</para>
236
237 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Broker">
238 <title>Broker Log Messages</title>
239 <tgroup cols="2">
240 <thead>
241 <row>
242 <entry>Message Id</entry>
243 <entry>Message Text / Purpose</entry>
244 </row>
245 </thead>
246 <tbody>
247 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1001">
248 <entry morerows="1">BRK-1001</entry>
249 <entry>Startup : Version: <replaceable>version</replaceable> Build:
250 <replaceable>build</replaceable>
251 </entry>
252 </row>
253 <row>
254 <entry>
255 <para>Indicates that the Broker is starting up</para>
256 </entry>
257 </row>
258 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1002">
259 <entry morerows="1">BRK-1002</entry>
260 <entry>Starting : Listening on <replaceable>transporttype</replaceable> port
261 <replaceable>portnumber</replaceable>
262 </entry>
263 </row>
264 <row>
265 <entry>
266 <para>Indicates that the Broker has begun listening on a port.</para>
267 </entry>
268 </row>
269 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1003">
270 <entry morerows="1">BRK-1003</entry>
271 <entry>Shutting down : <replaceable>transporttype</replaceable> port
272 <replaceable>portnumber</replaceable>
273 </entry>
274 </row>
275 <row>
276 <entry>
277 <para>Indicates that the Broker has stopped listening on a port.</para>
278 </entry>
279 </row>
280 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1004">
281 <entry morerows="1">BRK-1004</entry>
282 <entry>Qpid Broker Ready</entry>
283 </row>
284 <row>
285 <entry>
286 <para>Indicates that the Broker is ready for normal operations.</para>
287 </entry>
288 </row>
289 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1005">
290 <entry morerows="1">BRK-1005</entry>
291 <entry>Stopped</entry>
292 </row>
293 <row>
294 <entry>
295 <para>Indicates that the Broker is stopped.</para>
296 </entry>
297 </row>
298 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1006">
299 <entry morerows="1">BRK-1006</entry>
300 <entry>Using configuration : <replaceable>file</replaceable>
301 </entry>
302 </row>
303 <row>
304 <entry>
305 <para>Indicates the name of the configuration store in use by the Broker.</para>
306 </entry>
307 </row>
308 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1008">
309 <entry morerows="1">BRK-1008</entry>
310 <entry><replaceable>delivered|received</replaceable> : <replaceable>size</replaceable>
311 kB/s peak : <replaceable>size</replaceable> bytes total</entry>
312 </row>
313 <row>
314 <entry>
315 <para>Statistic - bytes delivered or received by the Broker.</para>
316 </entry>
317 </row>
318 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1009">
319 <entry morerows="1">BRK-1009</entry>
320 <entry><replaceable>delivered|received</replaceable> : <replaceable>size</replaceable>
321 msg/s peak : <replaceable>size</replaceable> msgs total</entry>
322 </row>
323 <row>
324 <entry>
325 <para>Statistic - messages delivered or received by the Broker.</para>
326 </entry>
327 </row>
328 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1010">
329 <entry morerows="1">BRK-1010</entry>
330 <entry>Platform : JVM : <replaceable>vendor</replaceable> version: <replaceable>version
331 </replaceable> OS : <replaceable>operating system vendor</replaceable> version:
332 <replaceable>operating system version</replaceable>} arch: <replaceable>processor
333 architecture</replaceable> cores: <replaceable>number of CPU cores</replaceable></entry>
334 </row>
335 <row>
336 <entry>
337 <para>Key information about the environment hosting the Broker</para>
338 </entry>
339 </row>
340 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1011">
341 <entry morerows="1">BRK-1011</entry>
342 <entry>Maximum Memory : Heap : <replaceable>size</replaceable> bytes Direct : <replaceable>
343 bytes</replaceable> size</entry></row>
344 <row>
345 <entry>
346 <para>Configured memory paramters for the Broker.</para>
347 </entry>
348 </row>
349 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1012">
350 <entry morerows="1">BRK-1012</entry>
351 <entry>Management Mode : User Details : <replaceable>management node user id</replaceable> /
352 <replaceable>management mode password</replaceable></entry>
353 </row>
354 <row>
355 <entry>
356 <para>Used when Broker is started in management mode to indicate the
357 management credentials that may be used connect to the Broker.</para>
358 </entry>
359 </row>
360 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1016">
361 <entry morerows="1">BRK-1016</entry>
362 <entry>Fatal error : <replaceable>root cause</replaceable> : See log file for more information</entry>
363 </row>
364 <row>
365 <entry>
366 <para>Indicates that broker was shut down due to fatal error.</para>
367 </entry>
368 </row>
369 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1017">
370 <entry morerows="1">BRK-1017</entry>
371 <entry>Process : PID <replaceable>process identifier</replaceable></entry>
372 </row>
373 <row>
374 <entry>
375 <para>Process identifier (PID) of the Broker process.</para>
376 </entry>
377 </row>
378 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BRK-1018">
379 <entry morerows="1">BRK-1018</entry>
380 <entry>Operation : <replaceable>operation name</replaceable></entry>
381 </row>
382 <row>
383 <entry>
384 <para>Indicates that the named operation has been invoked</para>
385 </entry>
386 </row>
387 </tbody>
388 </tgroup>
389 </table>
390
391 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Management">
392 <title>Management Log Messages</title>
393 <tgroup cols="2">
394 <thead>
395 <row>
396 <entry>Message Id</entry>
397 <entry>Message Text / Purpose</entry>
398 </row>
399 </thead>
400 <tbody>
401 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1001">
402 <entry morerows="1">MNG-1001</entry>
403 <entry><replaceable>type</replaceable> Management Startup </entry>
404 </row>
405 <row>
406 <entry>
407 <para>Indicates that a Management plugin is starting up. Supported by Web management plugin.</para>
408 </entry>
409 </row>
410 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1002">
411 <entry morerows="1">MNG-1002</entry>
412 <entry>Starting : <replaceable>type</replaceable> : Listening on <replaceable>transporttype</replaceable> port
413 <replaceable>port</replaceable>
414 </entry>
415 </row>
416 <row>
417 <entry>
418 <para>Indicates that a Management plugin is listening on the given port.</para>
419 </entry>
420 </row>
421 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1003">
422 <entry morerows="1">MNG-1003</entry>
423 <entry>Shutting down : <replaceable>type</replaceable> : port
424 <replaceable>port</replaceable></entry>
425 </row>
426 <row>
427 <entry>
428 <para>Indicates that a Management plugin is ceasing to listen on the given port.</para>
429 </entry>
430 </row>
431 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1004">
432 <entry morerows="1">MNG-1004</entry>
433 <entry><replaceable>type</replaceable> Management Ready</entry>
434 </row>
435 <row>
436 <entry>
437 <para>Indicates that a Management plugin is ready for work.</para>
438 </entry>
439 </row>
440 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1005">
441 <entry morerows="1">MNG-1005</entry>
442 <entry><replaceable>type</replaceable> Management Stopped</entry>
443 </row>
444 <row>
445 <entry>
446 <para>Indicates that a Management plugin is stopped.</para>
447 </entry>
448 </row>
449 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1007">
450 <entry morerows="1">MNG-1007</entry>
451 <entry>Open : User <replaceable>username</replaceable></entry>
452 </row>
453 <row>
454 <entry>
455 <para>Indicates the opening of a connection to Management has by the given
456 username.</para>
457 </entry>
458 </row>
459 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MNG-1008">
460 <entry morerows="1">MNG-1008</entry>
461 <entry>Close : User <replaceable>username</replaceable></entry>
462 </row>
463 <row>
464 <entry>
465 <para>Indicates the closing of a connection to Management has by the given
466 username.</para>
467 </entry>
468 </row>
469 </tbody>
470 </tgroup>
471 </table>
472
473 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-VirtualHost">
474 <title>Virtual Host Log Messages</title>
475 <tgroup cols="2">
476 <thead>
477 <row>
478 <entry>Message Id</entry>
479 <entry>Message Text / Purpose</entry>
480 </row>
481 </thead>
482 <tbody>
483 <!-- Virtual host -->
484 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1001">
485 <entry morerows="1">VHT-1001</entry>
486 <entry>Created : <replaceable>virtualhostname</replaceable></entry>
487 </row>
488 <row>
489 <entry>
490 <para>Indicates that a virtualhost has been created.</para>
491 </entry>
492 </row>
493 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1002">
494 <entry morerows="1">VHT-1002</entry>
495 <entry>Closed</entry>
496 </row>
497 <row>
498 <entry>
499 <para>Indicates that a virtualhost has been closed. This occurs on Broker
500 shutdown.</para>
501 </entry>
502 </row>
503 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1005">
504 <entry morerows="1">VHT-1005</entry>
505 <entry>Unexpected fatal error</entry>
506 </row>
507 <row>
508 <entry>
509 <para>Virtualhost has suffered an unexpected fatal error, check the logs for more
510 details.</para>
511 </entry>
512 </row>
513 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1006">
514 <entry morerows="1">VHT-1006</entry>
515 <entry>Filesystem is over <replaceable>size in %</replaceable> per cent full, enforcing flow control.</entry>
516 </row>
517 <row>
518 <entry>
519 <para>Indicates that virtual host flow control is activated
520 when the usage of file system containing Virtualhost message store exceeded predefined limit.</para>
521 </entry>
522 </row>
523 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1007">
524 <entry morerows="1">VHT-1007</entry>
525 <entry>Filesystem is no longer over <replaceable>size in %</replaceable> per cent full.</entry>
526 </row>
527 <row>
528 <entry>
529 <para>Indicates that virtual host flow control is deactivated
530 when the usage of file system containing Virtualhost message falls under predefined limit.</para>
531 </entry>
532 </row>
533 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-VHT-1008">
534 <entry morerows="1">VHT-1008</entry>
535 <entry>Operation : <replaceable>operation name</replaceable></entry>
536 </row>
537 <row>
538 <entry>
539 <para>Indicates that the named operation has been invoked</para>
540 </entry>
541 </row>
542 </tbody>
543 </tgroup>
544 </table>
545 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Queue">
546 <title>Queue Log Messages</title>
547 <tgroup cols="2">
548 <thead>
549 <row>
550 <entry>Message Id</entry>
551 <entry>Message Text / Purpose</entry>
552 </row>
553 </thead>
554 <tbody>
555 <!-- Queue -->
556 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1001">
557 <entry morerows="1">QUE-1001</entry>
558 <entry>Create : Owner: <replaceable>owner</replaceable>
559 <replaceable>AutoDelete</replaceable> [<replaceable>Durable</replaceable>]
560 <replaceable>Transient</replaceable> Priority:
561 <replaceable>numberofpriorities</replaceable></entry>
562 </row>
563 <row>
564 <entry>
565 <para>Indicates that a queue has been created.</para>
566 </entry>
567 </row>
568 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1002">
569 <entry morerows="1">QUE-1002</entry>
570 <entry>Deleted</entry>
571 </row>
572 <row>
573 <entry>
574 <para>Indicates that a queue has been deleted.</para>
575 </entry>
576 </row>
577 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1003">
578 <entry morerows="1">QUE-1003</entry>
579 <entry>
580 Overfull : Size : <replaceable>size in bytes</replaceable>, Capacity : <replaceable>resumesize in bytes</replaceable>,
581 Messages : <replaceable>size in messages</replaceable>, Message Capacity : <replaceable>resumesize in messages</replaceable>
582 </entry>
583 </row>
584 <row>
585 <entry>
586 <para>Indicates that a queue has exceeded its permitted capacity when
587 <emphasis>Producer Flow Control</emphasis> overflow policy is used.
588 See <xref linkend="Java-Broker-Concepts-Queue-OverflowPolicy"/> for details.</para>
589 </entry>
590 </row>
591 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1004">
592 <entry morerows="1">QUE-1004</entry>
593 <entry>
594 Underfull : Size : <replaceable>size in bytes</replaceable>, Capacity : <replaceable>resumesize in bytes</replaceable>,
595 Messages : <replaceable>size in messages</replaceable>, Message Capacity : <replaceable>resumesize in messages</replaceable>
596 </entry>
597 </row>
598 <row>
599 <entry>
600 <para>
601 Indicates that a queue has fallen to its resume capacity when
602 <emphasis>Producer Flow Control</emphasis> overflow policy is used.
603 See <xref linkend="Java-Broker-Concepts-Queue-OverflowPolicy"/> for details.
604 </para>
605 </entry>
606 </row>
607 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1004">
608 <entry morerows="1">QUE-1005</entry>
609 <entry>
610 Dropped : <replaceable>number</replaceable> messages, Depth : <replaceable>size</replaceable> bytes,
611 <replaceable>size</replaceable> messages, Capacity : <replaceable>limit</replaceable> bytes,
612 <replaceable>limit</replaceable> messages
613 </entry>
614 </row>
615 <row>
616 <entry>
617 <para>
618 Indicates that a given number of messages is deleted when <emphasis>Ring</emphasis> overflow policy is
619 used and any of queue capacity limits is breached .
620 See <xref linkend="Java-Broker-Concepts-Queue-OverflowPolicy"/> for details.
621 </para>
622 </entry>
623 </row>
624 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-QUE-1016">
625 <entry morerows="1">QUE-1016</entry>
626 <entry>Operation : <replaceable>operation name</replaceable></entry>
627 </row>
628 <row>
629 <entry>
630 <para>Indicates that the named operation has been invoked</para>
631 </entry>
632 </row>
633 </tbody>
634 </tgroup>
635 </table>
636 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Exchange">
637 <title>Exchange Log Messages</title>
638 <tgroup cols="2">
639 <thead>
640 <row>
641 <entry>Message Id</entry>
642 <entry>Message Text / Purpose</entry>
643 </row>
644 </thead>
645 <tbody>
646 <!-- Exchange -->
647 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-EXH-1001">
648 <entry morerows="1">EXH-1001</entry>
649 <entry>Create : [<replaceable>Durable</replaceable>] Type: <replaceable>type</replaceable>
650 Name: <replaceable>exchange name</replaceable></entry>
651 </row>
652 <row>
653 <entry>
654 <para>Indicates that an exchange has been created.</para>
655 </entry>
656 </row>
657 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-EXH-1002">
658 <entry morerows="1">EXH-1002</entry>
659 <entry>Deleted</entry>
660 </row>
661 <row>
662 <entry>
663 <para>Indicates that an exchange has been deleted.</para>
664 </entry>
665 </row>
666 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-EXH-1003">
667 <entry morerows="1">EXH-1003</entry>
668 <entry>Discarded Message : Name: <replaceable>exchange name</replaceable> Routing Key:
669 <replaceable>routing key</replaceable></entry>
670 </row>
671 <row>
672 <entry>
673 <para>Indicates that an exchange received a message that could not be routed to at least
674 one queue. queue has exceeded its permitted capacity. See <xref linkend="Java-Broker-Concepts-Exchanges-UnroutableMessage"/> for details.</para>
675 </entry>
676 </row>
677 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-EXH-1004">
678 <entry morerows="1">EXH-1004</entry>
679 <entry>Operation : <replaceable>operation name</replaceable></entry>
680 </row>
681 <row>
682 <entry>
683 <para>Indicates that the named operation has been invoked</para>
684 </entry>
685 </row>
686 </tbody>
687 </tgroup>
688 </table>
689
690 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Binding">
691 <title>Binding Log Messages</title>
692 <tgroup cols="2">
693 <thead>
694 <row>
695 <entry>Message Id</entry>
696 <entry>Message Text / Purpose</entry>
697 </row>
698 </thead>
699 <tbody>
700 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BND-1001">
701 <entry morerows="1">BND-1001</entry>
702 <entry>Create : Arguments : <replaceable>arguments</replaceable></entry>
703 </row>
704 <row>
705 <entry>
706 <para>Indicates that a binding has been made between an exchange and a queue.</para>
707 </entry>
708 </row>
709 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-BND-1002">
710 <entry morerows="1">BND-1002</entry>
711 <entry>Deleted</entry>
712 </row>
713 <row>
714 <entry>
715 <para>Indicates that a binding has been deleted</para>
716 </entry>
717 </row>
718
719 </tbody>
720 </tgroup>
721 </table>
722
723 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Connection">
724 <title>Connection Log Messages</title>
725 <tgroup cols="2">
726 <thead>
727 <row>
728 <entry>Message Id</entry>
729 <entry>Message Text / Purpose</entry>
730 </row>
731 </thead>
732 <tbody>
733 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1001">
734 <entry morerows="1">CON-1001</entry>
735 <entry>Open : Destination : <replaceable>target port</replaceable> : Protocol Version :
736 <replaceable>protocol version</replaceable> : Client ID : <replaceable>clientid</replaceable> :
737 Client Version : <replaceable>client version</replaceable> :
738 Client Product : <replaceable>client product</replaceable></entry>
739 </row>
740 <row>
741 <entry>
742 <para>Indicates that a connection has been opened. The Broker logs one of these message
743 each time it learns more about the client as the connection is negotiated.</para>
744 </entry>
745 </row>
746 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1002">
747 <entry morerows="1">CON-1002</entry>
748 <entry>Close</entry>
749 </row>
750 <row>
751 <entry>
752 <para>Indicates that a connection has been closed. This message is logged regardless of
753 if the connection is closed normally, or if the connection is somehow lost e.g network
754 error. </para>
755 </entry>
756 </row>
757 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1003">
758 <entry morerows="1">CON-1003</entry>
759 <entry>Closed due to inactivity</entry>
760 </row>
761 <row>
762 <entry>
763 <para>Used when heart beating is in-use. Indicates that the connection has not received
764 a heartbeat for too long and is therefore closed as being inactive. </para>
765 </entry>
766 </row>
767 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1004">
768 <entry morerows="1">CON-1004</entry>
769 <entry>Connection dropped</entry>
770 </row>
771 <row>
772 <entry>
773 <para>Indicates that a connection has been unexpectedly closed by the peer. This usually
774 occurs if a machine hosting an application fails or the application's process is
775 abruptly terminated.</para>
776 </entry>
777 </row>
778 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1005">
779 <entry morerows="1">CON-1005</entry>
780 <entry>Client version <replaceable>version</replaceable> logged by validation</entry>
781 </row>
782 <row>
783 <entry>
784 <para>Indicates that a connection has been received from client with a version number
785 that is configured to be logged. This feature may help teams manage software currency.</para>
786 </entry>
787 </row>
788 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1006">
789 <entry morerows="1">CON-1006</entry>
790 <entry>Client version <replaceable>version</replaceable> rejected by validation</entry>
791 </row>
792 <row>
793 <entry>
794 <para>Indicates that a connection attempt has been received from client with a version number
795 that is configured to be rejected. This feature may help manage software currency.</para>
796 </entry>
797 </row>
798 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1007">
799 <entry morerows="1">CON-1007</entry>
800 <entry>Connection close initiated by operator</entry>
801 </row>
802 <row>
803 <entry>
804 <para>Indicates that a connection has been closed by the actions of an
805 Operator using manangement.</para>
806 </entry>
807 </row>
808 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1009">
809 <entry morerows="1">CON-1009</entry>
810 <entry>Uncommitted transaction(s) contains <replaceable>size</replaceable> bytes of incoming message data
811 exceeding <replaceable>size</replaceable> bytes limit. Messages will be flowed to disk.</entry>
812 </row>
813 <row>
814 <entry>
815 <para>Warns that the transactions associated with this connection contain so much uncommitted data that
816 a threshold has been breached. The connection responds by flowing the messages already associated with the
817 transactions and any new messages to disk. The connection reverts to normal behaviour once the
818 quantity of uncommitted data falls beneath the threshold. Normally this happens when the transactions
819 commit or rollback.
820 </para>
821 </entry>
822 </row>
823 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1010">
824 <entry morerows="1">CON-1010</entry>
825 <entry>Open Transaction : <replaceable>time</replaceable> ms</entry>
826 </row>
827 <row>
828 <entry>
829 <para>Indicates that a messaging transaction has been open for longer than that
830 permitted. See <xref linkend="Java-Broker-Runtime-Transaction-Timeout"/> for
831 more details.</para>
832 </entry>
833 </row>
834 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CON-1011">
835 <entry morerows="1">CON-1011</entry>
836 <entry>Idle Transaction : <replaceable>time</replaceable> ms</entry>
837 </row>
838 <row>
839 <entry>
840 <para>Indicates that a messaging transaction has been idle for longer than that
841 permitted. See <xref linkend="Java-Broker-Runtime-Transaction-Timeout"/> for
842 more details.</para>
843 </entry>
844 </row>
845
846
847 </tbody>
848 </tgroup>
849 </table>
850
851
852 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Channel">
853 <title>Channel Log Messages</title>
854 <tgroup cols="2">
855 <thead>
856 <row>
857 <entry>Message Id</entry>
858 <entry>Message Text / Purpose</entry>
859 </row>
860 </thead>
861 <tbody>
862 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1001">
863 <entry morerows="1">CHN-1001</entry>
864 <entry>Create</entry>
865 </row>
866 <row>
867 <entry>
868 <para>Indicates that a channel (corresponds to the JMS concept of Session) has been
869 created.</para>
870 </entry>
871 </row>
872 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1002">
873 <entry morerows="1">CHN-1002</entry>
874 <entry>Flow Started</entry>
875 </row>
876 <row>
877 <entry>
878 <para>Indicates message flow to a session has begun.</para>
879 </entry>
880 </row>
881 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1003">
882 <entry morerows="1">CHN-1003</entry>
883 <entry>Close</entry>
884 </row>
885 <row>
886 <entry>
887 <para>Indicates that a channel has been closed.</para>
888 </entry>
889 </row>
890 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1004">
891 <entry morerows="1">CHN-1004</entry>
892 <entry>Prefetch Size (bytes) <replaceable>size</replaceable> : Count <replaceable>number
893 of messages</replaceable></entry>
894 </row>
895 <row>
896 <entry>
897 <para>Indicates the prefetch size in use by a channel.</para>
898 </entry>
899 </row>
900 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1005">
901 <entry morerows="1">CHN-1005</entry>
902 <entry>Flow Control Enforced (Queue <replaceable>queue name</replaceable>)</entry>
903 </row>
904 <row>
905 <entry>
906 <para>Indicates that producer flow control has been imposed on a channel owning to
907 excessive queue depth in the indicated queue. Produces using the channel will be
908 requested to pause the sending of messages.
909 See <xref linkend="Java-Broker-Concepts-Queue-OverflowPolicy"/> for more details.</para>
910 </entry>
911 </row>
912 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1006">
913 <entry morerows="1">CHN-1006</entry>
914 <entry>Flow Control Removed</entry>
915 </row>
916 <row>
917 <entry>
918 <para>Indicates that producer flow control has been removed from a channel.
919 See <xref linkend="Java-Broker-Concepts-Queue-OverflowPolicy"/> for more details.</para>
920 </entry>
921 </row>
922 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1009">
923 <entry morerows="1">CHN-1009</entry>
924 <entry>Discarded message : <replaceable>message number</replaceable> as no alternate
925 exchange configured for queue : <replaceable>queue name</replaceable>{1} routing key :
926 <replaceable>routing key</replaceable></entry>
927 </row>
928 <row>
929 <entry>
930 <para>Indicates that a channel has discarded a message as the maximum delivery count has
931 been exceeded but the queue defines no alternate exchange. See <xref linkend="Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count"/> for more details. Note that <replaceable>message number</replaceable> is an
932 internal message reference.</para>
933 </entry>
934 </row>
935 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1010">
936 <entry morerows="1">CHN-1010</entry>
937 <entry>Discarded message : <replaceable>message number</replaceable> as no binding on
938 alternate exchange : <replaceable>exchange name</replaceable></entry>
939 </row>
940 <row>
941 <entry>
942 <para>Indicates that a channel has discarded a message as the maximum delivery count has
943 been exceeded but the queue's alternate exchange has no binding to a queue. See <xref linkend="Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count"/> for more details. Note that <replaceable>message number</replaceable> is an
944 internal message reference.</para>
945 </entry>
946 </row>
947 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1011">
948 <entry morerows="1">CHN-1011</entry>
949 <entry>Message : <replaceable>message number</replaceable> moved to dead letter queue :
950 <replaceable>queue name</replaceable></entry>
951 </row>
952 <row>
953 <entry>
954 <para>Indicates that a channel has moved a message to the named dead letter queue
955 </para>
956 </entry>
957 </row>
958 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1012">
959 <entry morerows="1">CHN-1012</entry>
960 <entry>Flow Control Ignored. Channel will be closed.</entry>
961 </row>
962 <row>
963 <entry>
964 <para>Indicates that a channel violating the imposed flow control has been closed
965 </para>
966 </entry>
967 </row>
968 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CHN-1014">
969 <entry morerows="1">CHN-1014</entry>
970 <entry>Operation : <replaceable>operation name</replaceable></entry>
971 </row>
972 <row>
973 <entry>
974 <para>Indicates that the named operation has been invoked</para>
975 </entry>
976 </row>
977 </tbody>
978 </tgroup>
979 </table>
980 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Subscription">
981 <title>Subscription Log Messages</title>
982 <tgroup cols="2">
983 <thead>
984 <row>
985 <entry>Message Id</entry>
986 <entry>Message Text / Purpose</entry>
987 </row>
988 </thead>
989 <tbody>
990 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-SUB-1001">
991 <entry morerows="1">SUB-1001</entry>
992 <entry>Create : [<replaceable>Durable</replaceable>] Arguments :
993 <replaceable>arguments</replaceable></entry>
994 </row>
995 <row>
996 <entry>
997 <para>Indicates that a subscription (corresponds to JMS concept of a MessageConsumer)
998 has been created.</para>
999 </entry>
1000 </row>
1001 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-SUB-1002">
1002 <entry morerows="1">SUB-1002</entry>
1003 <entry>Close</entry>
1004 </row>
1005 <row>
1006 <entry>
1007 <para>Indicates that a subscription has been closed.</para>
1008 </entry>
1009 </row>
1010 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-SUB-1003">
1011 <entry morerows="1">SUB-1003</entry>
1012 <entry>SUB-1003 : Suspended for <replaceable>time</replaceable> ms</entry>
1013 </row>
1014 <row>
1015 <entry>
1016 <para>Indicates that a subscription has been in a suspened state for an unusual length
1017 of time. This may be indicative of an consuming application that has stopped taking
1018 messages from the consumer (i.e. a JMS application is not calling receive() or its
1019 asynchronous message listener onMessage() is blocked in application code). It may also
1020 indicate a generally overloaded system.
1021 </para>
1022 </entry>
1023 </row>
1024 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-SUB-1004">
1025 <entry morerows="1">SUB-1004</entry>
1026 <entry>Operation : <replaceable>operation name</replaceable></entry>
1027 </row>
1028 <row>
1029 <entry>
1030 <para>Indicates that the named operation has been invoked</para>
1031 </entry>
1032 </row>
1033 </tbody>
1034 </tgroup>
1035 </table>
1036
1037 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-MessageStore">
1038 <title>Message Store Log Messages</title>
1039 <tgroup cols="2">
1040 <thead>
1041 <row>
1042 <entry>Message Id</entry>
1043 <entry>Message Text / Purpose</entry>
1044 </row>
1045 </thead>
1046 <tbody>
1047 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1001">
1048 <entry morerows="1">MST-1001</entry>
1049 <entry>Created</entry>
1050 </row>
1051 <row>
1052 <entry>
1053 <para>Indicates that a message store has been created. The message store is responsible
1054 for the storage of the messages themselves, including the message body and any
1055 headers.</para>
1056 </entry>
1057 </row>
1058 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1002">
1059 <entry morerows="1">MST-1002</entry>
1060 <entry>Store location : <replaceable>path</replaceable></entry>
1061 </row>
1062 <row>
1063 <entry>
1064 <para>Indicates that the message store is using <replaceable>path</replaceable> for the
1065 location of the message store.</para>
1066 </entry>
1067 </row>
1068 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1003">
1069 <entry morerows="1">MST-1003</entry>
1070 <entry>Closed</entry>
1071 </row>
1072 <row>
1073 <entry>
1074 <para>Indicates that the message store has been closed.</para>
1075 </entry>
1076 </row>
1077 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1004">
1078 <entry morerows="1">MST-1004</entry>
1079 <entry>Recovery Start</entry>
1080 </row>
1081 <row>
1082 <entry>
1083 <para>Indicates that message recovery has begun.</para>
1084 </entry>
1085 </row>
1086 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1005">
1087 <entry morerows="1">MST-1005</entry>
1088 <entry>Recovered <replaceable>number of messages</replaceable> messages.</entry>
1089 </row>
1090 <row>
1091 <entry>
1092 <para>Indicates that recovery recovered the given number of messages from the
1093 store.</para>
1094 </entry>
1095 </row>
1096 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1006">
1097 <entry morerows="1">MST-1006</entry>
1098 <entry>Recovered Complete</entry>
1099 </row>
1100 <row>
1101 <entry>
1102 <para>Indicates that the message recovery is concluded.</para>
1103 </entry>
1104 </row>
1105 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1007">
1106 <entry morerows="1">MST-1007</entry>
1107 <entry>Store Passivated</entry>
1108 </row>
1109 <row>
1110 <entry>
1111 <para>The store is entering a passive state where is it unavailable for normal
1112 operations. Currently this message is used by HA when the node is in replica
1113 state.</para>
1114 </entry>
1115 </row>
1116 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1008">
1117 <entry morerows="1">MST-1008</entry>
1118 <entry>Store overfull, flow control will be enforced</entry>
1119 </row>
1120 <row>
1121 <entry>
1122 <para>The store has breached is maximum configured size.
1123 See <xref linkend="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control"/> for details.</para>
1124 </entry>
1125 </row>
1126 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-1009">
1127 <entry morerows="1">MST-1009</entry>
1128 <entry>Store overfull condition cleared</entry>
1129 </row>
1130 <row>
1131 <entry>
1132 <para>The store size has fallen beneath its resume capacity and therefore flow control
1133 has been rescinded. See <xref linkend="Java-Broker-Runtime-Disk-Space-Management-Producer-Flow-Control"/>
1134 for details. </para>
1135 </entry>
1136 </row>
1137 </tbody>
1138 </tgroup>
1139 </table>
1140
1141 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-TransactionStore">
1142 <title>Transaction Store Log Messages</title>
1143 <tgroup cols="2">
1144 <thead>
1145 <row>
1146 <entry>Message Id</entry>
1147 <entry>Message Text / Purpose</entry>
1148 </row>
1149 </thead>
1150 <tbody>
1151 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1001">
1152 <entry morerows="1">TXN-1001</entry>
1153 <entry>Created</entry>
1154 </row>
1155 <row>
1156 <entry>
1157 <para>Indicates that a transaction store has been created. The transaction store is
1158 responsible for the storage of messages instances, that is, the presence of a message
1159 on a queue.</para>
1160 </entry>
1161 </row>
1162 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1002">
1163 <entry morerows="1">TXN-1002</entry>
1164 <entry>Store location : <replaceable>path</replaceable></entry>
1165 </row>
1166 <row>
1167 <entry>
1168 <para>Indicates that the transaction store is using <replaceable>path</replaceable> for
1169 the location of the store.</para>
1170 </entry>
1171 </row>
1172 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1003">
1173 <entry morerows="1">TXN-1003</entry>
1174 <entry>Closed</entry>
1175 </row>
1176 <row>
1177 <entry>
1178 <para>Indicates that the transaction store has been closed.</para>
1179 </entry>
1180 </row>
1181 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1004">
1182 <entry morerows="1">TXN-1004</entry>
1183 <entry>Recovery Start</entry>
1184 </row>
1185 <row>
1186 <entry>
1187 <para>Indicates that transaction recovery has begun.</para>
1188 </entry>
1189 </row>
1190 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-MST-TXN">
1191 <entry morerows="1">TXN-1005</entry>
1192 <entry>Recovered <replaceable>number</replaceable> messages for queue
1193 <replaceable>name</replaceable>.</entry>
1194 </row>
1195 <row>
1196 <entry>
1197 <para>Indicates that recovery recovered the given number of message instances for the
1198 given queue.</para>
1199 </entry>
1200 </row>
1201 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-TXN-1006">
1202 <entry morerows="1">TXN-1006</entry>
1203 <entry>Recovered Complete</entry>
1204 </row>
1205 <row>
1206 <entry>
1207 <para>Indicates that the message recovery is concluded.</para>
1208 </entry>
1209 </row>
1210 </tbody>
1211 </tgroup>
1212 </table>
1213
1214 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-ConfigurationStore">
1215 <title>Configuration Store Log Messages</title>
1216 <tgroup cols="2">
1217 <thead>
1218 <row>
1219 <entry>Message Id</entry>
1220 <entry>Message Text / Purpose</entry>
1221 </row>
1222 </thead>
1223 <tbody>
1224 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1001">
1225 <entry morerows="1">CFG-1001</entry>
1226 <entry>Created</entry>
1227 </row>
1228 <row>
1229 <entry>
1230 <para>Indicates that a configuration store has been created. The configuration store is
1231 responsible for the storage of the definition of objects such as queues, exchanges,
1232 and bindings.</para>
1233 </entry>
1234 </row>
1235 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1002">
1236 <entry morerows="1">CFG-1002</entry>
1237 <entry>Store location : <replaceable>path</replaceable></entry>
1238 </row>
1239 <row>
1240 <entry>
1241 <para>Indicates that the configuration store is using <replaceable>path</replaceable>
1242 for the location of the store.</para>
1243 </entry>
1244 </row>
1245 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1003">
1246 <entry morerows="1">CFG-1003</entry>
1247 <entry>Closed</entry>
1248 </row>
1249 <row>
1250 <entry>
1251 <para>Indicates that the configuration store has been closed.</para>
1252 </entry>
1253 </row>
1254 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1004">
1255 <entry morerows="1">CFG-1004</entry>
1256 <entry>Recovery Start</entry>
1257 </row>
1258 <row>
1259 <entry>
1260 <para>Indicates that configuration recovery has begun.</para>
1261 </entry>
1262 </row>
1263 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-CFG-1005">
1264 <entry morerows="1">CFG-1005</entry>
1265 <entry>Recovered Complete</entry>
1266 </row>
1267 <row>
1268 <entry>
1269 <para>Indicates that the configuration recovery is concluded.</para>
1270 </entry>
1271 </row>
1272 </tbody>
1273 </tgroup>
1274 </table>
1275
1276 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-HA">
1277 <title>HA Log Messages</title>
1278 <tgroup cols="2">
1279 <thead>
1280 <row>
1281 <entry>Message Id</entry>
1282 <entry>Message Text / Purpose</entry>
1283 </row>
1284 </thead>
1285 <tbody>
1286 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1001">
1287 <entry morerows="1">HA-1001</entry>
1288 <entry>Created</entry>
1289 </row>
1290 <row>
1291 <entry>
1292 <para>This HA node has been created.</para>
1293 </entry>
1294 </row>
1295 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1002">
1296 <entry morerows="1">HA-1002</entry>
1297 <entry>Deleted</entry>
1298 </row>
1299 <row>
1300 <entry>
1301 <para>This HA node has been deleted</para>
1302 </entry>
1303 </row>
1304 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1003">
1305 <entry morerows="1">HA-1003</entry>
1306 <entry>Added : Node : '<replaceable>name</replaceable>'
1307 (<replaceable>host:port</replaceable>)</entry>
1308 </row>
1309 <row>
1310 <entry>
1311 <para>A new node has been added to the group.</para>
1312 </entry>
1313 </row>
1314 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1004">
1315 <entry morerows="1">HA-1004</entry>
1316 <entry>Removed : Node : '<replaceable>name</replaceable>'
1317 (<replaceable>host:port</replaceable>)</entry>
1318 </row>
1319 <row>
1320 <entry>
1321 <para>The node has been removed from the group. This removal is permanent.</para>
1322 </entry>
1323 </row>
1324 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1005">
1325 <entry morerows="1">HA-1005</entry>
1326 <entry>Joined : Node : '<replaceable>name</replaceable>'
1327 (<replaceable>host:port</replaceable>)</entry>
1328 </row>
1329 <row>
1330 <entry>
1331 <para>The node has become reachable. This may be as a result of the node being
1332 restarted, or a network problem may have been resolved.</para>
1333 </entry>
1334 </row>
1335 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1006">
1336 <entry morerows="1">HA-1006</entry>
1337 <entry>Left : Node : '<replaceable>name</replaceable>'
1338 (<replaceable>host:port</replaceable>)</entry>
1339 </row>
1340 <row>
1341 <entry>
1342 <para>The node is no longer reachable. This may be as a result of the node being stopped
1343 or a network partition may be preventing it from being connected. The node is still a
1344 member of the group.</para>
1345 </entry>
1346 </row>
1347 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1007">
1348 <entry morerows="1">HA-1007</entry>
1349 <entry>HA-1007 : Master transfer requested : to '<replaceable>name</replaceable>'
1350 (<replaceable>host:port</replaceable>)</entry>
1351 </row>
1352 <row>
1353 <entry>
1354 <para>Indicates that a master transfer operation has been requested.</para>
1355 </entry>
1356 </row>
1357 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1008">
1358 <entry morerows="1">HA-1008</entry>
1359 <entry>HA-1008 : Intruder detected : Node '<replaceable>name</replaceable>'
1360 (<replaceable>host:port</replaceable>)</entry>
1361 </row>
1362 <row>
1363 <entry>
1364 <para>Indicates that an unexpected node has joined the group. The virtualhost node will
1365 go into the ERROR state in response to the condition.</para>
1366 </entry>
1367 </row>
1368 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1009">
1369 <entry morerows="1">HA-1009</entry>
1370 <entry>HA-1009 : Insufficient replicas contactable</entry>
1371 </row>
1372 <row>
1373 <entry>
1374 <para>This node (which was in the master role) no longer has sufficient replica in
1375 contact in order to complete transactions.</para>
1376 </entry>
1377 </row>
1378 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1010">
1379 <entry morerows="1">HA-1010</entry>
1380 <entry>HA-1010 : Role change reported: Node : '<replaceable>name</replaceable>'
1381 (<replaceable>host:port</replaceable>) : from <replaceable>role</replaceable> to
1382 <replaceable>role</replaceable></entry>
1383 </row>
1384 <row>
1385 <entry>
1386 <para>Indicates that the node has changed role within the group.</para>
1387 </entry>
1388 </row>
1389 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1011">
1390 <entry morerows="1">HA-1011</entry>
1391 <entry>HA-1011 : Minimum group size : <replaceable>new group size</replaceable></entry>
1392 </row>
1393 <row>
1394 <entry>
1395 <para>The quorum requirements from completing elections or transactions has been
1396 changed.</para>
1397 </entry>
1398 </row>
1399 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1012">
1400 <entry morerows="1">HA-1012</entry>
1401 <entry>HA-1012 : Priority : <replaceable>priority</replaceable></entry>
1402 </row>
1403 <row>
1404 <entry>
1405 <para>The priority of the object node has been changed. Zero indicates that the node
1406 cannot be elected master.</para>
1407 </entry>
1408 </row>
1409 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1013">
1410 <entry morerows="1">HA-1013</entry>
1411 <entry>HA-1013 : Designated primary : <replaceable>true|false</replaceable></entry>
1412 </row>
1413 <row>
1414 <entry>
1415 <para>This node has been designated primary and can now operate solo. Applies to two
1416 node groups only. See <xref linkend="Java-Broker-High-Availability-Behaviour-DesignatedPrimary"/></para>
1417 </entry>
1418 </row>
1419 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-HA-1014">
1420 <entry morerows="1">HA-1014</entry>
1421 <entry>HA-1014 : Diverged transactions discarded</entry>
1422 </row>
1423 <row>
1424 <entry>
1425 <para>This node is in the process of rejoining the group but has discovered that some
1426 of its transactions differ from those of the current master. The node will
1427 automatically roll-back (i.e. discard) the diverging transactions in order to be
1428 allowed to rejoin the group. This situation can only usually occur as a result of use
1429 of the weak durability options. These allow the group to operate with fewer than
1430 quorum nodes and therefore allow the inconsistencies to develop. </para>
1431 <para>On encountering this condition, it is <emphasis>strongly</emphasis> recommendend
1432 to run an application level reconcilation to determine the data that has been
1433 lost.</para>
1434 </entry>
1435 </row>
1436
1437 </tbody>
1438 </tgroup>
1439 </table>
1440
1441 <table pgwide="1" xml:id="Java-Broker-Appendix-Operation-Logging-Message-List-Port">
1442 <title>Port Log Messages</title>
1443 <tgroup cols="2">
1444 <thead>
1445 <row>
1446 <entry>Message Id</entry>
1447 <entry>Message Text / Purpose</entry>
1448 </row>
1449 </thead>
1450 <tbody>
1451 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1001">
1452 <entry morerows="1">PRT-1001</entry>
1453 <entry>Create</entry>
1454 </row>
1455 <row>
1456 <entry>
1457 <para>Port has been created.</para>
1458 </entry>
1459 </row>
1460 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1002">
1461 <entry morerows="1">PRT-1002</entry>
1462 <entry>Open</entry>
1463 </row>
1464 <row>
1465 <entry>
1466 <para>Port has been open</para>
1467 </entry>
1468 </row>
1469 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1003">
1470 <entry morerows="1">PRT-1003</entry>
1471 <entry>Close</entry>
1472 </row>
1473 <row>
1474 <entry>
1475 <para>Port has been closed</para>
1476 </entry>
1477 </row>
1478 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1004">
1479 <entry morerows="1">PRT-1004</entry>
1480 <entry>Connection count <replaceable>number</replaceable> within <replaceable>warn limit</replaceable> % of maximum <replaceable>limit</replaceable>
1481 </entry>
1482 </row>
1483 <row>
1484 <entry>
1485 <para>Warns that number of open connections approaches maximum allowed limit</para>
1486 </entry>
1487 </row>
1488 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1005">
1489 <entry morerows="1">PRT-1005</entry>
1490 <entry>Connection from <replaceable>peer</replaceable> rejected. Maximum connection count (<replaceable>limit</replaceable>) for this port already reached.</entry>
1491 </row>
1492 <row>
1493 <entry>
1494 <para>Connection from given host is rejected because of reaching the maximum allowed limit</para>
1495 </entry>
1496 </row>
1497 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1007">
1498 <entry morerows="1">PRT-1007</entry>
1499 <entry>Unsupported protocol header received, replying with <replaceable>AMQP version</replaceable></entry>
1500 </row>
1501 <row>
1502 <entry>
1503 <para>Ususualy indicates an attempt to make an non-AMQP connection on an AMQP port, for instance,
1504 with a web browser.</para>
1505 </entry>
1506 </row>
1507 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1008">
1508 <entry morerows="1">PRT-1008</entry>
1509 <entry>Connection from <replaceable>address</replaceable> rejected</entry>
1510 </row>
1511 <row>
1512 <entry>
1513 <para>Incoming connection is rejected because the port's connection limits are
1514 already reached.</para>
1515 </entry>
1516 </row>
1517 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1009">
1518 <entry morerows="1">PRT-1009</entry>
1519 <entry>FAILED to bind <replaceable>name</replaceable> service to <replaceable>port number</replaceable></entry>
1520 </row>
1521 <row>
1522 <entry>
1523 <para>The given port number could not be bound because it is already in-use.</para>
1524 </entry>
1525 </row>
1526 <row xml:id="Java-Broker-Appendix-Operation-Logging-Message-PRT-1010">
1527 <entry morerows="1">PRT-1010</entry>
1528 <entry>Operation : <replaceable>operation name</replaceable></entry>
1529 </row>
1530 <row>
1531 <entry>
1532 <para>Indicates that the named operation has been invoked</para>
1533 </entry>
1534 </row>
1535 </tbody>
1536 </tgroup>
1537 </table>
1538
1539 </appendix>