'); $("#tabs").tabs({ selected: 1 }); $("#ic-homepage__ic-tips").append( quickTipHTML() ); unhideOneProductTip(); $("#ic-homepage__product-tips").wrapInner('
'); $("#ic-homepage__feed-tips").wrapInner('
'); });
IBM Tivoli Monitoring > Version 6.3 > User's Guides > Agent Builder User's Guide > Monitor Java Management Extensions (JMX) MBeans > JMX monitors IBM Tivoli Monitoring, Version 6.3
JMX operations
In addition to providing monitoring data when requested, some MBeans also provide operations.
Agents that have JMX data sources include the JMX_INVOKETake Action command that you can use to run JMX operations against the server you are monitoring.
Take Action command syntax
The action has the following syntax:
JMX_INVOKE [MBean pattern] [Operation name] [Argument 1] [Argument 2] [Argument 3] [Argument 4]Where:
- MBean pattern
- MBean query that selects the MBeans on which the operation runs. If the pattern matches more than one MBean, the operation runs on each of the matched MBeans.
- Operation name
- Name of the MBean operation to run.
- Argument 1, Argument 2, Argument 3, Argument 4
- Optional arguments that can be provided to the MBean operation. Arguments must be a simple data type such as a string or an integer.
The JMX invoke Take Action command returns success if the operation is successfully run. If the operation returns a value, that value is written to the JMX data provider log file.
Example: Start an operation to reset a counter
This action runs the resetPeakThreadCount operation on the Threading MBeans:
JMX_INVOKE [*:type=Threading,*] [resetPeakThreadCount][] [] [] []Where:
- *:type=Threading,*
- MBean Pattern: This pattern matches all MBeans that have a type of Threading.
- resetPeakThreadCount
- Operation name: The operation that is run on every MBean that matches the pattern.
- [] [] [] []
- Argument 1, 2, 3, 4: The arguments are not needed for this operation. They are specified only to comply with the syntax of the action.
Example: Start an action with an argument
This action runs the getThreadCpuTime operation on the Threading MBeans. The result is logged to the JMX data provider trace file.
JMX_INVOKE [*:type=Threading,*] [getThreadCpuTime] [1] [] [] []Where:
- *:type=Threading,*
- MBean Pattern: This pattern matches all MBeans that have a type of Threading
- getThreadCpuTime
- Operation name: The operation that is run on every MBean that matches the pattern.
- 1
- Argument 1: The thread id that is being queried.
- [] [] []
- Argument 2, 3, 4: These arguments are not needed for this operation. They are specified as empty arguments to comply with the Take Action command syntax.
Run the JMX_INVOKE Take Action command
The agent developer cannot expect the user to run the JMX_INVOKE Take Action command. Instead, more actions must be developed that run the JMX_INVOKE Take Action. If possible in these actions, hide the details such as the operation name and the MBean pattern from the user.
Parent topic:
JMX monitors