HP Systems Insight Manager 5.2 Update 2 Technical Reference Guide

Web-launch aware tools must specify a main URL.
When specifying file copy pairs, the destination file paths for each file copy pair within a single TDEF must
be unique. Specifying the same destination file path for multiple source file paths results in a file parsing
error.
An error occurs when running a tool that copies a file if the file does not exist or is unreadable. The source
file path is not checked at the time the tool is created or modified, but the path must exist at the time the tool
is executed.
When the log element is set to true, standard out and standard error output from the execution of the tool is
logged in the Central Management Server (CMS) log file /var/opt/mx/logs/mx.log. When it is set to
false, only summary task log information, such as start and end times and task status is logged.
Document type definition
The Document Type Definition (DTD) file defines the constraints for an XML file. These constraints include the
valid element tags, attributes, and the cardinality of elements in an XML file. The tool DTD file is named
toollist.dtd and is included in the following paragraph. Note that because of manpage formatting,
the DTD contents might not appear the same as in the file.
<?xml version="1.0" encoding="UTF-8" ?>
<!-- The tool-list element can contain zero or more of
ssa-command-tool elements, msa-command-tool elements,
web-launch-tool elements, automation-tool elements, mdbean-tool
elements, or app-launch-tool elements.-->
<!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*,
342 Tools that extend management