RTI Connext Java API  Version 5.0.0
DomainParticipantResourceLimitsQosPolicy Class Reference

Various settings that configure how a com.rti.dds.domain.DomainParticipant allocates and uses physical memory for internal resources, including the maximum sizes of various properties. More...

Inheritance diagram for DomainParticipantResourceLimitsQosPolicy:
QosPolicy

Public Attributes

final AllocationSettings_t local_writer_allocation
 Allocation settings applied to local DataWriters.
 
final AllocationSettings_t local_reader_allocation
 Allocation settings applied to local DataReaders.
 
final AllocationSettings_t local_publisher_allocation
 Allocation settings applied to local Publisher.
 
final AllocationSettings_t local_subscriber_allocation
 Allocation settings applied to local Subscriber.
 
final AllocationSettings_t local_topic_allocation
 Allocation settings applied to local Topic.
 
final AllocationSettings_t remote_writer_allocation
 Allocation settings applied to remote DataWriters.
 
final AllocationSettings_t remote_reader_allocation
 Allocation settings applied to remote DataReaders.
 
final AllocationSettings_t remote_participant_allocation
 Allocation settings applied to remote DomainParticipants.
 
final AllocationSettings_t matching_writer_reader_pair_allocation
 Allocation settings applied to matching local writer and remote/local reader pairs.
 
final AllocationSettings_t matching_reader_writer_pair_allocation
 Allocation settings applied to matching local reader and remote/local writer pairs.
 
final AllocationSettings_t ignored_entity_allocation
 Allocation settings applied to ignored entities.
 
final AllocationSettings_t content_filtered_topic_allocation
 Allocation settings applied to content filtered topic.
 
final AllocationSettings_t content_filter_allocation
 Allocation settings applied to content filter.
 
final AllocationSettings_t read_condition_allocation
 Allocation settings applied to read condition pool.
 
final AllocationSettings_t query_condition_allocation
 Allocation settings applied to query condition pool.
 
final AllocationSettings_t outstanding_asynchronous_sample_allocation
 Allocation settings applied to the maximum number of samples (from all com.rti.dds.publication.DataWriter) waiting to be asynchronously written.
 
final AllocationSettings_t flow_controller_allocation
 Allocation settings applied to flow controllers.
 
int local_writer_hash_buckets
 Hash_Buckets settings applied to local DataWriters.
 
int local_reader_hash_buckets
 Number of hash buckets for local DataReaders.
 
int local_publisher_hash_buckets
 Number of hash buckets for local Publisher.
 
int local_subscriber_hash_buckets
 Number of hash buckets for local Subscriber.
 
int local_topic_hash_buckets
 Number of hash buckets for local Topic.
 
int remote_writer_hash_buckets
 Number of hash buckets for remote DataWriters.
 
int remote_reader_hash_buckets
 Number of hash buckets for remote DataReaders.
 
int remote_participant_hash_buckets
 Number of hash buckets for remote DomainParticipants.
 
int matching_writer_reader_pair_hash_buckets
 Number of hash buckets for matching local writer and remote/local reader pairs.
 
int matching_reader_writer_pair_hash_buckets
 Number of hash buckets for matching local reader and remote/local writer pairs.
 
int ignored_entity_hash_buckets
 Number of hash buckets for ignored entities.
 
int content_filtered_topic_hash_buckets
 Number of hash buckets for content filtered topics.
 
int content_filter_hash_buckets
 Number of hash buckets for content filters.
 
int flow_controller_hash_buckets
 Number of hash buckets for flow controllers.
 
int max_gather_destinations
 Maximum number of destinations per RTI Connext send.
 
int participant_user_data_max_length
 Maximum length of user data in com.rti.dds.domain.DomainParticipantQos and builtin.ParticipantBuiltinTopicData.
 
int topic_data_max_length
 Maximum length of topic data in com.rti.dds.topic.TopicQos, builtin.TopicBuiltinTopicData, builtin.PublicationBuiltinTopicData and builtin.SubscriptionBuiltinTopicData.
 
