Value Element for Application/Parameters/Parameter (ICF)

Contains the value of a parameter to be passed to the application definition file (ADF).

Syntax

<Applications>
    <Application>
        ...
        <Parameters>
            <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 and then applied when updating the instance.

Element Relationships

Relationship Elements

Parent element

Parameter Element for Application/Parameters (ICF)

Child elements

None.

Remarks

If you supply a parameter name and value in the Application/Parameters section of the instance configuration file (ICF), the value replaces a parameter with the same name in the application definition file (ADF). For example, if you have a parameter name/value pair of File and Stock.htm in the Application/Parameters section of the ICF, then every occurrence of %File% in the ADF is replaced with Stock.htm.

Example

This example shows how to specify a value for the %DBSystem% parameter in the ADF. DBServer01, specified by the Value element, is substituted for %DBSystem% throughout the ADF.

<Parameter>
    <Name>DBSystem</Name>
    <Value>DBServer01</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