JMX interoperability

Start with Version 6.0, WebSphere Application Server implements JMX Version 1.2.

Differences between Version 6.0.x, and Version 6.1 and later

The product supports communication with earlier levels of the server through the SOAP connector. The earlier levels of the server cannot be more than two releases earlier. Version 6 and later servers can communicate with each other through an RMI connector, with one restriction. The javax.management.MBeanInfo class and its subclasses do not interoperate between Version 6.1.02 and version 6.0.2. You will receive a java.lang.IllegalArgumentException exception when attempting to send any instance of these classes between a Version 6.1 and Version 6.0.2. This restriction affects clients that perform the following operations.

• A wsadmin scripting client that tries to perform the following operations, for example in Jacl,:

  $Help attributes MBeanObjectName
  $Help operations MBeanObjectName
  $Help notifications MBeanObjectName

• Any Java client that tries to call:

  com.ibm.websphere.management.AdminClient.getMBeanInfo(ObjectName name);
  com.ibm.websphere.management.AdminService.getMBeanInfo(ObjectName name);
  javax.management.MBeanServer.getMBeanInfo(ObjectName name);

A serialization format mismatch exists between the JMX implementation in Version 6.1 and later and Version 6.0.x releases. When a Version 6.0.x wsadmin script or a Version 6.0.x administrative client tries to retrieve the ModelMBeanInfo interface of a Version 6.1 and later MBean, the expected field names are not found in the deserialized object because of the case difference between the versions. For example, the following wsadmin function does not work when a Version 6.0.x wsadmin script connects to a Version 6.1 and later server:

$Help attributes MBeanObjectName
$Help operations MBeanObjectName
$Help all MBeanObjectName

where MBeanObjectName is a string representation of a Version 6.1 and later MBean Object.

To avoid this problem, set the jmx.serial.form JVM custom property on the JVM custom properties page in the administrative console. Create the custom property by specifying the name value-pair on the Version 6.1 and later Application Server that you are connecting to from a Version 6.0.x client. The field names are forced to lower case to be compatible with what the Version 6.0.x client expects. The lower case field names contradict the JMX specification and compromise interoperability with future versions. Therefore, the recommendation is set this property only when it is absolutely needed in a mixed version environment.

Information	Value
Property name	jmx.serial.form
Data type	string
Value	1.2.0 or 1.2.1

To access the JVM custom properties page, go to:

(zos) Servers > Server Types > WebSphere application servers > server1. Then, under Server Infrastructure, click Java and process management > Process definition > Control > Java virtual machine > Custom properties.

Servers > Server Types > WebSphere application servers > server1. Then, under Server Infrastructure, click Java and process management > Process Definition > Java virtual machine > Custom properties.

Related tasks

Use administrative programs (JMX)