HP Systems Insight Manager 5.3 Command Line Interface reference guide

• mxquery -m -f filename
This command allows you to modify the definition of one or more queries. Query information is provided
in a query definition file. When modifying a query, you must be the query owner or a full configuration
rights user.
• mxquery -r queryname
mxquery -r -f filename
These commands allow you to remove queries. Only a full configuration 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 allows 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 allows 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
72 Command descriptions