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

Parameter Element (ADF)

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

Help and Information

Getting SQL Server 2005 Assistance