HP Systems Insight Manager 6.0 Command Line Interface Guide

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 -cf taskxmlfile
This command enables you to create a new task from information provided in an external task-specific
XML definition file. You must be an administrative rights user to run this command. See the mxtask(4)
manpage for a description of the task-specific XML format.
88 Command descriptions