Host Redirects

Target host substitution variable references and external component substitution variable references can optionally include a host redirect. This means that the host on which the variable or component lookup occurs is the specified host rather than the current target. host-redirect has one of the following forms:

• parent-ref

• hostname

• hostname/parent-ref

hostname is either the name of a host or a substitution variable reference that, when expanded, resolves to the name of a host.

parent-ref is one of the following:

• / – The root parent host of the specified host, or the current target host if hostname is omitted

• A series of one or more slash-separated ..s – The nth parent of the specified host, or current target host if hostname is omitted, where n is the number of ..s that appear

The parent-ref operators are used primarily for virtual hosts, but they can also be used for physical hosts. Applying either operator to a physical host is a no-op.

Example 6–3 Using Target Substitution Variable References

• This example shows how to look up variable var1 on host myHost:

  :[target(myHost):var1]

• This example shows how to look up variable var1 on the host specified by substitution variable hostName:

  :[target(:[hostName]):var1]

• This example shows how to look up variable var1 on the logical host on which the plan is currently running:

  :[target:var1]