APIs related to XML QoS Profiles.
A 'QoS profile' is a group of QoS settings, specified in XML format. By using QoS profiles, you can change QoS settings without recompiling the application.
The Qos profiles are loaded when the following operations are called:
The QoS profiles are reloaded replacing previously loaded profiles when the following operations are called:
operation will free the resources associated with the XML QoS profiles.
There are five ways to configure the XML resources (listed by load order):
The above methods can be combined together.
The location of the XML resources (only files and strings are supported) is specified using a URL (Uniform Resource Locator) format. For example:
File Specification: file:///usr/local/default_dds.xml
String Specification: str://"<dds><qos_library> . . . lt;/qos_library></dds>"
If the URL schema name is omitted, RTI Connext will assume a file name. For example:
File Specification: /usr/local/default_dds.xml
To provide redundancy and fault tolerance, you can specify multiple locations for a single XML document via URL groups. The syntax of a URL group is as follows:
[URL1 | URL2 | URL2 | . . .| URLn]
[file:///usr/local/default_dds.xml | file:///usr/local/alternative_default_dds.xml]
Only one of the elements in the group will be loaded by RTI Connext, starting from the left.
Brackets are not required for groups with a single URL.
The environment variable NDDS_QOS_PROFILES contains a list of URL groups separated by ';'
The URL groups referenced by the enviroment variable are loaded if they exist and DDS_ProfileQosPolicy::ignore_environment_profile is set to DDS_BOOLEAN_FALSE
For more information on XML Configuration, refer to the User's Manual.