<toplevelRef> Repository Component Targeter

The <toplevelRef> element identifies a top-level component reference that is declared or inherited by the current composite component. Only steps in a composite component can use this targeter.

This element can be used as a targeter for the <install> step.

This targeter is semantically equivalent to the <component> targeter, except that the name, path, and version attributes are predefined based on the referenced component. A top-level component reference can be installed any number of times on any number of hosts.

Attributes for the <toplevelRef> Targeter

The <toplevelRef> targeter has the following attributes:

• name – A required attribute of type identifier, which is the name of a top-level component reference in this component.

• host – An optional attribute that is the host on which the referenced component is to be installed. By default, host is the current host. See the description of the host attribute in Attributes for the <retarget> Step. This attribute can reference simple substitution variables.