Chapter 19. Monitoring and Management

Children: the WSRMSequenceManager that is used by this client.

Container: the container in which the client is deployed---in this case: GlassFish. Note that the actual container object has not been instrumented with monitoring so it Java class@address is printed.

Name: the root name given for this client.

Parent: show the WSClient under the AMX mbean.

qnameToPortInfoMap: an internal map used by the runtime system.

serviceClass: The SEI (service endpoint interface).

serviceName: From the WSDL.

wsdlDocumentLocation: Where the WSDL used to create the client lives. (Note: when a service is created using NetBeans it makes a local copy of the WSDL, therefore the example shows a file instead of an http location.)

wsdlService: an internal data structure that is not instrumented.

Children: in this example there are two other mbeans associated with the example service.

addressingVersion: generally this will be W3C unless explicitly using a different version of addressing.

bindingID: the namespace for the type of binding used for the service.

dumpHTTPMessages: when set to true then HTTP messages received and sent by this service are "dumped" into the log file. It is possible to dynamically set this value. Just click on the value, type in the value and hit return using JConsole. In jmxterm:

$>bean amx:name=ExampleService,pp=/mon/server-mon[server],type=WSEndpoint

$>set dumpHTTPMessages true

features: the "features" (see the Jakarta XML Web Services specification) used in this endpoint. Using jmxterm (assuming the bean has been set as in dump above:

$>get features
features = [ { 
  enabled = true;
  iD = http://www.w3.org/2005/08/addressing/module;
 }, { 
  enabled = true;
  iD = com.sun.xml.ws.rm.ReliableMessagingFeature;
 } ];

jaxwsRuntimeVersion: the version of the Jakarta XML Web Services specification which is implemented by Metro.

policy: A representation of the policy used by the endpoint. The entire policy is more easily viewed using jmxterm: $>get policy. Note: the format of the policy output can and will change.

portName: The WSDL port name.

seiModelWSDLLocation: not currently supported.

serviceDefinitionImports: a list of any of files imported by the main WSDL file for this service.

serviceDefinitionURL: the service's WSDL.

serviceName: The WSDL service name.

soapVersionHttpBindingId: The namespace of the HTTP binding.

wsdlEndpointAddress: this generally will not contain the real address since it depends on a client calling the service to exist and the value is taken before that happens.

wsdlPortTypeName: The WSDL port type.

boundSequences: generally an inbound sequence will be bound to an outbound sequence so that requests and replies are reliable. This table gives the sequence identifiers for those pairs.

concurrentlyOpenedInbound: the number of inbound sequences opened.

persistent: true if using Metro's persistent reliable messaging.

sequences: a map from a sequence identifier to information on that sequence. In jmxterm:

$>bean amx:name=RMSequenceManager,pp=/mon/server-mon[server]/WSEndpoint[ExampleService],type=WSRMSequenceManager

$>get sequences

sequences = { 
  ( uuid:5145de4e-618b-4da3-9004-c715770934d2 ) = { 
    key = uuid:5145de4e-618b-4da3-9004-c715770934d2;
    value = { 
      ackRequested = false;
      boundSecurityTokenReferenceId = null;
      closed = false;
      expired = false;
      hasUnacknowledgedMessages = true;
      id = uuid:5145de4e-618b-4da3-9004-c715770934d2;
      lastActivityTime = 1259880084724;
      lastMessageNumber = 1;
      state = CREATED;
     };
   };
  ( uuid:d16b0fb9-7e80-4598-a3e2-789c9bac9474 ) = { 
    key = uuid:d16b0fb9-7e80-4598-a3e2-789c9bac9474;
    value = { 
      ackRequested = false;
      boundSecurityTokenReferenceId = null;
      closed = false;
      expired = false;
      hasUnacknowledgedMessages = false;
      id = uuid:d16b0fb9-7e80-4598-a3e2-789c9bac9474;
      lastActivityTime = 1259880084724;
      lastMessageNumber = 1;
      state = CREATED;
     };
   };
 };

uniqueEndpointId: An identifier used by the reliable messaging implementation. Note: this is not related to client and endpoint root name identifiers