A.12.5 QUERY

Searches for Oracle Stream Analytics MBeans where the pattern matches the pattern that you specify according to the ObjectName class conventions at: http://docs.oracle.com/javase/1.5.0/docs/api/javax/management/ObjectName.html.

All MBeans that are created from an Oracle Stream Analytics MBean type are registered in the MBean Server under a name that conforms to the ObjectName class conventions. You must know the ObjectName of an MBean to use wlevs.Admin commands to retrieve or modify specific MBean instances.

The output of the command follows:

{MBeanName object-name {property1 value} {property2 value}. . .} 
. . .

The properties and values are expressed as name-value pairs, each of which is returned within curly brackets. This format facilitates parsing of the output by a script.

If -pretty is specified, each property-value pair is displayed on a new line and curly brackets are not used to separate the pairs:

MBeanName: object-name
property1: value
property2: value
.
.
.
MBeanName: object-name
property1: value
abbribute2: value

Syntax

java wlevs.Admin 
    [ Connection Arguments ]
    [ User Credentials Arguments ]
    [ Common Arguments ] 
    QUERY -pretty -pattern object-name-pattern 

Table A-17 QUERY Arguments

Argument Definition
-pretty 

Places property-value pairs on separate lines.

-pattern object-name-pattern

A partial http://java.sun.com/j2se/1.5.0/docs/api/javax/management/ObjectName.html for which the QUERY command searches. The value must conform to the following pattern:

property-list

where property-list specifies one or more components (property-value pairs) of a http://java.sun.com/j2se/1.5.0/docs/api/javax/management/ObjectName.html.

You can specify these property-value pairs in any order.

Within a given naming property-value pair, there is no pattern matching. Only complete property-value pairs are used in pattern matching. However, you can use the * wildcard character in the place of one or more property-value pairs.

For example, type=epl* is not valid, but type=CQLProcessor,* is valid.

If you provide at least one property-value pair in the property-list, you can locate the wildcard anywhere in the given pattern, provided that the property-list is still a comma-separated list.

Example

The following example searches for all com.bea.wlevs.management.configuration.CQLProcessorMBean MBeans:

java wlevs.Admin 
     -url service:jmx:msarmi://localhost:9002/jndi/jmxconnector 
     -username wlevs -password wlevs 
     QUERY -pattern *:Type=CQLProcessor,*

If the command succeeds, it returns the attributes of the MBeans found (lines broken here for readability):

{MBeanName="com.bea.wlevs:Name=MonitorProcessor,Type=CQLProcessor,Application=com.bea.wlevs.dataservices"{
 AllRules=defaultRule = select * from DSMonitorEvent retain 1 event where metric > 10000}{
 AllRulesInfo=defaultRule = {RULE_TYPE=RULE, STARTED=true, VALUE=select * from DSMonitorEvent 
 retain 1 event where metric > 10000, ID=defaultRule}}{Databases=}{Name=MonitorProcessor}
 {NotificationInfo=[Ljavax.management.MBeanNotificationInfo;@20d319}
 {ObjectName=com.bea.wlevs:Name=MonitorProcessor,Type=CQLProcessor,
 Application=com.bea.wlevs.dataservices}{PlaybackConfiguration=}{PlayingBack=false}
 {RecordConfiguration=}{RecordPlayback=com.bea.wlevs:Name=MonitorProcessor,
 Type=RecordPlayback,Application=com.bea.wlevs.dataservices}{Recording=false}
 {Type=CQLProcessor}}