HP Systems Insight Manager 7.2 Technical Reference Guide

Parameterized strings
To create tools, the tool developer must understand how URLs and command lines are formed.
Using parameterized strings, tool developers can greatly enhance the options available in creating
tool definition files (TDEFs).
Parameterized strings contain replacement fields, similar to the format strings used in the popular
printf() function in the standard C library. These fields can be replaced by values entered by the
user at runtime (as defined by the tool parameters attribute), by some standard task properties
supplied by the Task Controller, values related to the selected target systems or system groups, or
by property values retrieved from a global tool properties file. This enables you to generate a very
specific URL or command line.
Parameterized strings substitution table
Table 53 Substitution of global attribute values
DescriptionParameter
Task ID for the task being executed%t
Name of the user running this tool%u
Name of the user executing this tool%e
Management server host name of the core CMS running
the tool
%s
(where # is a positive integer) Substitute the value input by
the user for the parameter referenced by the number (#)
%#
provided, as a list index position (one-based... %1, %2,
%3, and so on)
SOAP logon token, for use with SOAP single sign-on web
applications
%y
Table 54 Substitution of the selected target
DescriptionParameter
The name of the target system (or system group, if the %x
toggle was in the string).
%f
Network name (host name, IP address, or system name in
that order).
%n
Network address (IP address).%a
Link name in format specified by System Link Configuration
setting (name, IP address, or full DNS name).
%l
IP address of WBEM proxy, if any, for this target, in the
form <ip address>:<port#></port#></ip>.
%p
Database GUID of the target system (or system group, if
the %x toggle was in the string).
%g
System type of the target system.%b
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
%r% (rt[.attribute]%)
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 management processor IP
address, use "%r%{MgmtProcToServer.a%} to get the
contact use %r%{MgmtProcToServer.Contact%}". If the
470 Reference