int publisher_group_data_max_length
 Maximum length of group data in com.rti.dds.publication.PublisherQos and builtin.PublicationBuiltinTopicData.
 
int subscriber_group_data_max_length
 Maximum length of group data in com.rti.dds.subscription.SubscriberQos and builtin.SubscriptionBuiltinTopicData.
 
int writer_user_data_max_length
 Maximum length of user data in com.rti.dds.publication.DataWriterQos and builtin.PublicationBuiltinTopicData.
 
int reader_user_data_max_length
 Maximum length of user data in com.rti.dds.subscription.DataReaderQos and builtin.SubscriptionBuiltinTopicData.
 
int max_partitions
 Maximum number of partition name strings allowable in a com.rti.dds.infrastructure.PartitionQosPolicy.
 
int max_partition_cumulative_characters
 Maximum number of combined characters allowable in all partition names in a com.rti.dds.infrastructure.PartitionQosPolicy.
 
int type_code_max_serialized_length
 Maximum size of serialized string for type code.
 
int type_object_max_serialized_length
 The maximum length, in bytes, that the buffer to serialize a TypeObject can consume.
 
int type_object_max_deserialized_length
 The maximum number of bytes that a deserialized TypeObject can consume.
 
int deserialized_type_object_dynamic_allocation_threshold
 A threshold, in bytes, for dynamic memory allocation for the deserialized TypeObject.
 
int contentfilter_property_max_length
 This field is the maximum length of all data related to a Content-filtered topic.
 
int channel_seq_max_length
 Maximum number of channels that can be specified in com.rti.dds.infrastructure.MultiChannelQosPolicy for MultiChannel DataWriters.
 
int channel_filter_expression_max_length
 Maximum length of a channel com.rti.dds.infrastructure.ChannelSettings_t.filter_expression in a MultiChannel DataWriter.
 
int participant_property_list_max_length
 Maximum number of properties associated with the com.rti.dds.domain.DomainParticipant.
 
int participant_property_string_max_length
 Maximum string length of the properties associated with the com.rti.dds.domain.DomainParticipant.
 
int writer_property_list_max_length
 Maximum number of properties associated with a com.rti.dds.publication.DataWriter.
 
int writer_property_string_max_length
 Maximum string length of the properties associated with a com.rti.dds.publication.DataWriter.
 
int reader_property_list_max_length
 Maximum number of properties associated with a com.rti.dds.subscription.DataReader.
 
int reader_property_string_max_length
 Maximum string length of the properties associated with a com.rti.dds.subscription.DataReader.
 
int max_endpoint_groups
 Maximum number of com.rti.dds.infrastructure.EndpointGroup_t allowable in a com.rti.dds.infrastructure.AvailabilityQosPolicy.
 
int max_endpoint_group_cumulative_characters
 Maximum number of combined role_name characters allowable in all com.rti.dds.infrastructure.EndpointGroup_t in a com.rti.dds.infrastructure.AvailabilityQosPolicy.
 
- Public Attributes inherited from QosPolicy
final QosPolicyId_t id
 The ID of this QoS policy.
 
final String policy_name
 The name of this QoS policy.
 

Additional Inherited Members

- Public Member Functions inherited from Struct
abstract boolean equals (Object obj)
 
abstract int hashCode ()
 
String toString ()
 
- Protected Member Functions inherited from Struct
 Struct ()
 
abstract void pull_from_nativeI (long native_status)
 
abstract void push_to_nativeI (long native_status)
 

Detailed Description

Various settings that configure how a com.rti.dds.domain.DomainParticipant allocates and uses physical memory for internal resources, including the maximum sizes of various properties.

This QoS policy sets maximum size limits on variable-length parameters used by the participant and its contained Entities. It also controls the initial and maximum sizes of data structures used by the participant to store information about locally-created and remotely-discovered entities (such as DataWriters/DataReaders), as well as parameters used by the internal database to size the hash tables it uses.

