HP Systems Insight Manager 5.3 Command Line Interface reference guide

External influences
The language setting of the command shell in which you execute this command is used as the preferred
language that you want the command line tool to execute with on the target nodes. If creating a scheduled
task, this language is saved in the scheduled task and used each time it is executed. The same is true when
modifying an existing task. If manually running a scheduled task, this language is used to override the
language stored in the task for this single execution.
For Windows, the current Code Page setting of the Command Prompt window is used to determine the
preferred language. For example, if the chcp command returns 932, the language is Japanese. The chcp
command can be used to change the Code Page setting if the OS has the language installed and is configured
to allow its use.
For Linux and HP-UX, the LANG environment variable describes the locale that is used to determine the
preferred language. Valid settings for the LANG variable can be listed with the locale -a command.
However, in order to view the output, the terminal window running the command shell where you list the
output of this command must support the language and encoding defined by the LANG variable.
If the OS on the target system does not support the language setting or encoding selected by the CMS, the
command shell on the target system will use the default language and encoding for that target's OS.
See lang (5), environ (5), and local (1) for additional information.
Return values
MeaningValue
Successful completion.0
Command line syntax error.2
Invalid name.21
HP Systems Insight Manager repository error.102
The CMS is not initialized.222
Unable to connect to the session manager.249
Remote exception.250
Examples
Example 1
To list all scheduled tasks in tabular format, including the task name, associated tool name, last run time and
schedule information, enter mxtask.
Example 2
To list all scheduled tasks in tabular format, including the task name, associated tool name, last run time and
schedule information, enter mxtask -lt.
Example 3
To list the details for the task test_task , enter mxtask -ld test_task.
Example 4
To list descriptive data for the task test_task in XML format, enter mxtask -lf test_task.
Output from this command can be used to create a new task requiring the same tool, with similar tool (user)
parameters. The output can be redirected to an external file, which could be edited and used as an input
file to create a new task with the -cf command. See the mxtask(4) manpage for a detailed description
of the task-specific XML format.
Example 5
To remove the existing task test_task , enter mxtask -r test_task.
86 Command descriptions