Parameter Element for ParameterDefaults (ICF)

Contains one name/value pair that provides a default value for a parameter in the instance configuration file (ICF).

Syntax

<ParameterDefaults>
    <Parameter>

Element Characteristics

Characteristic Description

Data type

None.

Default value

None.

Occurrence

Required once or more per ParameterDefaults element.

Updates

Can be added or deleted when updating the instance.

Element Relationships

Relationship Elements

Parent element

ParameterDefaults Element (ICF)

Child elements

Name Element for ParameterDefaults/Parameter (ICF)

Value Element for ParameterDefaults/Parameter (ICF)

Remarks

The ParameterDefaults section is where you define default values for parameters used in the ICF. Anywhere the parameter appears in the ICF, Notification Services substitutes the value.

The Parameter element contains the definition of one name/value pair for an ICF parameter.

For example, you might use the same directory path in multiple locations in your ICF. Instead of typing the path in each location, and then having to change it in each location, you can use a parameter, such as %BaseDirPath%. Then, in the ParameterDefaults section of the ICF, you define the value once, as shown in the example below.

You can override ParameterDefaults values by specifying a parameter name and value when creating or updating the instance.

If you do not specify default values for parameters, omit the entire ParameterDefaults section from the ICF or use empty tags for the child elements.

Example

This example shows how to define a default value for the %BaseDirPath% parameter. Anywhere %BaseDirPath% appears in the ICF, Notification Services substitutes C:\NS.

    <Parameter>
        <Name>BaseDirPath</Name>
        <Value>C:\NS</Value>
    </Parameter>

See Also

Reference

Application Definition File Reference

Concepts

Instance Configuration File Reference

Other Resources

Using Parameters in an Instance Configuration File
Updating Instances and Applications

Help and Information

Getting SQL Server 2005 Assistance