DDS_ProfileQosPolicy Struct Reference

Configures the way that XML documents containing QoS profiles are loaded by RTI Connext. More...

Data Fields
struct DDS_StringSeq	string_profile
	Sequence of strings containing a XML document to load. More...
struct DDS_StringSeq	url_profile
	Sequence of URL groups containing a set of XML documents to load. More...
DDS_Boolean	ignore_user_profile
	Ignores the file USER_QOS_PROFILES.xml in the current working directory. More...
DDS_Boolean	ignore_environment_profile
	Ignores the value of the NDDS_QOS_PROFILES environment variable. More...
DDS_Boolean	ignore_resource_profile
	Ignores the file NDDS_QOS_PROFILES.xml. More...

Detailed Description

Configures the way that XML documents containing QoS profiles are loaded by RTI Connext.

All QoS values for Entities can be configured in QoS profiles defined in XML documents. XML documents can be passed to RTI Connext in string form or, more likely, through files found on a file system.

There are also default locations where DomainParticipants will look for files to load QoS profiles. These include the current working directory from where an application is started, a file in the distribution directory for RTI Connext, and the locations specified by an environment variable.

You may disable any or all of these default locations using the Profile QoS policy.

Entity:

DDS_DomainParticipantFactory

Properties:

RxO = NO
Changeable = Changeable

Field Documentation

string_profile

struct DDS_StringSeq DDS_ProfileQosPolicy::string_profile

Sequence of strings containing a XML document to load.

The concatenation of the strings in this sequence must be a valid XML document according to the XML QoS profile schema.

[default] Empty sequence (zero-length).

url_profile

struct DDS_StringSeq DDS_ProfileQosPolicy::url_profile

Sequence of URL groups containing a set of XML documents to load.

Only one of the elements of each group will be loaded by RTI Connext, starting from the left.

[default] Empty sequence (zero-length).

ignore_user_profile

DDS_Boolean DDS_ProfileQosPolicy::ignore_user_profile

Ignores the file USER_QOS_PROFILES.xml in the current working directory.

When this field is set to DDS_BOOLEAN_TRUE, the QoS profiles contained in the file USER_QOS_PROFILES.xml in the current working directory will be ignored.

[default] DDS_BOOLEAN_FALSE

ignore_environment_profile

DDS_Boolean DDS_ProfileQosPolicy::ignore_environment_profile

Ignores the value of the NDDS_QOS_PROFILES environment variable.

When this field is set to DDS_BOOLEAN_TRUE, the value of the environment variable NDDS_QOS_PROFILES will be ignored.

[default] DDS_BOOLEAN_FALSE

ignore_resource_profile

DDS_Boolean DDS_ProfileQosPolicy::ignore_resource_profile

Ignores the file NDDS_QOS_PROFILES.xml.

When this field is set to DDS_BOOLEAN_TRUE, the QoS profiles contained in the file NDDS_QOS_PROFILES.xml in $NDDSHOME/resource/xml will be ignored.

[default] DDS_BOOLEAN_FALSE