HP SIM V5.1 User Guide (356920-009, January 2007)

Related procedure
Creating a new CMS tool
Related topics
Custom tools
Managing custom tools
Examples of using parameter strings in custom tools
The URL strings for Web aware tools and command line tools must be provided as absolute URLs beginning
with http:// or https://. For example,
https://%n:1188/kcweb/ https://%l:2381/
Web-launch aware tools and command line tools that always run on the
Central Management Server
(CMS)
must be relative URLs beginning with /. For example,
/propertypages/Identify.jsp?device=%n
Multiple selections can be substituted into the URL. A selection index is used during the substitution process
to keep track of the
current
selection. The selection index is initially set to one, and the first selection of the
list of selected target systems remains current until a
%z
parameter is encountered in the URL (an exception
to this exists in the repeat block, discussed later), at which time the next selection becomes current, the
selection index is incremented by one, and so on. For example,
http://server/app/doit.jsp?name=%n%z&addr=%a
where the doit.jsp page is invoked with the network name of the first selected system assigned to the
name
parameter and the IP address of the second selected target assigned to the
addr
parameter.
Any number of selected targets can be substituted by using the repeat block construct,
%( ... %)
. Anything
inside the repeat block delimiters is repeated until the selection list is exhausted, starting with what is then
the current selection and selection index. For example,
https://%{deploy.server%}/deploy/deployimage.jsp? device1=%n%z%(&device%i=%n%z%)
NOTE: The use of the
%i
parameter. The current selection index (1,2,3,and so on) is substituted for this
parameter during the substitution process.
NOTE: If the end of the repetition clause is reached and no
%z
parameter has been encountered, then the
selection index and current election are automatically incremented to avoid an infinite loop during the
substitution phase.
If we have two selected target systems in the above example, the expanded URL string would look like:
https://deploy.hp.com:280/deploy/deployimage.jsp?
device1=nodea.hp.com&device2=nodeb.hp.com
If we have only 1 selected target system in the above example, the expanded URL string would look like:
https://deploy.hp.com:280/deploy/deployimage.jsp? device1=nodea.hp.com
Because there is no current selection when we get to the repeat block, the entire repeat block is suppressed
during the substitution process.
Related procedures
Creating a new remote tool
Creating a new CMS tool
Creating a new web page tool
Removing and restoring custom tools
Related topics
Command line tools
Managing custom tools
Custom tools 299