Parameter Element for Application/Parameters (ICF)

Contains one name/value pair that passes a value to a parameter in the application definition file (ADF).

Syntax

<Applications>
    <Application>
        ...
        <Parameters>
            <Parameter>

Element Characteristics

Characteristic	Description
Data type	None.
Default value	None.
Occurrence	Required once or more per Parameters element.
Updates	Can be added or deleted when updating the instance.

Element Relationships

Relationship	Elements
Parent element	Parameters Element (ICF)
Child elements	Name Element for Application/Parameters/Parameter (ICF) Value Element for Application/Parameters/Parameter (ICF)

Remarks

Parameters in the Application/Parameters section are passed to the application's ADF when you create the instance or update the application. These values override the ParameterDefault settings in the ADF.

Example

This example shows how to specify a parameter for the ADF with the name DBSystem. MyDBServer, specified by the Value element, is substituted for %DBSystem% in the ADF.

<Parameter>
    <Name>DBSystem</Name>
    <Value>MyDBServer</Value>
</Parameter>

This example shows how to specify a parameter for the ADF with the name NSSystem, which gets its value from an ICF parameter. You must provide a value for the ICF parameter %NSServer% either in the ParameterDefaults section of the instance configuration file (ICF) or when creating the instance.

<Parameter>
    <Name>DistributorSystem</Name>
    <Value>%NSServer%</Value>
</Parameter>

For example, you can provide a value for %NSServer% in the ParameterDefaults section of the ICF.

<ParameterDefaults>
    <Parameter>
        <Name>NSServer</Name>
        <Value>Server01</Value>
    </Parameter>
</ParameterDefaults>

See Also

Reference

Application Definition File Reference

Concepts

Instance Configuration File Reference

Other Resources

Associating Applications with an Instance
Updating Instances and Applications

Help and Information

Getting SQL Server 2005 Assistance