HP Systems Insight Manager 6.0 Command Line Interface Guide

mxreport [-b encoding ] [-n valid-report-or-category-name ] -l -x [report|category]
Description
The mxreport command enables users with sufficient privileges to run reports, and to add, delete, and list
reports and report categories.
• mxreport -a -f fully-qualified-file-name
This command enables you to add reports if you have sufficient privileges. Report information is provided
in a report definition file (see mxreport(4)).
During an add operation, only reports with names that do not exist in the database are added. If a
duplicate report is detected, it is skipped, and HP SIM adds all non-duplicate reports. Skipping duplicate
reports does not affect the return value.
• mxreport -d existing-report-name
This command enables you to delete a report. You must specify an existing report, and you must be
the report owner or an administrative rights user.
• mxreport -r existing-report-category-name
This command enables you to remove a report category. Only an administrative rights user or the report
owner can remove a report category. HP SIM notifies you if you specify a nonexistent report category
name.
• mxreport -c -f fully-qualified-file-name
This command enables you to create a new report category. The category is defined in an XML file.
You must have the REPORT_MODIFICATION_PRIVILEGE to create a new report category.
• mxreport -e existing-report-name [-n] [-S
existing-system-collection-name-or-comma-separated-nodes-list-when-used-with-option-(n)
] [-E existing-event-collection-name ] [-x HTML|XML|CSV] [-o
fully-qualified-file-name ]
This command runs an existing report.
• The report name is mandatory.
• The -S and -E flags enable you to overwrite the system and event collections in the specified
report by entering an existing collection name and event query.
• If you want to enter a comma-separated list of system names instead of a collection for -S, enter
-n before -S and type the names on the command line. For example, mxreport -e
report_name -n -S "systemname1,systemname2" -E "All Events" -x XML.
• -x specifies the generated report file format. The default is XML.
• -o specifies the output file path. Without this option, the output is displayed in the console.
• You must have the REPORT_VIEW_SECURED_DATA_PRIVILEGE to generate a report that contains
license information.
• mxreport -eCat existing-category-name [-n] -S
existing-system-collectionname-or-comma-separated-nodes-list-when-used-with-option-(n)
[-E existing-event-collection-name ] [-x HTML|XML|CSV] [-o
fully-qualified-file-name ]
This command runs a report from an existing category.
• The category name is mandatory.
• -S is mandatory. If you want to enter a comma-separated list of system names instead of a collection
for -S, enter -n before -S and type the names on the command line.
• Selecting an event query is optional.
• -x specifies the generated report file format. The default is XML.
mxreport 79