The properties element is used in three situations:
- as a named property set if the
idattribute is specified - as a reference to a named property set if the
refidattribute is specified - as an unnamed property set if the
idorrefidattributes are not specified.
A property set is useful for defining a set of properties (a named property set) in application or node descriptors. Named property sets can be included in named or unnamed property sets with property set references.
A named property set element may only be a child of an application element or a node element. An unnamed property set element may only be a child of a server, icebox, service, server-instance or service-instance element. An unnamed property set element with the service attribute defined may only be a child of a server-instance element. A reference to a named property set can only be a child of a named or unnamed property set element.
The following attributes are supported:
Attribute |
Description |
Required |
|---|---|---|
|
Defines a new named property set with the given identifier. The identifier must be unique among all named property sets defined in the same scope. If not specified, the properties element refers to an unnamed property set or a property set reference. |
No |
|
Defines a reference to the named property set with the given identifier. If not specified, the element refers to an unnamed or named property set. |
No |
|
Specifies the name of an IceBox service that is defined in the enclosing |
No |
Here is an example to demonstrate the use of this element:
<application name="Simple"> <properties id="Debug"> <property name="Ice.Trace.Network" value="1"/> </properties> <server id="MyServer" exe="./server"> <properties> <properties refid="Debug"/> <property name="AppProperty" value="1"/> </properties> </server> </application>