Tool filtering – HP Systems Insight Manager User Manual

Page 301

Advertising
background image

Description

Parameter

System sub-type of the target system

%c

Substitutes the related system that has the relationship type as
specified in the parameter "rt." If the [.attribute] is specified, then
one of the named system attributes would be returned for the
related system. In addition, the common attributes such as Network
name (.a) also work. For example, to get the server's management
processor's IP address, use %r{MgmtProcToServer.a%} to get the
contact use %r{MgmtProcToServer.Contact%}. If the related systems
attribute is omitted then for each system, the network name and
IP address is returned. The network name and IP address are
returned in the form "network name|ip address". If more than one
system is returned, they are comma-delimited. Note that the
relationship type "MgmtProcToServer" can be used to return related
system information for all management processor relationship
types.

%r% (rt[.attribute]%)

The value of the named attribute of the target system.

%(attribute]%)

The following parameters provide repetition to support multiple selected target systems:

Description

Parameter

Repeated pattern (only repeats if a current selection exists). If a
current target selection does not exist, the text between the
delimiters is removed on expansion. This enables the text to be
optional and dependent upon the target selection list.

%( ... %)

Selection index (one-based).

%i

Do not substitute anything, but increment the selection index to
the next integer and the referenced target system to the next target
in the selected target list.

%z

Encrypted text (encrypt after all other parameters have been
substituted).

% < ... >l

Enables you to retain a % in the command/URL after substitution.

%%

Tool filtering

Tool filtering is a facility enabling the tool writer to control whether the tool should be executed on a selected
system. Most tools are platform dependent in that their successful execution depends on commands that are
provided on some platforms but not on others. For example, the bdf tool depends on the bdf command,
which is provided on HP-UX platforms, but is not available under that name on Linux platforms. A tool should
only be visible in the Tools menu when there is at least one discovered system that passes the filter
requirements. A discovered system must pass the filter requirements and is executed only if all the filter
requirements are passed. To do this, the tool specifies in a system filter expression the system attributes that
must be possessed by all systems it can run on.

NOTE:

If a tool cannot be launched for selected systems, an error message is displayed with information

about why the tool cannot be launched.

The system attributes required for a tool to run are specified by system filter expressions having the form:

<node-filter name="attribute-name" operator="eq"

value="attribute-value" />

or

<node-filter name="attribute-name" operator="ge"

value="attribute-value" />

or

<node-filter name="attribute-name" operator="lt"

value="attribute-value" />

or

Custom tools 301

Advertising