By default, a com.rti.dds.domain.DomainParticipant is allowed to dynamically allocate memory as needed as users create local Entities such as com.rti.dds.publication.DataWriter and com.rti.dds.subscription.DataReader objects or as the participant discovers new applications. By setting fixed values for the maximum parameters in this QoS policy, you can bound the memory that can be allocated by a com.rti.dds.domain.DomainParticipant. In addition, by setting the initial values to the maximum values, you can prevent DomainParticipants from allocating memory after the initialization period.

The maximum sizes of different variable-length parameters such as the number of partitions that can be stored in the com.rti.dds.infrastructure.PartitionQosPolicy, the maximum length of data store in the com.rti.dds.infrastructure.UserDataQosPolicy and com.rti.dds.infrastructure.GroupDataQosPolicy, and many others can be changed from their defaults using this QoS policy. However, it is important that all DomainParticipants that need to communicate with each other use the same set of maximum values. Otherwise, when these parameters are propagated from one com.rti.dds.domain.DomainParticipant to another, a com.rti.dds.domain.DomainParticipant with a smaller maximum length may reject the parameter, resulting in an error.

An important parameter in this QoS policy that is often changed by users is com.rti.dds.infrastructure.DomainParticipantResourceLimitsQosPolicy.type_code_max_serialized_length.

This QoS policy is an extension to the DDS standard.

Entity:
com.rti.dds.domain.DomainParticipant
Properties:
RxO = N/A
Changeable = NO

Member Data Documentation

final AllocationSettings_t local_writer_allocation

Allocation settings applied to local DataWriters.

[default] initial_count = 16; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t local_reader_allocation

Allocation settings applied to local DataReaders.

[default] initial_count = 16; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t local_publisher_allocation

Allocation settings applied to local Publisher.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t local_subscriber_allocation

Allocation settings applied to local Subscriber.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t local_topic_allocation

Allocation settings applied to local Topic.

[default] initial_count = 16; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t remote_writer_allocation

Allocation settings applied to remote DataWriters.

Remote DataWriters include all DataWriters, both local and remote.

[default] initial_count = 64; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t remote_reader_allocation

Allocation settings applied to remote DataReaders.

Remote DataReaders include all DataReaders, both local and remote.

[default] initial_count = 64; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t remote_participant_allocation

Allocation settings applied to remote DomainParticipants.

Remote DomainParticipants include all DomainParticipants, both local and remote.

[default] initial_count = 16; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t matching_writer_reader_pair_allocation

Allocation settings applied to matching local writer and remote/local reader pairs.

[default] initial_count = 32; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t matching_reader_writer_pair_allocation

Allocation settings applied to matching local reader and remote/local writer pairs.

[default] initial_count = 32; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t ignored_entity_allocation

Allocation settings applied to ignored entities.

[default] initial_count = 8; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t content_filtered_topic_allocation

Allocation settings applied to content filtered topic.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t content_filter_allocation

Allocation settings applied to content filter.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t read_condition_allocation

Allocation settings applied to read condition pool.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t query_condition_allocation

Allocation settings applied to query condition pool.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t outstanding_asynchronous_sample_allocation

Allocation settings applied to the maximum number of samples (from all com.rti.dds.publication.DataWriter) waiting to be asynchronously written.

[default] initial_count = 64; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

final AllocationSettings_t flow_controller_allocation

Allocation settings applied to flow controllers.

[default] initial_count = 4; max_count = com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct com.rti.dds.infrastructure.AllocationSettings_t

int local_writer_hash_buckets

Hash_Buckets settings applied to local DataWriters.

[default] 4

[range] [1, 10000]

int local_reader_hash_buckets

Number of hash buckets for local DataReaders.

[default] 4

[range] [1, 10000]

int local_publisher_hash_buckets

Number of hash buckets for local Publisher.

[default] 1

[range] [1, 10000]

int local_subscriber_hash_buckets

Number of hash buckets for local Subscriber.

[default] 1

[range] [1, 10000]

int local_topic_hash_buckets

Number of hash buckets for local Topic.

[default] 4

[range] [1, 10000]

int remote_writer_hash_buckets

Number of hash buckets for remote DataWriters.

Remote DataWriters include all DataWriters, both local and remote.

