HP Systems Insight Manager 5.3 Command Line Interface reference guide

Description
mxexec 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 allows 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 allows you to cancel a specific job, and gives you the option to kill the command
execution. Only a full configuration 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
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)).
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.
Default target node influence on tool
The value of the default targets tool attribute defTargets allows different tool execution behaviors if no
targets are specified on the command line. The following table describes the behavior of tool execution for
all values of defTargets if no target list is specified on the command line:
Use all of the user's authorized nodes as the target list.ALL
The CMS is the only node in the target list.CMS
Error. A target list must be specified.[empty]
30 Command descriptions