HP Systems Insight Manager - Manual (Page 310)

involves accessing the target systems. The automation-tool element
can optionally specify a category element, a menu-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 default-parameter element, a
role-enabled element, zero or more role elements, zero or more
include-filter elements, or zero or more env-variable elements.
If more than one of these elements are specified, the element
must appear in the order as listed in this definition. The
automation-tool element must contain an automation-block element.
The automation-block element must appear after the previously
described optional elements, if any of the optional elements are
specified. Following the automation-block element, one can
specify zero or more attribute elements. -->
<!ELEMENT automation-tool (category?, description?, comment?, owner?,
default-target?, execute-as-user?,
job-display-handler?,
toolbox-enabled?, toolbox*,
role-enabled?, role*,
include-filter*, automation-block,
attribute* ) >
<!-- In addition to the previously described elements, the
automation-tool element specifies the following attributes. The
name attribute specifies the tool name and must be specified in
the automation-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
systems job log. 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 tool 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 scheduled task. When
schedulable="false" the tool can only run as a "run now" task.
Tools are schedulable 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 whether the tool
accepts targets for execution. The accepts-targets attribute is
true by default. -->
!ATTLIST automation-tool name CDATA #REQUIRED
visible (true | false) "true"
max-targets NMTOKEN #IMPLIED
revision CDATA #IMPLIED
job-log (true | false) "true"
schedulable (true | false) "true"
guid NMTOKEN #IMPLIED
accepts-targets (true|false) "true" >
310 Tools that extend management