Variable element

Represents an environment variable that you want to set for a diagnostic test or set for a step in a diagnostic test.

Usage

<Variable
  Name = "character_string"
  Value = "character_string"/>

Attributes

Attribute Type Required Description

Name

character_string

Yes

Specifies the name of an environment variable that you want to set for a diagnostic test or set for a step in a diagnostic test.

The maximum length of the environment variable name is 255 characters.

Value

character_string

No

Specifies the value that you want to set for an environment variable for a diagnostic test or set for a step in a diagnostic test.

The maximum length of the environment variable value is 255 characters.

Child elements

There are no child elements.

Parent elements

Element Description

EnvironmentVariables

Represents a set of one or more environment variables that you want to set for a diagnostic test or set for a step in a diagnostic test.

Remarks

If the parent EnvironmentVariables element for the Variable element is the child of the PreStep, RunStep, or PostStep element, the environment variable is set only for the corresponding phase of the diagnostic test.

If the parent EnvironmentVariables element for the Variable element is the child of the DiagnosticTest element, the environment variable is set globally for the entire diagnostic test.

To unset an environment variable, specify the Name attribute without a Value attribute, or specify an empty string for the Value attribute, for example:

<Variable Name="Variable1"/>
<Variable Name="Variable2" Value=""/>

You cannot specify multiple Variable elements that have the same value for the Name attribute in the definition of a single diagnostic test.

Element information

Schema file DiagnosticTests.xsd
Can be empty Yes

See also

EnvironmentVariables