Java Management Extensions
by J. Steven Perry

The unconfirmed error reports are from readers.  They have not yet been 
approved or disproved by the author or editor and represent solely the
opinion of the reader.

Here's a key to the markup:
        [page-number]: serious technical mistake
        {page-number}: minor technical mistake
        <page-number>: important language/formatting problem
        (page-number): language change or minor formatting problem
        ?page-number?: reader question or request for clarification

This page was updated August 20, 2003.


UNCONFIRMED  errors and comments from readers: 


[X]  9780596002459_examples README file;

I downloaded the examples file and unzipped it.
The README file says:

1. Download and unzip the jmxapp.zip file.

Where is jmxapp.zip?  I searched the ORA site with no success.


{10}  1;
Paragraph 1 correctly states that there is no special model MBean metadata class to
describe parameters, but the following figure 1-4 shows a metadata class labeled
ModelMBeanParameterInfo.  It should be labeled MBeanParameterInfo.


{23}  Source Code Paragraph;
Regarding the Windows .zip source code

The ver 1.0 and 1.1 of the source code contain different zipped directory
hierarchies. This may lead to some confusion as the text in the book appears to be
addressing the 1.0 version of the source, when it says *if you install the source
code to c:\jmxbook*. But as a reader using the 1.1 source it already contains a
directory format with jmxapp as the parent directory.


{24}  Code Example target name="build-exception";

There is no *build-exception* target in the Ant build.xml file. This is a little
confusing, as one has to spend time looking through the source code and directory
hierarchy to validate this.


{26}  First Paragraph;

There is no build-exception target in the Ant build.xml file. And because of this it
makes it difficult for anyone new to Ant to follow the ground work being laid in
understanding target dependencies in Ant.


{29}  2nd paragraph;

The text refers to Fig 1-13 on page 30, and references attribute values in that
figure.

Quote 'after processing 72 units of work (according to the NumberOfItemsProcessed
attribute),' ... However the  NumberOfItemsProcessed in Fig 1-13 is 93.

Quote 'the Supplier Thread has waited a total of 3,421 milliseconds to add items to
the Queue because it was full,' ... I have no idea how this value is derived, nor
which attribute might describe this information. A value 3421 did not appear in Fig
1-13, and so not even a clue was left.


{54}  Last paragraph;
An exception class called GenericException is not included in either the verion 1.0
or 1.1 downloadable source code samples. If fact there is no sample.exception package at all.


(1.3.4)  http://safari.oreilly.com/main.asp?bookname=9780596002459&snode=13, between
Figs 1-15 & 1-16;
Text reads:
We would now expect that activity in the Queue has balanced out somewhat, and we
would expect to start seeing the Supplier wait, as we now have two Consumer threads
at work. Figure 1-16 shows the management view of the Queue after we start the second
Consumer thread.

Explanation of error:
Now that there are two Consumers, we would expect to start seeing the Consumers wait.
Replace the "Supplier wait" with "Consumers wait".


(2.2.7)  http://safari.oreilly.com/main.asp?bookname=9780596002459&snode=16, just before
Fig 2-9;
Text reads:
Notice that there are two domains, Adaptor and JMIplementation

Error correction: change Ip to Imp:
Should be "JMImplementation"


(3.2.1)  http://safari.oreilly.com/main.asp?bookname=9780596002459&snode=22, under
heading "MBeanConstructorInfo":;
Text reads:
MBeanParamaterInfo  should be
MBeanParameterInfo

("mat" becomes "met").


(3.2.1.1)  http://safari.oreilly.com/main.asp?bookname=9780596002459&snode=22, after
table 3-2;
After Table 3-2, the text about the first example says it's
a one-dimensional character array, but:
the "name" in the example is:
"StringArray." It should say "CharacterArray"
The "description" in the example is
"2D String array."  Should be "Character array."

The text for the next example says it's a one-dimensional
double-precision floating point array, but:
the "description" in the example is:
"2D String array."  It should be "Double array."
"2D