Parameter Element (ADF)

Contains the definition of a single application parameter.

Syntax

<ParameterDefaults>
    <Parameter>

Element Characteristics

Characteristic Description

Data type

None.

Default value

None.

Occurrence

Required one or more times per ParameterDefaults element.

Updates

Can be added and deleted when updating the application.

Element Relationships

Relationship Elements

Parent element

ParameterDefaults Element (ADF)

Child elements

Name Element for Parameter (ADF)

Value Element for Parameter (ADF)

Remarks

In your 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.

Example

The following example shows how to define a SysName parameter. Wherever the string "%SysName%" appears in the ADF, Microsoft SQL Server Notification Services substitutes the value SERVER01.

<Parameter>
    <Name>SysName</Name>
    <Value>SERVER01</Value>
</Parameter>

As a result, if the ADF has the following for a SystemName element:

<SystemName>%SysName%</SystemName>

Notification Services will replace the parameter when you create the instance so that the effective SystemName definition is this:

<SystemName>SERVER01</SystemName>

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