[default] 16

[range] [1, 10000]

int remote_reader_hash_buckets

Number of hash buckets for remote DataReaders.

Remote DataReaders include all DataReaders, both local and remote.

[default] 16

[range] [1, 10000]

int remote_participant_hash_buckets

Number of hash buckets for remote DomainParticipants.

Remote DomainParticipants include all DomainParticipants, both local and remote.

[default] 4

[range] [1, 10000]

int matching_writer_reader_pair_hash_buckets

Number of hash buckets for matching local writer and remote/local reader pairs.

[default] 32

[range] [1, 10000]

int matching_reader_writer_pair_hash_buckets

Number of hash buckets for matching local reader and remote/local writer pairs.

[default] 32

[range] [1, 10000]

int ignored_entity_hash_buckets

Number of hash buckets for ignored entities.

[default] 1

[range] [1, 10000]

int content_filtered_topic_hash_buckets

Number of hash buckets for content filtered topics.

[default] 1

[range] [1, 10000]

int content_filter_hash_buckets

Number of hash buckets for content filters.

[default] 1

[range] [1, 10000]

int flow_controller_hash_buckets

Number of hash buckets for flow controllers.

[default] 1

[range] [1, 10000]

int max_gather_destinations

Maximum number of destinations per RTI Connext send.

When RTI Connext sends out a message, it has the capability to send to multiple destinations to be more efficient. The maximum number of destinations per RTI Connext send is specified by max_gather_destinations.

[default] 8

[range] [4, 1 million]

int participant_user_data_max_length

Maximum length of user data in com.rti.dds.domain.DomainParticipantQos and builtin.ParticipantBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

int topic_data_max_length

Maximum length of topic data in com.rti.dds.topic.TopicQos, builtin.TopicBuiltinTopicData, builtin.PublicationBuiltinTopicData and builtin.SubscriptionBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

int publisher_group_data_max_length

Maximum length of group data in com.rti.dds.publication.PublisherQos and builtin.PublicationBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

int subscriber_group_data_max_length

Maximum length of group data in com.rti.dds.subscription.SubscriberQos and builtin.SubscriptionBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

int writer_user_data_max_length

Maximum length of user data in com.rti.dds.publication.DataWriterQos and builtin.PublicationBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

int reader_user_data_max_length

Maximum length of user data in com.rti.dds.subscription.DataReaderQos and builtin.SubscriptionBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

int max_partitions

Maximum number of partition name strings allowable in a com.rti.dds.infrastructure.PartitionQosPolicy.

This setting is made on a per DomainParticipant basis; it cannot be set individually on a per Publisher/Subscriber basis. However, the limit is enforced and applies per Publisher/Subscriber.

This value cannot exceed 64.

[default] 64

[range] [0,64]

int max_partition_cumulative_characters

Maximum number of combined characters allowable in all partition names in a com.rti.dds.infrastructure.PartitionQosPolicy.

The maximum number of combined characters should account for a terminating NULL ('\0') character for each partition name string.

This setting is made on a per DomainParticipant basis; it cannot be set individually on a per Publisher/Subscriber basis. However, the limit is enforced and applies per Publisher/Subscriber.

This value cannot exceed 256.

[default] 256

[range] [0,256]

int type_code_max_serialized_length

Maximum size of serialized string for type code.

This parameter limits the size of the type code that a com.rti.dds.domain.DomainParticipant is able to store and propagate for user data types. Type codes can be used by external applications to understand user data types without having the data type predefined in compiled form. However, since type codes contain all of the information of a data structure, including the strings that define the names of the members of a structure, complex data structures can result in type codes larger than the default maximum of 2048 bytes. So it is common for users to set this parameter to a larger value. However, as with all parameters in this QoS policy defining maximum sizes for variable-length elements, all DomainParticipants in the same domain should use the same value for this parameter.

[default] 2048

[range] [0,0xffff]

int type_object_max_serialized_length

The maximum length, in bytes, that the buffer to serialize a TypeObject can consume.

