JMX Switch

The adapter enables the monitoring of the currently executed X4 process with a checkpoint that corresponds to a JMX MBean.

If the checkpoint has been passed, the timestamp of the MBean will be updated. The adapter's return status depends on the MBean property Value. If the corresponding MBean does not exist yet, it will be created. It will receive the current timestamp, and the MBean property Value will be set to the parameter value of Startvalue. Additionally, the adapter enables you to remove an existing checkpoint MBean from the JMX registry.

Note:

JMX Number allows to set an integer value between 0 and 899 instead of a Boolean value. Such a numeric adapter status allows to model more complex case distinctions in X4 processes, see JMX Number.

Properties

Operation

Defines the operation executed by the function adapter

Possible values:

Check: Update timestamp and read MBean value value
Unregister: Remove MBean from the JMX registry

Parameter

Adapter	Main adapter class (do not change!) Possible values: de.softproject.integration. adapter.jmxtools.JmxSwitchAdapter: Main class (Default)
Objectname	Name of the modified object (checkpoint) Possible values: de.softproject.x4.jmxswitch: pid=%PID%,process=%CURRENT_PROCESS%,userid=%USER_ID%: Current process instance (Default) Any valid JMX object name, see http://java.sun.com/javase/6/docs/api/javax/management/ObjectName.html
Startvalue	Default value for the MBean property `Value` Possible values: `True`: Yes (Default) `Nein`: No
Persistent	Persist value of the JMX Bean Possible values: `True`: Persist value `Nein`: Do not persist (Default)

Input

This function adapter accepts any input document and outputs it without any modification.

Output

The output document is equivalent to the input document.

Status value

0	The MBean property `Value` has value `false`
1	The MBean property `Value` has value `true`
-1	Error when invoking JMX (e. g. incompatible MBean)