HP Systems Insight Manager 6.3 Command Line Interface Guide

mxtask -rf taskxmlfile
Description
The mxtask command enables you to list all tasks, list details for a particular task, list task
parameters in XML format, execute a task, remove a task, change ownership for a task, and create
a task from the command line or an XML file.
• mxtask
mxtask -lt
These commands provide a tabular listing showing the major attributes of all tasks currently
registered in the database. The displayed information includes the task name, associated
query name, associated tool name, and task type with associated schedule data.
• mxtask -ld taskname
This command lists the details for a specified task. The displayed information includes the task
name, tool name, query name, task owner, last time the task was run, the next time task will
run, the last time task information was modified, the task type, and any tool user parameters
(in XML format) that might be associated with the specified tool.
• mxtask -lf taskname [-b encoding ]
mxtask -lf all [-b encoding ]
This command lists the specified task in task-specific XML format. Output from this command
is written to stdout, and can be redirected (with >) to an external file. The output file can
be modified and used as the XML input file when creating a new task with -cf. Using the all
keyword forces mxtask to list all tasks in XML format. See the mxtask(4) manpage for a
detailed description of the task-specific XML format.
Optionally, you can specify the character encoding of the XML file. The value for the character
encoding must match a valid character encoding. If no encoding is specified, the system
attempts to write the file in the encoding currently defined on the system. See http://
www.iana.org/assignments/character-sets for the list of valid character sets.
• mxtask -r taskname
This command enables you to remove the specified task. The task is removed immediately.
You must specify the name of an existing task, and you must be authorized to remove the task.
• mxtask -e taskname
This command enables you to run the specified task. The task will execute immediately. You
must specify the name of an existing task, and you must be authorized to execute the task
against the managed systems that the associated query is targeted for (see mxauth(1M)).
• mxtask -o taskname taskowner
This command enables you to change ownership for the specified task. You must specify the
name of an existing task and the desired new owner, and you must be authorized to change
task ownership (see mxauth(1M)).
• mxtask -c taskname -q queryname -t toolname -w schedule [-A
toolparms| -f toolparmsfile [-o taskowner] [-i timefiltername] ]
[-o taskowner ] [-i timefiltername ]
This command enables you to create a new task from information provided on the command
line.
mxtask 105