This parameter limits the size of the TypeObject that a DomainParticipant is able to propagate. Since TypeObjects contain all of the information of a data structure, including the strings that define the names of the members of a structure, complex data structures can result in TypeObjects larger than the default maximum of 3072 bytes. This field allows you to specify a larger value.

[default] 3072

[range] [0,0x7fffffff] or com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED

int type_object_max_deserialized_length

The maximum number of bytes that a deserialized TypeObject can consume.

This parameter limits the size of the TypeObject that a DomainParticipant is able to store.

[default] com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED

[range] [0,0x7fffffff] or com.rti.dds.infrastructure.ResourceLimitsQosPolicy.LENGTH_UNLIMITED

int deserialized_type_object_dynamic_allocation_threshold

A threshold, in bytes, for dynamic memory allocation for the deserialized TypeObject.

Above this threshold, the memory for a TypeObject is allocated dynamically. Below it, the memory is obtained from a pool of fixed-size buffers. The size of the buffers is equal to this threshold.

[default] 4096

[range] [0,0x7fffffff] <= com.rti.dds.infrastructure.DomainParticipantResourceLimitsQosPolicy.type_object_max_deserialized_length

int contentfilter_property_max_length

This field is the maximum length of all data related to a Content-filtered topic.

This is the sum of the length of the content filter name, the length of the related topic name, the length of the filter expression, the length of the filter parameters, and the length of the filter name. The maximum number of combined characters should account for a terminating NULL ('\0') character for each string.

[default] 256

[range] [0,0xffff]

int channel_seq_max_length

Maximum number of channels that can be specified in com.rti.dds.infrastructure.MultiChannelQosPolicy for MultiChannel DataWriters.

[default] 32

[range] [0,0xffff]

int channel_filter_expression_max_length

Maximum length of a channel com.rti.dds.infrastructure.ChannelSettings_t.filter_expression in a MultiChannel DataWriter.

The length should account for a terminating NULL ('\0') character.

[default] 256

[range] [0,0xffff]

int participant_property_list_max_length

Maximum number of properties associated with the com.rti.dds.domain.DomainParticipant.

[default] 32

[range] [0,0xffff]

int participant_property_string_max_length

Maximum string length of the properties associated with the com.rti.dds.domain.DomainParticipant.

The string length is defined as the cumulative length in bytes, including the null terminating characters, of all the pair (name,value) associated with the com.rti.dds.domain.DomainParticipant properties.

[default] 1024

[range] [0,0xffff]

int writer_property_list_max_length

Maximum number of properties associated with a com.rti.dds.publication.DataWriter.

[range] [0,0xffff]

[default] 32

int writer_property_string_max_length

Maximum string length of the properties associated with a com.rti.dds.publication.DataWriter.

The string length is defined as the cumulative length in bytes, including the null terminating characters, of all the pair (name,value) associated with the com.rti.dds.publication.DataWriter properties.

[default] 1024

[range] [0,0xffff]

int reader_property_list_max_length

Maximum number of properties associated with a com.rti.dds.subscription.DataReader.

[default] 32

[range] [0,0xffff]

int reader_property_string_max_length

Maximum string length of the properties associated with a com.rti.dds.subscription.DataReader.

The string length is defined as the cumulative length in bytes, including the null terminating characters, of all the pair (name,value) associated with a com.rti.dds.subscription.DataReader properties.

[default] 1024

[range] [0,0xffff]

int max_endpoint_groups

Maximum number of com.rti.dds.infrastructure.EndpointGroup_t allowable in a com.rti.dds.infrastructure.AvailabilityQosPolicy.

[default] 32

[range] [0,65535]

int max_endpoint_group_cumulative_characters

Maximum number of combined role_name characters allowable in all com.rti.dds.infrastructure.EndpointGroup_t in a com.rti.dds.infrastructure.AvailabilityQosPolicy.

The maximum number of combined characters should account for a terminating NULL character for each role_name string.

[default] 1024

[range] [0,65535]


RTI Connext Java API Version 5.0.0 Copyright © Thu Aug 30 2012 Real-Time Innovations, Inc