# Package org.apache.catalina.ant.jmx

package org.apache.catalina.ant.jmx

This package contains a set of `JMX Task` implementations for Ant (version 1.6 or later) that can be used to interact with the Remote JMX JSR 160 RMI Adaptor to get/set attributes, invoke MBean operations and query for Mbeans inside a running instance of Tomcat. For more information, see https://tomcat.apache.org/tomcat-11.0-doc/monitoring.html.

Each task element can open a new jmx connection or reference an existing one. The following attribute are exists in every tasks:

Common task attributes
Attribute | Description
--- | ---
url | The JMX Connection URL of the remote Tomcat MBeansServer.
username | The username of an MBeanServer auth, when configured.
password | The password of an MBeanServer auth, when configured.
host | The JMX Connection host.
port | The JMX Connection port.
ref | The name of the ant internal reference for a jmx connection.

NOTE - This Tasks only work, when JSR 160 MBean Adaptor as remote jvm is configured.

- Related Packages
  Package
  Description
  org.apache.catalina.ant
  This package contains a set of `Task` implementations for Ant (version 1.6.x or later) that can be used to interact with the Manager application to deploy, undeploy, list, reload, start and stop web applications from a running instance of Tomcat.
- Classes
  Class
  Description
  Arg
  JMXAccessorCondition
  Definition:
  JMXAccessorConditionBase
  JMXAccessorCreateTask
  Create new MBean at JMX JSR 160 MBeans Server.
  JMXAccessorEqualsCondition
  Definition
  JMXAccessorGetTask
  Access JMX JSR 160 MBeans Server.
  JMXAccessorInvokeTask
  Access JMX JSR 160 MBeans Server.
  JMXAccessorQueryTask
  Query for Mbeans.
  JMXAccessorSetTask
  Access JMX JSR 160 MBeans Server.
  JMXAccessorTask
  Access JMX JSR 160 MBeans Server.
  JMXAccessorUnregisterTask
  unregister an MBean at JMX JSR 160 MBeans Server.