<<extension>> QoS libraries and profiles that are automatically built into RTI Connext. More...

Classes
class	BuiltinQosProfiles
	The available built-in QoS libraries and profiles. More...

Variables
static final String	BUILTIN_QOS_LIB
	A library of non-experimental QoS profiles.

static final String	PROFILE_BASELINE_ROOT
	The root baseline QoS values from which all other Baseline.X.X.X profiles inherit.

static final String	PROFILE_BASELINE
	The most up-to-date QoS default values.

static final String	PROFILE_BASELINE_5_0_0
	The QoS default values for version 5.0.0.

static final String	PROFILE_BASELINE_5_1_0
	The QoS default values for version 5.1.0.

static final String	PROFILE_BASELINE_5_2_0
	The QoS default values for version 5.2.0.

static final String	PROFILE_BASELINE_5_3_0
	The QoS default values for version 5.3.0.

static final String	PROFILE_GENERIC_COMMON
	A common Participant base profile.

static final String	PROFILE_GENERIC_MONITORING_COMMON
	Enables RTI Monitoring Library.

static final String	PROFILE_GENERIC_CONNEXT_MICRO_COMPATIBILITY
	Sets the values necessary to communicate with RTI Connext Micro.

static final String	PROFILE_GENERIC_CONNEXT_MICRO_COMPATIBILITY_2_4_9
	Sets the values necessary to communicate with RTI Connext Micro versions 2.4.4 through at least 2.4.9.

static final String	PROFILE_GENERIC_CONNEXT_MICRO_COMPATIBILITY_2_4_3
	Sets the values necessary to communicate with RTI Connext Micro versions 2.4.3 and ealier.

static final String	PROFILE_GENERIC_OTHER_DDS_VENDOR_COMPATIBILITY
	Sets the values necessary to interoperate with other DDS vendors.

static final String	PROFILE_GENERIC_510_TRANSPORT_COMPATIBILITY
	Sets the values necessary to interoperate with RTI Connext 5.1.0 using the UDPv6 and/or SHMEM transports.

static final String	PROFILE_GENERIC_SECURITY
	Loads the DDS Secure builtin plugins.

static final String	BUILTIN_QOS_LIB_EXP
	A library of experimental QoS profiles.

static final String	PROFILE_GENERIC_STRICT_RELIABLE
	Enables strict reliability.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE
	Enables keep-last reliability.

static final String	PROFILE_GENERIC_BEST_EFFORT
	Enables best-effort reliability.

static final String	PROFILE_GENERIC_STRICT_RELIABLE_HIGH_THROUGHPUT
	A profile that can be used to achieve high throughput.

static final String	PROFILE_GENERIC_STRICT_RELIABLE_LOW_LATENCY
	A profile that can be used to achieve low latency.

static final String	PROFILE_GENERIC_PARTICIPANT_LARGE_DATA
	A common Participant base profile to facilitate sending large data.

static final String	PROFILE_GENERIC_PARTICIPANT_LARGE_DATA_MONITORING
	Configures Participants for large data and monitoring.

static final String	PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA
	Configures endpoints for sending large data with strict reliability.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA
	Configures endpoints for sending large data with keep-last reliability.

static final String	PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_FAST_FLOW
	Configures strictly reliable communication for large data with a fast flow controller.

static final String	PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_MEDIUM_FLOW
	Configures strictly reliable communication for large data with a medium flow controller.

static final String	PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_SLOW_FLOW
	Configures strictly reliable communication for large data with a slow flow controller.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA_FAST_FLOW
	Configures keep-last reliable communication for large data with a fast flow controller.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA_MEDIUM_FLOW
	Configures keep-last reliable communication for large data with a medium flow controller.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA_SLOW_FLOW
	Configures keep-last reliable communication for large data with a slow flow controller.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_TRANSIENT_LOCAL
	Persists the samples of a DataWriter as long as the entity exists.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_TRANSIENT
	Persists samples using RTI Persistence Service.

static final String	PROFILE_GENERIC_KEEP_LAST_RELIABLE_PERSISTENT
	Persists samples in permanent storage, like a disk, using RTI Persistence Service.

static final String	PROFILE_GENERIC_AUTO_TUNING
	Enables the Turbo Mode batching and Auto Throttle experimental features.

static final String	PROFILE_GENERIC_MINIMAL_MEMORY_FOOTPRINT
	Uses a set of QoS which reduces the memory footprint of the application.

static final String	PROFILE_PATTERN_PERIODIC_DATA
	Used for applications that expect periodic data.

