HP Systems Insight Manager 6.3 Command Line Interface Guide

Description
The mxexec command executes an Systems Insight Manager tool with associated arguments on
specific managed systems and system groups. A tool and its arguments, specified to run on one
or more systems, is called a task. An instance of the task running at a particular time is called a
job.
The first form of the command enables you run Systems Insight Manager tools. The toolname is
required by mxexec to run the tool. In addition, depending upon the tool being run, the argument
values and the targets might also be required. The results returned by the tool can be optionally
saved in one file or a series of files, one per Systems Insight Manager managed system. Additionally,
you can specify the option to suppress the job header information and send the job's standard
output to stdout and the job's standard error to stderr. The option to suppress the job header
information is mutually exclusive with the options to send the job output to a file or directory.
The second form enables you to cancel a specific job (and the command execution optionally
killed). You must be a full rights user or the user that initiated the job can cancel or kill the job.
• mxexec -t toolname [-A argvalue... ] [-h|-O filename|-o directory
] [-n target...|-q queryname... ]
This command enables you to run Systems Insight Manager tools. The toolname is required,
and depending on the tool being run, the argument values and targets might be required.
The results returned by the tool can be saved in a file or a series of files, one per managed
system.
You can specify the option to suppress the job header information and send the job's standard
output to stdout and the job's standard error to stderr. The option to suppress the job
header information is mutually exclusive with the options to send the job output to a file or
directory.
• mxexec -c [-k] -j job_ID
This command enables you to cancel a specific job, and gives you the option to kill the
command execution. Only an administrative rights user or the user who initiated the job can
cancel or kill a job.
• mxexec [-l n|t] [-i task_name...|-j job_ID... ] [-d date ]
mxexec -l d [-h] -j job_ID...
These commands allow you to list information about one or more running jobs. All jobs can
be listed, specific jobs can be listed by job_ID, and all the jobs for a specific task_name
can be listed. Use the -d option to list all jobs completed after a specific date. The date is
specified in the format month/day/year hour:minute AM|PM, and must be enclosed in
quotation marks to ensure that the date specification string is interpreted as a single argument,
including the embedded spaces.
When mxexec is run with no options, it displays a list of the current user's jobs which have
not completed. The capability to display several levels of detail for a specific job is supported.
Any user can view the details for any job.
When viewing job details, you can specify the option to suppress job headers and send the
job output to stdout or stderr.
Tool execution authorization
Systems Insight Manager verifies that the user invoking mxexec is authorized to execute the tool
on the specified managed systems. If the user is not authorized, the command terminates with an
error message that is logged to the Systems Insight Manager log file, and the job is aborted.
32 Command descriptions