HP Systems Insight Manager 7.0 Command Line Interface Guide

Description
The mxexec command executes an Systems Insight Manager tool with associated arguments on
specific managed nodes and node groups. A tool and its arguments, specified to run on one or
more nodes, is called a task. An instance of the task running at a particular time is called a 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
node.
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 nodes. 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.
NOTE: The default location of the log file is /var/opt/mx/logs/mx.log.
A user is authorized to run a tool on a node if all the following are true:
• The user is a valid Systems Insight Manager user (see mxuser(1M)).
• The tool is assigned to a toolbox (see mxtool(1M)).
• The user is authorized to have that toolbox on that node (see mxauth(1M)).
Tool authorization is all or none, meaning that it will fail if the user is not authorized to run the tool
on all nodes in the target list.
36 Command descriptions