static final String	PROFILE_PATTERN_STREAMING
	Used for applications that stream data.

static final String	PROFILE_PATTERN_RELIABLE_STREAMING
	Used for applications that stream data and require reliable communication.

static final String	PROFILE_PATTERN_EVENT
	Used for applications that handle events.

static final String	PROFILE_PATTERN_ALARM_EVENT
	Used for applications which handle alarm events.

static final String	PROFILE_PATTERN_STATUS
	Used for applications whose samples represent statuses.

static final String	PROFILE_PATTERN_ALARM_STATUS
	Used for applications in which samples represent alarm statuses.

static final String	PROFILE_PATTERN_LAST_VALUE_CACHE
	Used for applications that only need the last published value.

Detailed Description

<<extension>> QoS libraries and profiles that are automatically built into RTI Connext.

The built-in profiles can be accessed in QoS XML configuration files and by using any of the APIs that accept library and profiles names by using the constants or string versions as documented on this page.

The built-in profiles are provided as a way to quickly and easily configure RTI Connext applications with a set of QoS values aimed at achieving a specific behavior.

There are three types of profiles:

Baseline.X.X.X: These profiles represent the QoS defaults for Connext version X.X.X. To access the defaults for the latest RTI Connext version, use the BuiltinQosLib::Baseline profile.
Generic.X: These profiles allow you to easily configure different features and communication use-cases with RTI Connext. For example, there is a Generic.StrictReliable profile for use when your application has a requirement for no data loss.
Pattern.X: These profiles inherit from the Generic.X profiles and allow you to configure various domain-specific communication use cases. For example, there is a Pattern.Alarm profile that can be used to manage the generation and consumption of alarm events.

These profiles can be used as base profiles in XML configuration files and values can be modified to fit a specific system's needs. For example:

<qos_profile name="MyProfile" base_name="BuiltinQosLibExp::Generic.StrictReliable">
    <participant_qos base_name="BuiltinQosLib::Generic.Monitoring.Common">
      <!-- Override and add values -->
    </participant_qos>
 </qos_profile>          

The profiles can also be used in any APIs that call for a QoS library and profile name, for example, the create_*_with_profile() APIs. To create a com.rti.dds.publication.DataWriter configured to send large data:

writer = DDS_DomainParticipant_create_datawriter_with_profile(
                  participant, topic, 
                  com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP, 
                  com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_FAST_FLOW, 
                  NULL, com.rti.dds.infrastructure.StatusKind.STATUS_MASK_NONE); 

All the built-in profiles are documented in the BaselineRoot.documentationONLY.xml and BuiltinProfiles.documentationONLY.xml files that are included in the NDDSHOME/xml directory of the RTI Connext installation.

BaselineRoot.documentationONLY.xml contains the root baseline QoS profile that corresponds to the default values of RTI Connext 5.0.0.

BuiltinProfiles.documentationONLY.xml contains the rest of the built-in Qos profiles.

Variable Documentation

final String BUILTIN_QOS_LIB

static

A library of non-experimental QoS profiles.

String-version: "BuiltinQosLib"

final String PROFILE_BASELINE_ROOT

static

The root baseline QoS values from which all other Baseline.X.X.X profiles inherit.

This profile contains the root baseline QoS values from which all other Baseline.X.X.X profiles inherit. These values correspond to the default values for RTI Connext 5.0.0.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Baseline.Root"

final String PROFILE_BASELINE

static

The most up-to-date QoS default values.

You can use this profile if you want your application to pick up and use any new QoS default settings each time a new RTI Connext version is released – without changing your application code.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Baseline"

final String PROFILE_BASELINE_5_0_0

static

The QoS default values for version 5.0.0.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Baseline.5.0.0"

final String PROFILE_BASELINE_5_1_0

static

The QoS default values for version 5.1.0.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Baseline.5.1.0"

final String PROFILE_BASELINE_5_2_0

static

The QoS default values for version 5.2.0.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Baseline.5.2.0"

final String PROFILE_BASELINE_5_3_0

static

The QoS default values for version 5.3.0.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Baseline.5.3.0"

final String PROFILE_GENERIC_COMMON

static

A common Participant base profile.

All Generic.X and Pattern.X profiles inherit from this profile.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.Common"

final String PROFILE_GENERIC_MONITORING_COMMON

static

Enables RTI Monitoring Library.

Enables RTI Monitoring Library using the Baseline QoS defaults. You can use this profile to override the Participant configuration to use monitoring when inheriting profiles. For example:

