Systems Insight Manager 6.1 User Guide

FunctionParameter
Specify a file/tool to be removed-r
Specify a tool name-t
Force a tool to be removed or modified even if the version is the
same or tasks are tied to the tool
-x force
NOTE: For more information about mxtool parameters, refer to the mxtool man page in the Systems Insight
Manager information library at the following URL: http://h18013.www1.hp.com/products/servers/
management/hpsim/info-library5/mxtool.1m.html or in the HP SIM 6.0 Command Line Interface Reference
Guide at http://h18013.www1.hp.com/products/servers/management/hpsim/infolibrary.html.
Parameterized strings
Parameterized strings allow tool developers to greatly enhance the options available in creating 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
by values related to the selected target systems or system groups, or by property values retrieved from a
global tool properties file.
Parameterized string substitution descriptions
Table H-5 Global attribute parameters
DescriptionParameter
Job ID for the task being executed%t
Name of the user running this task%u
Name of the user this task will execute as%e
Management server hostname of the core CMS running the tool
(the Systems Insight Manager server name)
%s
Substitute the value input by the user for the parameter referenced
by the number (#) provided, as a list index position (one-based
%#
positive whole integer... %1, %2, %3, and so on). Up to 10
parameters are allowed, %A is used for the 10
th
.
SOAP logon token, for use with SOAP SSO Web applications%y
Table H-6 Current selected target parameters
DescriptionParameter
The system name of the target system.%f
Network name (hostname, IP address, IPX address, or system
name in that order).
%n
Network address (IP address, or IPX address, in that order).%a
Link name in format specified by System Link Configuration security
setting (name, IP address, or full DNS name).
%l
IP address of WMI proxy, if any, for this target, in the form <ip
address>:<port#></port#></ip>.
%p
Systems Insight Manager identifier or GUID of the target system.%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. Valid relationship type strings are
%r% {rt[.attribute]%}
those that are stored in the associationTypeNumber column in the
device_associations table. 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 IP address of the server's
management processor, use %r%{MgmtProcToServer.a%}; to get
158 Custom tool definition files