The <hostSet> element is a child of the <memberList> element and is used to declare a host set to be referenced by the plug-in. The <hostSet> element cannot contain hosts, since plug-ins cannot define hosts. Platform host sets cannot be defined by any plug-in other than the system plug-in. The name of the host set will be implicitly prefixed with the plug-in name when the host set is created in the system.
The <hostSet> element has three attributes:
name – The name of the host set. The name attribute has a maximum length of 32. The name must begin with either a Unicode letter or an underscore character (_), followed by either Unicode letters, number, or an underscore character (_), dot (.), or dash (-).
unsupported (optional) – If true, the host set is not supported. The default is false.
The <hostSet> element contains two optional child elements:
<hostSetRef>
<hostSearchRef>
The <hostSetRef> element is a child of the <hostSet> element. It specifies a sub-host set. This host set must have been previously defined either in this plug-in or in a plug-in on which this plug-in directly depends. References to host sets defined in another plug-in must include the plug-in name, for example, com.foo.other#hostSetName. Unqualified references are assumed to be objects created by this plug-in.
The <hostSetRef> element has one attribute, name. This attribute provides the name of the host set reference. The name attribute has an optional pluginName that has a maximum length of 64, followed by a # separator, followed by a hostEntityName that has a maximum length of 32.
The <hostSearchRef> element is a child of the <hostSet> element. It specifies a sub-host search. This host search must have been previously defined either in this plug-in or in a plug-in on which this plug-in directly depends. References to host searches defined in another plug-in must include the plug-in name, for example, com.foo.other#hostSearchName. Unqualified references are assumed to be objects created by this plug-in.
The <hostSearchRef> element has one attribute, name. This attribute provides the name of the host search reference. The name attribute has an optional pluginName that has a maximum length of 64, followed by a # separator, followed by a hostEntityName that has a maximum length of 32.