HP Systems Insight Manager 7.0 Command Line Interface Guide

• 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, Systems Insight Manager 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 Systems Insight Manager
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 â ¦
If you do not specify any options, as shown in the first example, all your incomplete jobs appear.
• The –l n option lists job IDs only.
• The -l t option lists job information in a tabular format, providing task name, job ID, Systems
Insight Manager user, Systems Insight Manager tool name, and the job state. The –i and –j
options are mutually exclusive.
146 Infrastructure management using CLI