<qos_profile name="MyProfile" base_name="BuiltinQosLibExp::Generic.StrictReliable">
    <participant_qos base_name="BuiltinQosLib::Generic.Monitoring.Common">
      ...
    </participant_qos>
 </qos_profile>          

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.Monitoring.Common"

final String PROFILE_GENERIC_CONNEXT_MICRO_COMPATIBILITY

static

Sets the values necessary to communicate with RTI Connext Micro.

This profile will always represent the QoS values required for interoperability between the most recent version of RTI Connext Micro at the time of release of the most recent version of RTI Connext.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.ConnextMicroCompatibility"

final String PROFILE_GENERIC_CONNEXT_MICRO_COMPATIBILITY_2_4_9

static

Sets the values necessary to communicate with RTI Connext Micro versions 2.4.4 through at least 2.4.9.

At the time of the release of RTI Connext 5.3.0 it was not necessary to set any QoS values in order to interoperate with RTI Connext Micro. This applies to RTI Connext Micro versions 2.4.4 and later. The most recent version of RTI Connext Micro at the time of release of RTI Connext 5.3.0 was 2.4.9. There is no guarantee that this profile will interoperate with versions of RTI Connext Micro after 2.4.9.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.ConnextMicroCompatibility.2.4.9"

final String PROFILE_GENERIC_CONNEXT_MICRO_COMPATIBILITY_2_4_3

static

Sets the values necessary to communicate with RTI Connext Micro versions 2.4.3 and ealier.

RTI Connext Micro versions 2.4.3 and earlier only supported the com.rti.dds.infrastructure.LivelinessQosPolicyKind.LivelinessQosPolicyKind.MANUAL_BY_TOPIC_LIVELINESS_QOS LivelinessQos kind. In order to be compatible with these versions of RTI Connext Micro, the com.rti.dds.subscription.DataReader and com.rti.dds.publication.DataWriter must have their Liveliness kind changed to this value because the default kind in RTI Connext is com.rti.dds.infrastructure.LivelinessQosPolicyKind.LivelinessQosPolicyKind.AUTOMATIC_LIVELINESS_QOS.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.ConnextMicroCompatibility.2.4.3"

final String PROFILE_GENERIC_OTHER_DDS_VENDOR_COMPATIBILITY

static

Sets the values necessary to interoperate with other DDS vendors.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.OtherDDSVendorCompatibility"

final String PROFILE_GENERIC_510_TRANSPORT_COMPATIBILITY

static

Sets the values necessary to interoperate with RTI Connext 5.1.0 using the UDPv6 and/or SHMEM transports.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.510TransportCompatibility"

final String PROFILE_GENERIC_SECURITY

static

Loads the DDS Secure builtin plugins.

The DDS Secure builtin plugins allow the DDS middleware to invoke security operations during critical DDS operations. These operations do not depend on any particular transport. This profile also enhances the discovery reliability settings to improve performance during discovery.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB

String-version: "Generic.Security"

final String BUILTIN_QOS_LIB_EXP

static

A library of experimental QoS profiles.

Experimental profiles are new profiles that have been tested internally but have not gone through an extensive validation period. Therefore some of the settings may change in future releases based on customer and internal feedback. After validation, experimental profiles will be moved into the non-experimental library.

String-version: "BuiltinQosLibExp"

final String PROFILE_GENERIC_STRICT_RELIABLE

static

Enables strict reliability.

This profile guarantees delivery of every published sample. Samples will not be overwritten, regardless of the com.rti.dds.infrastructure.HistoryQosPolicy.depth. Strict reliability ensures in-order delivery and retransmission of lost samples.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE

static

Enables keep-last reliability.

Like the Generic.StrictReliable profile, this profile ensures in-order delivery of samples. However, new data can overwrite data that has not yet been acknowledged by the reader, therefore causing possible sample loss.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable"

final String PROFILE_GENERIC_BEST_EFFORT

static

Enables best-effort reliability.

This profiles enables best-effort communication. No effort or resources are spent to track whether or not sent samples are received. Minimal resources are used. This is the most deterministic method of sending data since there is no indeterministic delay that can be introduced by resending data. Data samples may be lost. This setting is good for periodic data.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.BestEffort"

final String PROFILE_GENERIC_STRICT_RELIABLE_HIGH_THROUGHPUT

static

A profile that can be used to achieve high throughput.

This profile extends the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_STRICT_RELIABLE profile to perform additional, fine-grained performance tuning specific to applications that send continuously streaming data. The parameters specified here add to and/or override the parameters specified in the Generic.StrictReliable profile.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable.HighThroughput"

