HP Systems Insight Manager - Manual (Page 305)

<!ELEMENT tool-list ( ssa-command-tool |
msa-command-tool |
web-launch-tool |
automation-tool |
app-launch-tool )* >
<!-- The ssa-command-tool element specifies a single-system aware
tool. The ssa-command-tool element can optionally specify a
category element, a description element, a comment element, an
owner element, a default-target element, an execute-as-user
element, a job-display-handler element, a toolbox-enabled
element, zero or more toolbox elements, zero or more
include-filter elements, or zero or more env-variable elements.
(NOTE: The role-enabled and role elements are deprecated
elements and should not be used with this product. These
are provided for backward compatibility with previous
products. The toolbox-enabled element and the toolbox
element should be used in their stead.)
If more than one of these elements are specified, the element
must appear in the order as listed in this definition. The
ssa-command-tool element must contain an ssa-block element. The
ssa-block element must appear after the previously described
optional elements, if any of the optional elements are
specified. Following the ssa-block element, one can specify zero
or more attribute elements.-->
<!ELEMENT ssa-command-tool (category?, description?, comment?,
owner?, default-target?, execute-as-user?,
job-display-handler?,
toolbox-enabled?, toolbox*,
role-enabled?, role*,
include-filter*, env-variable*,
ssa-block, attribute* ) >
<!-- In addition to the previously described elements, the
ssa-command-tool element specifies the following attributes. The
name attribute specifies the tool name and must be specified in
the ssa-command-tool element. The visible attribute specifies
whether the tool is visible for running. By default tools are
visible. The max-targets attribute specifies the maximum number
of targets against which a tool can run. The revision attribute
allows a tool author to specify a revision for the tool. Note
that this is for information only. The job-log attribute
specifies whether the results of the command will be kept in this
system's job log. This attribute applies only to tools when they
are run as scheduled tasks, not when they are run as "run now"
tasks. When job-log="true" the job and target status for the tool
will be kept for a relatively lengthy system-defined period in
the database after the job completes. When job-log="false" only
the last completed copy of the job and target status for the task
will be kept in the cache for a much shorter period of time, and
will not be written to the database. Job logging is enabled by
default. The schedulable attribute specifies whether the tool can
be run as a schedulable task. When scheduled="false" the tool can
only run as a "run now" task. Tools are scheduled by default.
The GUID attribute specifies a globally unique identifier (GUID)
for the tool. Because the system generates a GUID for a tool
during the add operation, this field should only be specified
during a modify operation. The accepts-targets attribute specifies
Custom tools 305