JMX_QUERY_NAMES

Use the JMX_QUERY_NAMES script element to list registered MBeans.

Syntax

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

Parameters

Parameter Description Allowed Values Default Value
NAME=

(Optional)

Object name of a particular MBean, or a filter specification for several MBeans. You can use the * and ? wildcard characters, where * stands for any number of characters and ? for exactly one.

Important! JMX-specific rules apply to filters. Wildcards can be used in the domain description and in the properties, provided that the * wildcard 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 of valid filters:

"*:*",

"DefaultDomain:*",

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

n.a. n.a.
NOTFOUND=

(Optional)

Procedure if MBeans could not be found
  • ABORT — The AE job ends abnormally.

  • NORMAL — The AE job continues.

ABORT
MAXROWS=

(Optional)

Maximum number of lines to be listed. The agent supplies all registered MBeans if this parameter is not defined. n.a. n.a.

Examples

The following example lists the registered MBeans in the JMImplementation domain.

JMX_QUERY_NAMES NAME=JMImplementation:*, NOTFOUND=ABORT

See also: