JMX_QUERY_NAMES

Use the JMX_QUERY_NAMES script element to list registered MBeans.

Syntax

JMX_QUERY_NAMES [NAME=...] [, NOTFOUND=...] [, MAXROWS=]

Parameters

  • JMX_QUERY_NAMES
    Lists registered MBeans
  • NAME=
    (Optional) Object name of a particular MBean, or filter specification for several MBeans
    You can use the * and ? wildcard characters where * stands for any number of characters and ? for exactly one.
    Important! There are JMX-specific rules to be adhered to when you define filters. Wildcard characters can be used in the domain description. They can also be used in the properties provided that the following rules are adhered to: the wildcard character "*" replaces a complete Property=value pair such as description=Printer. Wildcards must not be used within a property name, or value such as description=*.
  • Examples for valid filters:

    "*:*"
    "DefaultDomain:*"
    "***Domain:description=Printer,*"
    "*:description=Printer,type=laser,*"

  • NOTFOUND=
    (Optional) Procedure if MBeans could not be found
    Allowed values:
    • ABORT (default)
      The AE job ends abnormally
    • NORMAL
      The AE job continues
  • MAXROWS=
    (Optional) Maximum number of lines to be lists. The agent supplies all registered MBeans if this parameter is not defined.

Example

JMX_QUERY_NAMES NAME=JMImplementation:*, NOTFOUND=ABORT

See also: