C-LANG Statements › ATTRIBUTESFILTER Statement—Specify the Attribute Notifications to Subscribe to

ATTRIBUTESFILTER Statement—Specify the Attribute Notifications to Subscribe to

The ATTRIBUTESFILTER statement specifies a list of attribute notifications to subscribe to in a JMX-MBean Subscribe job. A JMX-MBean Subscribe job can monitor an MBean for a single notification or monitor continuously for notifications. You can use the ATTRIBUTESFILTER statement to filter the notifications by attribute. For example, you can use the ATTRIBUTESFILTER statement to monitor when attributes change.

Supported Job Type

This statement is optional for the JMX-MBean Subscribe job type.

Syntax

This statement has the following format:

ATTRIBUTESFILTER attribute|'attribute,attribute...'

attribute

Identifies an attribute to monitor for change.

Limits: Case-sensitive

Notes:

• Enclose value that contain delimiters (such as spaces) in single quotation marks.
• In a list, enclose values that contain commas in single quotes.
• The entire value can be to 1024 characters.
• In a JMX-MBean Subscribe job, you can specify the ATTRIBUTESFILTER statement or the TYPESFILTER statement, but not both. If you do not specify either statement, the job will subscribe to all notifications for the MBean.

Example: Monitor for Changes to a Specific MBean Attribute Using a Filter

Suppose that you want to set up continuous monitoring for changes to the cachesize attribute of the MBean named Config. The job filters the notifications the MBean sends by attribute. Each time the cachesize attribute changes, an alert named CHGA is sent.

AGENT APPAGENT
URL service:jmx:rmi:///jndi/rmi://localhost:9999/server
MBEAN 'DefaultDomain:index=1,type=Config' CONTINUOUS(CHGA)
ATTRIBUTESFILTER cachesize