Name Element for ParameterDefaults/Parameter (ICF)
Specifies the name of a parameter in the instance configuration file (ICF).
Syntax
<ParameterDefaults>
<Parameter>
<Name>
Element Characteristics
Characteristic | Description |
---|---|
Data type |
string, between 1 and 255 characters in length. |
Default value |
None. |
Occurrence |
Required once per Parameter element. |
Updates |
Can be modified and then applied when updating the instance. |
Element Relationships
Relationship | Elements |
---|---|
Parent element |
|
Child elements |
None. |
Remarks
The parameter name must match the name of the parameter to be replaced in the ICF, but without the start and end % characters.
For example, you might need to specify the same directory for several files. Instead of typing the path in each location and having to change it in each location, you can use a parameter. For this example, the format of the parameter to be replaced is %BaseDirPath%
; the Name for this parameter is BaseDirPath
.
You can override ParameterDefaults values by specifying the parameter name and value when creating or updating the instance.
Example
This example shows how to specify a default parameter value for the parameter named BaseDirPath
. Notification Services substitutes "C:\NS" wherever %BaseDirPath%
appears in the ICF, unless you specify another value for the parameter on the command line.
<Parameter>
<Name>BaseDirPath</Name>
<Value>C:\NS</Value>
</Parameter>
See Also
Reference
Application Definition File Reference
Concepts
Instance Configuration File Reference
Other Resources
Using Parameters in an Instance Configuration File
Updating Instances and Applications