RTI Connext C API  Version 5.2.0
 All Data Structures Functions Variables Typedefs Enumerations Enumerator Groups Pages
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.
 
struct DDS_StringSeq url_profile
 Sequence of URL groups containing a set of XML documents to load.
 
DDS_Boolean ignore_user_profile
 Ignores the file USER_QOS_PROFILES.xml in the current working directory.
 
DDS_Boolean ignore_environment_profile
 Ignores the value of the NDDS_QOS_PROFILES environment variable.
 
DDS_Boolean ignore_resource_profile
 Ignores the file NDDS_QOS_PROFILES.xml.
 

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

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).

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).

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

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

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


RTI Connext C API Version 5.2.0 Copyright © Sun Jun 21 2015 Real-Time Innovations, Inc