final String PROFILE_GENERIC_STRICT_RELIABLE_LOW_LATENCY

static

A profile that can be used to achieve low latency.

This profile extends the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_STRICT_RELIABLE profile to perform additional, fine-grained performance tuning specific to applications that send continuously streaming data. The parameters specified here add to and/or override the parameters specified in the Generic.StrictReliable profile.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable.LowLatency"

final String PROFILE_GENERIC_PARTICIPANT_LARGE_DATA

static

A common Participant base profile to facilitate sending large data.

This is a common Participant base profile that configures three flow controllers (fast, medium, and slow). Each one can be used to throttle application data flow at different rates.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.Participant.LargeData"

final String PROFILE_GENERIC_PARTICIPANT_LARGE_DATA_MONITORING

static

Configures Participants for large data and monitoring.

This is a common base Participant profile to configure participants to handle large data and use RTI Monitoring Library.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.Participant.LargeData.Monitoring"

See Also: com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_PARTICIPANT_LARGE_DATA; com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_MONITORING_COMMON

final String PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA

static

Configures endpoints for sending large data with strict reliability.

This profile extends the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_PARTICIPANT_LARGE_DATA profile to handle sending large samples while providing strict reliability. This profile optimizes the memory usage per sample within the middleware and enables asynchronous publication (necessary for strict reliability), but it does not perform any flow control.

If you need flow control, consider using one of the three profiles (Generic.StrictReliable.LargeData.*Flow) that use this profile as a common base profile. Each of those three profiles use one of the three flow controllers (fast, medium, or slow) defined in com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_PARTICIPANT_LARGE_DATA to throttle application data flow.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable.LargeData"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA

static

Configures endpoints for sending large data with keep-last reliability.

This profile is similar to the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA profile but inherits from Generic.StrictReliable.LargeData in order to handle sending large data. You can use this profile directly, which enables the default flow controller (that is, NO flow control) or use one of three profiles (Generic.KeepLastReliable.LargeData.*Flow) that use this profile as a common base profile. Each of those three profiles use one of the three flow controllers defined in com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_PARTICIPANT_LARGE_DATA to throttle application data flow.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.LargeData"

final String PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_FAST_FLOW

static

Configures strictly reliable communication for large data with a fast flow controller.

This profile configures strictly reliable communication for large data with a 100 MB/sec (838 Mb/sec) flow controller.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable.LargeData.FastFlow"

final String PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_MEDIUM_FLOW

static

Configures strictly reliable communication for large data with a medium flow controller.

This profile configures strictly reliable communication for large data with a 25 MB/sec (209 Mb/sec) flow controller.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable.LargeData.MediumFlow"

final String PROFILE_GENERIC_STRICT_RELIABLE_LARGE_DATA_SLOW_FLOW

static

Configures strictly reliable communication for large data with a slow flow controller.

This profile configures strictly reliable communication for large data with a 6.25 MB/sec (52 Mb/sec) flow controller.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.StrictReliable.LargeData.SlowFlow"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA_FAST_FLOW

static

Configures keep-last reliable communication for large data with a fast flow controller.

This profile configures keep-last reliable communication for large data with a 100 MB/sec (838 Mb/sec) flow controller.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.LargeData.FastFlow"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA_MEDIUM_FLOW

static

Configures keep-last reliable communication for large data with a medium flow controller.

This profile configures keep-last reliable communication for large data with a 25 MB/sec (209 Mb/sec) flow controller.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.LargeData.MediumFlow"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_LARGE_DATA_SLOW_FLOW

static

Configures keep-last reliable communication for large data with a slow flow controller.

This profile configures keep-last reliable communication for large data with a 6.25 MB/sec (52 Mb/sec) flow controller.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.LargeData.SlowFlow"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_TRANSIENT_LOCAL

static

Persists the samples of a DataWriter as long as the entity exists.

This profile extends the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_KEEP_LAST_RELIABLE profile, but persists the samples of a com.rti.dds.publication.DataWriter as long as the entity exists in order to deliver them to late-joining DataReaders.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.TransientLocal"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_TRANSIENT

static

Persists samples using RTI Persistence Service.

This profile extends the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_KEEP_LAST_RELIABLE profile, but persists samples using Persistence Service in order to deliver them to late-joining DataReaders.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.Transient"

final String PROFILE_GENERIC_KEEP_LAST_RELIABLE_PERSISTENT

static

