HP Systems Insight Manager 7.0 Command Line Interface Guide

To remove an existing task, enter:
# mxtask r taskname
Where taskname is the name of the task you want to remove.
To run an existing task immediately, enter:
# mxtask e taskname
To change the owner of a task, use the o option, for example:
# mxtask o taskname newowner
In this example, newowner, an existing user in Systems Insight Manager, becomes the owner of
the task taskname. To execute this command, you must have the authorization to change task
ownership (see “Managing users and authorizations).
There are different options available for displaying task information. To see a tabular list of all
exiting tasks in Systems Insight Manager, use one of the following commands:
# mxtask
# mxtask lt
The output is a table that displays the task name, the name of the tool associated with the task, the
time the task was last run, and the schedule for the task. To see details about a specific task, use,
# mxtask ld taskname
This command displays the name of the task, tool, and collection associated with the task, task
owner, task schedule information, the times of the last run and next run, the last time the task was
modified, and XML format of any parameters for the tool associated with this task.
The lf option displays the task definition in XML format. By using file redirection, you can save
the output for use in creating additional tasks. For example, # mxtask lf â Daily Device
Identificationâ displays on the terminal the XML for the “Daily Device Identification” task.
However, # mxtask lf â Daily Device Identificationâ > deviceid.xml
saves the XML for the “Daily Device Identification” task in the file deviceid.xml.
There is additional information beyond the data provided in the man pages for mxtask. This
information is displayed on the console terminal, and is available by using the following command:
# mxtask h
HP recommends that the output be piped to more or redirected to a file for easier viewing.
Managing task execution
The mxexec command enables you to execute tools that are defined in Systems Insight Manager,
whether those tools are Systems Insight Manager tools, or tools that you have created. As discussed
in the previous section, mxtask is used to create tasks to enable scheduled execution of tools,
and mxexec is used for immediate execution of a tool, as well as to manage other jobs running
within Systems Insight Manager. 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.
Managing Systems Insight Manager tasks 145