Value Element for Parameter (ADF)
Specifies the value of an application parameter.
Syntax
<ParameterDefaults>
<Parameter>
...
<Value>
Element Characteristics
Characteristic | Description |
---|---|
Data type |
string, between 0 and 4,000 characters in length. |
Default value |
None. |
Occurrence |
Required once per Parameter element. |
Updates |
Can be modified, but not added or deleted, when updating the application. |
Element Relationships
Relationship | Elements |
---|---|
Parent element |
|
Child elements |
None. |
Remarks
In your application definition file (ADF), you can use a parameter for any element's value. The parameter takes the form %ParameterName%. You can provide values for these parameters in two places:
- In the ADF ParameterDefaults section.
- In the instance configuration file (ICF) Application/Parameters section.
You can also use parameters within the ICF, which provides additional methods of supplying parameter values. For more information, see Using Parameters in an Instance Configuration File.
The value of the Value element must match the format of the element for which it supplies a parameter. For instance, if the value provides data for an element that uses a duration data type, the value must follow the PnYnMnDTnHnMnS format.
Example
The following example shows how to define a parameter called Duration
. Wherever the string "%Duration%" appears in the ADF, Microsoft SQL Server Notification Services substitutes the value P0DT00H15M00S
.
<Parameter>
<Name>Duration</Name>
<Value>P0DT00H15M00S</Value>
</Parameter>
As a result, if the ADF has the following for an ActionTimeout element:
<ActionTimeout>%``Duration``%</ActionTimeout>
Notification Services replaces the parameter when you create the instance so that the effective ActionTimeou definition is this:
<ActionTimeout>``P0DT00H15M00S``</ActionTimeout>
See Also
Reference
Application Definition File Reference
Other Resources
Using Parameters in an Application Definition File (ADF)
Updating Instances and Applications