Persists samples in permanent storage, like a disk, using RTI Persistence Service.

This profile extends the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_KEEP_LAST_RELIABLE profile, but persists samples in permanent storage, such as a disk, using Persistence Service in order to deliver them to late-joining DataReaders.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.KeepLastReliable.Persistent"

final String PROFILE_GENERIC_AUTO_TUNING

static

Enables the Turbo Mode batching and Auto Throttle experimental features.

Turbo Mode batching adjusts the maximum number of bytes of a batch based on how frequently samples are being written. Auto Throttle auto-adjusts the speed at which a writer will write samples, based on the number of unacknowledged samples in its queue.

These features are designed to auto-adjust the publishing behavior within a system in order to achieve the best possible performance with regards to throughput and latency.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.AutoTuning"

final String PROFILE_GENERIC_MINIMAL_MEMORY_FOOTPRINT

static

Uses a set of QoS which reduces the memory footprint of the application.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Generic.MinimalMemoryFootprint"

final String PROFILE_PATTERN_PERIODIC_DATA

static

Used for applications that expect periodic data.

This profile is intended to be used for applications that expect periodic data such as sensor data. The deadline that is set in this profile can be used to detect when DataWriters are not publishing data with the expected periodicity.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.PeriodicData"

final String PROFILE_PATTERN_STREAMING

static

Used for applications that stream data.

The data sent in streaming applications is commonly periodic. Therefore this profile simply inherits from the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_PATTERN_PERIODIC_DATA profile. Note: With this profile, the application may lose data, which may be acceptable in use cases such as video conferencing.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.Streaming"

final String PROFILE_PATTERN_RELIABLE_STREAMING

static

Used for applications that stream data and require reliable communication.

Sometimes streaming applications require reliable communication while still tolerating some data loss. In this case, we inherit from the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_KEEP_LAST_RELIABLE profile and increase the com.rti.dds.infrastructure.HistoryQosPolicy.depth to reduce the probability of losing samples.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.ReliableStreaming"

final String PROFILE_PATTERN_EVENT

static

Used for applications that handle events.

This profile can be used by applications in which samples represent events such as button pushes or alerts. When events are triggered, the system should almost always do something, meaning that we do not want to lose the event. Thus, there is a need for strictly reliable communication. Therefore, we inherit from the com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_STRICT_RELIABLE profile. Since events and alerts are critical and non-periodic data, it is important to detect situations in which communication between a com.rti.dds.publication.DataWriter and com.rti.dds.subscription.DataReader is broken. This is why this profile sets the com.rti.dds.infrastructure.LivelinessQosPolicy. If the com.rti.dds.publication.DataWriter does not assert its liveliness in a timely manner, the com.rti.dds.subscription.DataReader will report 'loss of liveliness' to the application.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.Event"

final String PROFILE_PATTERN_ALARM_EVENT

static

Used for applications which handle alarm events.

An alarm is a type of event; therefore this profile simply inherits from com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_PATTERN_EVENT.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.AlarmEvent"

final String PROFILE_PATTERN_STATUS

static

Used for applications whose samples represent statuses.

This profile can be used by applications in which samples represent state variables whose values remain valid as long as they don't explicitly change. State variables typically do not change periodically. State variables and their values should also be available to applications that appear after the value originally changed because it is unreasonable to have to wait until the next change of state, which may be indeterminate.

Whether to use this profile or Pattern.PeriodicData can often be an application choice. For example, if a DataWriter is publishing temperature sensor data, it could use the Pattern.PeriodicData profile and publish the data at a fixed rate or it could use the Pattern.Status profile and only publish the temperature when it changes more than 1 degree.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.Status"

final String PROFILE_PATTERN_ALARM_STATUS

static

Used for applications in which samples represent alarm statuses.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.AlarmStatus"

final String PROFILE_PATTERN_LAST_VALUE_CACHE

static

Used for applications that only need the last published value.

With this profile, a com.rti.dds.publication.DataWriter will keep in its queue the last value that was published for each sample instance. Late-joining DataReaders will get that value when they join the system. This profile inherits from com.rti.dds.infrastructure.BuiltinQosProfiles.PROFILE_GENERIC_KEEP_LAST_RELIABLE_TRANSIENT_LOCAL because the use case requires delivery to late-joiners.

In Library: com.rti.dds.infrastructure.BuiltinQosProfiles.BUILTIN_QOS_LIB_EXP

String-version: "Pattern.LastValueCache"

Classes

Variables

Detailed Description

Variable Documentation