HP Systems Insight Manager 6.0 Command Line Interface Guide

as to manage other jobs running within HP SIM. For a full description of the mxexec command, see the
mxexec man page.
To run a tool, enter:
# mxexec –t tool[-u signinuser ] [-p elevationpassword ] [–A arg ...] [–h |
–O file | –o dir] [–n target ... | –q query]
The only required argument is –t tool, where tool is the name of the tool to execute. The –A option is
used to pass required arguments to the tool. The arguments are passed to the tool in the order they appear
in the command, so the first argument in the command is the first tool argument, and so on. Any argument
not being provided is identified by quotes (“”).
The –h, -O, and –o options control the output of the running job, and are mutually exclusive.
• The –h option suppresses the job information headers and sends job output directly to stdout and stderr
as appropriate.
• The –O option directs all stdout and stderr output to the file. If the command cannot create the file in
the specified path location, HP SIM attempts to open the file in /var/tmp. If that fails, all tool output
is sent to stdout. The –o option creates one result file for each target system in the directory dir. The
result file contains both stdout and stderr data, and has a file name that looks like nodename.job_ID().
• The –n and –q options control the target systems and system groups that the tool will run on, and are
mutually exclusive.
• Use the –n option when you specify the target system names and system group names on the
command line. To specify a system group, preface the system group name with the prefix, g:.
• Use the –q option to specify the name of a collection to use to generate the target system list.
The mxexec command verifies that the user executing the command is authorized to run the selected
tool on the target systems. If not, a message is logged in the HP SIM audit log
(/var/opt/mx/logs/mx.log), sent to stderr, and the job is aborted.
To cancel a specific job, enter:
# mxexec –c [–k] –j job_ID
This command cancels the job with ID job_ID. The effects of job cancellation depend on the state of the job.
A job can be in one of four states:
• Pending—Nothing has started.
• Copying files— Entered if there are files to copy as part of the tool execution.
• Running—Entered if there is a command line to execute as part of the tool execution.
• Complete—The job is complete and results are made available by the DTF.
You can only cancel a job if that job is in either a Pending or Copying files state. If the job is in a Running
or Complete state, nothing occurs. Any files copied when a Copying files state are left on the target systems.
If a file copy in progress when you execute this command, the file is restored to its original contents before
starting the copy process.
To cancel (kill) a process, use the –k option. In addition to the cancellation process, the –k option sends the
kill signal to the shell process spawned to run the command line associated with the tool. When using this
option, it is possible to leave a target system in an inconsistent state.
The mxexec command displays job information in multiple formats. To list job information, use one of the
following:
# mxexec
# mxexec [–l n | t] [–i taskname … | –j job_ID …] [–d date]
# mxexec –l d [–h] –j job_ID …
Managing HP SIM tasks 125