JMX Number

The adapter enables the monitoring of the currently executed Technical 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 which can have integer values between 0 and 899. With such a numeric adapter status you can model more complex case distinctions in Technical Processes.

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.

Properties

Operation

Defines the operation executed by the adapter

Possible values:

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

Parameters

Adapter	Main adapter class (do not change!) Possible values: `de.softproject.integration.adapter. jmxtools.JmxNumberAdapter`: Main class (default)
Objectname	Name of the modified object (checkpoint) Possible values: `de.softproject.x4.jmxnumber: 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: Any integer number between 0 and 899 `1`: Set value `1` to output status `1` (default)
Persistent	Persist value of the JMX Bean Possible values: `True`: Persist value `False`: 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 values

0...899	The MBean property Value has a value between `0` and `899`
-1	Error when invoking JMX (e. g. incompatible MBean)