Automation Engine Script Guide > AE JCL for JMX > JMX_QUERY_NAMES

JMX_QUERY_NAMES

Lists registered MBeans

Syntax

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

Syntax	Description/Format
NAME=	Object name of a particular MBean or filter specification for several MBeans The wildcard characters "" and "?" can be used. "" stands for any number of characters, "?" for exactly one.
NOTFOUND=	Procedure if MBeans were not found Allowed values: "NORMAL" or "ABORT" (default value) "NORMAL" = The AE job continues. "ABORT" = The AE job ends abnormally.
MAXROWS=	Maximum number of lines to be listed The agent supplies all registered MBeans if this parameter has not been specified.

Syntax

Description/Format

NAME=

Object name of a particular MBean or filter specification for several MBeans

The wildcard characters "*" and "?" can be used. "*" stands for any number of characters, "?" for exactly one.

NOTFOUND=

Procedure if MBeans were not found

Allowed values: "NORMAL" or "ABORT" (default value)

"NORMAL" = The AE job continues.
"ABORT" = The AE job ends abnormally.

MAXROWS=

Maximum number of lines to be listed

The agent supplies all registered MBeans if this parameter has not been specified.

Comments

There are JMX-specific rules to be adhered to when specifying 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 (e.g. description=Printer). Wildcards must not be used within a property name or value (e.g. description=*).

Examples for valid filters:

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

Example

JMX_QUERY_NAMES NAME=JMImplementation:*, NOTFOUND=ABORT