HP Systems Insight Manager 7.2 Command Line Interface Guide

• mxquery -r queryname
mxquery -r -f filename
These commands enable you to remove queries. Only an administrative rights user or the
query owner can remove a query. If you specify a query name that does not exist, HP SIM
notifies you that it cannot remove the query and attempts to remove the next designated query.
Skipping undefined queries does not affect the return value. You can specify queries as a list
of query names, or a query definition file.
• mxquery -e queryname [-x xml]
This command enables you to execute the specified query and display the results. You must
specify the name of an existing query, and you must be authorized to execute the query against
the managed systems that the query targets. See mxauth(1M) for more information about
authorizations.
• mxquery [-l n|t] [queryname...]
This command enables you to list queries or view the definitions of specified queries. With no
qualifiers or -n, mxquery lists the names of all registered queries. With the t option,
mxquery gives a tabular listing showing some attributes of all registered queries. You can
limit the query information by specifying one or more query names.
• mxquery -lf [-b encoding] [-x query [queryname...] ]
This command writes a complete definition (see mxquery(4)) for each query to stdout .
Optionally, you can specify the character encoding of the XML file. The value for the character
encoding must match a valid character encoding. If no encoding is specified, the system
attempts to write the file in the encoding currently defined on the system. See http://
www.iana.org/assignments/character-sets for the list of valid character sets. You can specify
individual queries by specifying a query name; otherwise, all queries in the system are listed.
• mxquery -l cat
This command lists the names of all of the categories that you can add queries to. To add a
query, the query definition must contain a category from this list.
• mxquery -l crit
This command lists the names of criteria that can be specified for a query. Criteria specify the
search values that HP SIM uses when executing a query. Some criteria have a list of defined
values that must be used when specifying that given criteria. This command lists the criteria
name and the query type in which the criteria can be specified.
• mxquery -l mode criterianame
This command lists the operation modes or operators that are valid for a specified criteria.
• mxquery -l val criterianame
This command lists the defined criteria values for the specified criteria. If the specified criteria
does not have defined values, no data is listed.
Option
-a
Add one or more queries specified in a query definition file.
-m
Replace one or more query definitions with the definition in the specified file.
-e
mxquery 91