HP Systems Insight Manager User Manual

Page 307

Advertising
background image

toolbox-enabled?, toolbox*,

role-enabled?, role*,

include-filter*, env-variable*,

msa-block, attribute* ) >

<!-- In addition to the previously described elements, the

msa-command-tool element specifies the following attributes. The

name attribute specifies the tool name and must be specified in

the msa-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

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 msa-command-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" >

<!-- The msa-block specifies the elements specific to a

multiple-system aware (MSA) tool. The msa-block can specify an

MSA command, the parameters for the command and an execution system

on which the command executes. -->

<!ELEMENT msa-block ( command, parameter*, execution-system ) >

<!-- The command element specifies the command for an SSA or an MSA

tool. If the command accepts parameters, it must be specified as

a parameterized string. -->

<!ELEMENT command ( #PCDATA ) >

<!-- The command element can have two attributes. The command-type

attribute specifies whether the command is an x-window, stdout,

restart, launch, or an unknown command type. The default command

type is stdout. The log attribute specifies whether the results

of the command will be output to this system's audit log. When

Custom tools 307

Advertising