HP Systems Insight Manager 7.2 Command Line Interface Guide

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 ¦
148 Infrastructure management using CLI