HP Systems Insight Manager 6.3 Command Line Interface Guide

• The DTF has a limit of ten simultaneous job executions. If ten jobs are already executing and
another is requested (via mxexec or the portal), the new job will pause until one of the currently
executing jobs is finished. If the currently executing jobs take a long time to complete (they
are doing lengthy tasks such as installing a large software package using SD, or creating a
recovery image using I/UX), the new job could pause for a long time. This limit is global to
the DTF, and is not a per user limit.
• The DTF has a limit of sixteen simultaneous agent connections. This means that at any point
in time, no more than sixteen agents are executing jobs sent by the DTF. If a job that references
more than sixteen target systems is started, only the first sixteen will be started immediately.
The remaining targets will wait in the Pending state until one of the running targets finishes.
This limit is global to the DTF, and is not a per job or per user limit. If a job is currently executing
on twelve targets and a new job referencing six targets is requested, only the first four targets
will start immediately, and the remaining targets will wait in the Pending state until earlier
targets finish execution.
• The agent has a limit of four simultaneous job executions. If four jobs are executing on a
target, and a new job is started that references that target, when the DTF contacts the agent
on that target to run the new job, it gets an agent busy exception. The DTF will continue
contacting any other referenced targets until the only ones remaining are those that are busy.
It then periodically contacts the busy agent until one of the executing jobs finishes and the
agent accepts the new job.
Options
-t toolname
Specify the name of the tool to execute. If the toolname contains embedded
spaces or other characters interpreted by the shell, enclose it in quotation marks.
-A argvalue [argvalue...]
Specify the arguments required for the intended tool execution. The values are
matched to the arguments by order: first specified to first argument, second specified
to second argument, and so on.
If an argument value contains embedded spaces or other characters interpreted by
the shell, enclose it in quotation marks.
Argument values are separated by spaces. When specifying argument values, enter
any necessary spaces. The CLI will not add additional spaces to those defined in
the tool definition or argument value.
If you do not want to specify a value for an optional argument, enter "" to indicate
a placeholder.
For security reasons Systems Insight Manager prohibits the following characters
from being entered as part of an argvalue: grave accents (`), semicolon (;),
ampersand (&), bar (|), left parenthesis ('('), hash mark (#), greater than sign (>),
less than sign (<), and the new line character.
-h
Suppress job information headers and send the job output directly to stdout or
stderr as appropriate. Exception information is sent to stderr.
-O filename
Save the stdout and stderr data produced by the tool execution to the file
filename . The file's pathname can be absolute or relative to the current directory.
If the file already exists, it will be replaced. If it does not exist, it will be created. If
mxexec 35