HP Systems Insight Manager 7.2 Command Line Interface Guide

mxexec -c [-k] -j job_ID
mxexec [-l n|t] [-i task_id... ] [|-j job_ID... ] [-d date ]
mxexec -l d [-h] -j job_ID...
Description
The mxexec command executes an HP SIM 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 HP SIM 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 id...|-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
HP SIM 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 HP SIM 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 HP SIM 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)).
36 Command descriptions