Variable as IP address
The general format of the compound template statement is as below:
<%AAA,BBB,CCC,Variables%>
•AAA – The name of the template to be repeated, formatted as ‘T:TemplateName’
•BBB – The number of times to repeat the template, formatted as a integer from 0 to 1000. If BBB is defined as a data variable, a variable look-up is done to determine this value.
•CCC – The number of variables to iterate within the template, formatted as a integer from 0 to 20.
•(Variables) – Zero or more variable definitions, formatted as a ‘VVV,WWW,XXX,YYY,ZZZ’, defined as below.
The format of the compound template 'Variables' are as below:
<%AAA,BBB,CCC,VVV,WWW,XXX,YYY,ZZZ%>
•VVV – The name of the variable within the compound template to be replaced by a value, formatted as a standard variable including left and right delimiters
•WWW – The starting value to be used during variable replacement, formatted as an IP Address. If WWW is defined as a data variable, a variable look-up is done to determine this value.
•XXX – The value by which WWW is incremented on each iteration, formatted as a integer.
•YYY – This value indicates how often to increment value WWW, formatted as a integer.
•ZZZ – This value defines an offset, formatted as a integer. The value of ZZZ will be added to the IP address value of WWW before doing the variable replacement.
The variable portion must be repeated according to the number of variables defined by CCC.
Please have a look at the example files provided as part of the installation as these show practical use of the available features.
Example 1, Repeat a template 4 times while incrementing 3 variables:
<%T:TemplateToRepeat,4,3,<<NetIPAddress>>,<<NetIP>>,256,1,0,<<NetVRRPAddress>>,<<NetIP>>,256,1,1,<<NetPriAddress>>,<<NetIP>>,256,1,2%>
•T:TemplateToRepeat – Compound Template Name to be repeated. (%TemplateToRepeat% in versions pre 2.2)
•4 – Number of times to repeat the template
•3 – Number of variables within the template to increment
•<<NetIPAddress>> – The variable within the compound template to increment
•<<NetIP>> – Data variable to look up which defines the variable starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•0 – No IP offset from the NetIP variable
•<<NetVRRPAddress>> – The variable within the compound template to increment
•<<NetIP>> – Data variable to look up which defines the variable starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•1 – Offset the IP by 1 from the NetIP variable
•<<NetPriAddress>> – The variable within the compound template to increment
•<<NetIP>> – Data variable to look up which defines the variable starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•2 – Offset the IP by 2 from the NetIP variable
Example 2, Repeat a template 4 times while incrementing 3 variables:
<%T:TemplateToRepeat,4,3,<<NetIPAddress>>,10.0.0.0,256,1,0,<<NetVRRPAddress>>,10.0.0.0,256,1,1,<<NetPriAddress>>,10.0.0.0,256,1,2%>
•T:TemplateToRepeat – Compound Template Name to be repeated. (%TemplateToRepeat% in versions pre 2.2)
•4 – Number of times to repeat the template
•3 – Number of variables within the template to increment
•<<NetIPAddress>> – The variable within the compound template to increment
•10.0.0.0 – Data variable to look up which defines the variable starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•0 – No IP offset from the NetIP variable
•<<NetVRRPAddress>> – The variable within the compound template to increment
•10.0.0.0 – Data variable to look up which defines the variable starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•1 – Offset the IP by 1 from the NetIP variable
•<<NetPriAddress>> – The variable within the compound template to increment
•10.0.0.0 – Data variable to look up which defines the variable starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•2 – Offset the IP by 2 from the NetIP variable
Example 3, Repeat a template <<RepeatCount>> times while incrementing 1 variables:
<%T:TemplateToRepeat,<<RepeatCount>>,1,<<IncSubnetVar>>,10.1.1.0,256,1,10%>
•T:TemplateToRepeat – Compound Template Name to be repeated. (%TemplateToRepeat% in versions pre 2.2)
•<<RepeatCount>> – Data variable to look up which defines the number of times to repeat the template
•1 – Number of variables within the template to increment
•<<IncSubnetVar>> – The variable within the compound template to increment
•10.1.1.0 – The starting IP address
•256 – Increment by this amount (/24 or class C IP address)
•1 – Increment every x count
•10 – Offset the IP address by 10
Example 4, Repeat a template <<RepeatCount>> times while incrementing 1 variables:
<%T:TemplateToRepeat,<<RepeatCount>>,1,<<IncSubnetVar>>,<<IPAddress>>,<<SubnetLen>>,1,3%>
•T:TemplateToRepeat – Compound Template Name to be repeated. (%TemplateToRepeat% in versions pre 2.2)
•<<RepeatCount>> – Data variable to look up which defines the number of times to repeat the template
•1 – Number of variables within the template to increment
•<<IncSubnetVar>> – The variable within the compound template to increment
•<<IPAddress>> – Data variable to look up which defines the starting IP address
•<<SubnetLen>> – Data variable to look up which defines the amount to increment
•1 – Increment every x count
•3 – Offset the IP address variable by 3