Cisco SPA921 - - IP Phone Provisioning Manual page 45

Creating Provisioning Scripts
Proprietary Plain-Text Configuration File
Cisco Small Business IP Telephony Devices Provisioning Guide
During macro expansion, expressions of the form $NAME and $(NAME) are
replaced by the contents of the named variables. These variables include general
purpose parameters, several product identifiers, certain event timers, and
provisioning state values. For a complete list, see the
Variables" section on page
In the following example, the expression $(MAU) is used to insert the MAC address
000E08012345.
The administrator enters: spa$(MAU)config.cfg
The resulting macro expansion for a device with MAC address 000E08012345
is: spa000E08012345config.cfg
If a macro name is not recognized, it remains unexpanded. For example, the name
STRANGE is not recognized as a valid macro name, while MAU is recognized as a
valid macro name.
The administrator enters: spa$STRANGE$MAU.cfg
The resulting macro expansion for a device with MAC address 000E08012345
is: spa$STRANGE000E08012345.cfg
Macro expansion is not applied recursively. For example, $$MAU" expands into
$MAU" (the $$ is expanded), and does not result in the MAC addres.
The special purpose parameters (GPP_SA through GPP_SD), whose contents are
mapped to the macro expressions $SA through $SD, are only macro expanded as
the argument of the --key option in a resync URL.
Also, the macro expression can qualify the expansion so that only a substring of
the macro variable is used instead of its full value, such as a portion of the MAC
address.
The syntax for substring macro expansion is $(NAME:p) and $(NAME:p:q), where p
and q are non-negative integers. The resulting expansion results in the macro
variable substring starting at character offset p, and of length q (or till end-of-string
if q is not specified). Refer to the following examples.
The administrator enters: $(MAU:4)
The resulting macro expansion for a device with MAC address 000E08012345
is: 08012345
The administrator enters: $(MAU:8:2)
The resulting macro expansion for a device with MAC address 000E08012345
is: 23
91.
"Macro Expansion
2
43