DDS::DomainParticipantResourceLimitsQosPolicy Struct Reference
[DOMAIN_PARTICIPANT_RESOURCE_LIMITS]

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

#include <managed_infrastructure.h>

List of all members.

Static Public Member Functions

static System::String^ get_domainparticipantresourcelimits_qos_policy_name ()
 Stringified human-readable name for DDS::DomainParticipantResourceLimitsQosPolicy.

Public Attributes

AllocationSettings_t local_writer_allocation
 Allocation settings applied to local DataWriters.
AllocationSettings_t local_reader_allocation
 Allocation settings applied to local DataReaders.
AllocationSettings_t local_publisher_allocation
 Allocation settings applied to local Publisher.
AllocationSettings_t local_subscriber_allocation
 Allocation settings applied to local Subscriber.
AllocationSettings_t local_topic_allocation
 Allocation settings applied to local Topic.
AllocationSettings_t remote_writer_allocation
 Allocation settings applied to remote DataWriters.
AllocationSettings_t remote_reader_allocation
 Allocation settings applied to remote DataReaders.
AllocationSettings_t remote_participant_allocation
 Allocation settings applied to remote DomainParticipants.
AllocationSettings_t matching_writer_reader_pair_allocation
 Allocation settings applied to matching local writer and remote/local reader pairs.
AllocationSettings_t matching_reader_writer_pair_allocation
 Allocation settings applied to matching local reader and remote/local writer pairs.
AllocationSettings_t ignored_entity_allocation
 Allocation settings applied to ignored entities.
AllocationSettings_t content_filtered_topic_allocation
 Allocation settings applied to content filtered topic.
AllocationSettings_t content_filter_allocation
 Allocation settings applied to content filter.
AllocationSettings_t read_condition_allocation
 Allocation settings applied to read condition pool.
AllocationSettings_t query_condition_allocation
 Allocation settings applied to query condition pool.
AllocationSettings_t outstanding_asynchronous_sample_allocation
 Allocation settings applied to the maximum number of samples (from all DDS::DataWriter) waiting to be asynchronously written.
AllocationSettings_t flow_controller_allocation
 Allocation settings applied to flow controllers.
System::Int32 local_writer_hash_buckets
 Hash_Buckets settings applied to local DataWriters.
System::Int32 local_reader_hash_buckets
 Number of hash buckets for local DataReaders.
System::Int32 local_publisher_hash_buckets
 Number of hash buckets for local Publisher.
System::Int32 local_subscriber_hash_buckets
 Number of hash buckets for local Subscriber.
System::Int32 local_topic_hash_buckets
 Number of hash buckets for local Topic.
System::Int32 remote_writer_hash_buckets
 Number of hash buckets for remote DataWriters.
System::Int32 remote_reader_hash_buckets
 Number of hash buckets for remote DataReaders.
System::Int32 remote_participant_hash_buckets
 Number of hash buckets for remote DomainParticipants.
System::Int32 matching_writer_reader_pair_hash_buckets
 Number of hash buckets for matching local writer and remote/local reader pairs.
System::Int32 matching_reader_writer_pair_hash_buckets
 Number of hash buckets for matching local reader and remote/local writer pairs.
System::Int32 ignored_entity_hash_buckets
 Number of hash buckets for ignored entities.
System::Int32 content_filtered_topic_hash_buckets
 Number of hash buckets for content filtered topics.
System::Int32 content_filter_hash_buckets
 Number of hash buckets for content filters.
System::Int32 flow_controller_hash_buckets
 Number of hash buckets for flow controllers.
System::Int32 max_gather_destinations
 Maximum number of destinations per RTI Data Distribution Service send.
System::Int32 participant_user_data_max_length
 Maximum length of user data in DDS::DomainParticipantQos and DDS::ParticipantBuiltinTopicData.
System::Int32 topic_data_max_length
 Maximum length of topic data in DDS::TopicQos, DDS::TopicBuiltinTopicData, DDS::PublicationBuiltinTopicData and DDS::SubscriptionBuiltinTopicData.
System::Int32 publisher_group_data_max_length
 Maximum length of group data in DDS::PublisherQos and DDS::PublicationBuiltinTopicData.
System::Int32 subscriber_group_data_max_length
 Maximum length of group data in DDS::SubscriberQos and DDS::SubscriptionBuiltinTopicData.
System::Int32 writer_user_data_max_length
 Maximum length of user data in DDS::DataWriterQos and DDS::PublicationBuiltinTopicData.
System::Int32 reader_user_data_max_length
 Maximum length of user data in DDS::DataReaderQos and DDS::SubscriptionBuiltinTopicData.
System::Int32 max_partitions
 Maximum number of partition name strings allowable in a DDS::PartitionQosPolicy.
System::Int32 max_partition_cumulative_characters
 Maximum number of combined characters allowable in all partition names in a DDS::PartitionQosPolicy.
System::Int32 type_code_max_serialized_length
 Maximum size of serialized string for type code.
System::Int32 contentfilter_property_max_length
 This field is the maximum length of all data related to a Content-filtered topic.
System::Int32 channel_seq_max_length
 Maximum number of channels that can be specified in DDS::MultiChannelQosPolicy for MultiChannel DataWriters.
System::Int32 channel_filter_expression_max_length
 Maximum length of a channel DDS::ChannelSettings_t::filter_expression in a MultiChannel DataWriter.
System::Int32 participant_property_list_max_length
 Maximum number of properties associated with the DDS::DomainParticipant.
System::Int32 participant_property_string_max_length
 Maximum string length of the properties associated with the DDS::DomainParticipant.
System::Int32 writer_property_list_max_length
 Maximum number of properties associated with a DDS::DataWriter.
System::Int32 writer_property_string_max_length
 Maximum string length of the properties associated with a DDS::DataWriter.
System::Int32 reader_property_list_max_length
 Maximum number of properties associated with a DDS::DataReader.
System::Int32 reader_property_string_max_length
 Maximum string length of the properties associated with a DDS::DataReader.


Detailed Description

Various settings that configure how a DDS::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 DDS::DomainParticipant is allowed to dynamically allocate memory as needed as users create local Entities such as DDS::DataWriter and DDS::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 DDS::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 DDS::PartitionQosPolicy, the maximum length of data store in the DDS::UserDataQosPolicy and DDS::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 DDS::DomainParticipant to another, a DDS::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 DDS::DomainParticipantResourceLimitsQosPolicy::type_code_max_serialized_length.

This QoS policy is an extension to the DDS standard.

Entity:
DDS::DomainParticipant
Properties:
RxO = N/A
Changeable = NO

Member Data Documentation

Allocation settings applied to local DataWriters.

[default] initial_count = 16; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to local DataReaders.

[default] initial_count = 16; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to local Publisher.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to local Subscriber.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to local Topic.

[default] initial_count = 16; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to remote DataWriters.

Remote DataWriters include all DataWriters, both local and remote.

[default] initial_count = 64; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to remote DataReaders.

Remote DataReaders include all DataReaders, both local and remote.

[default] initial_count = 64; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to remote DomainParticipants.

Remote DomainParticipants include all DomainParticipants, both local and remote.

[default] initial_count = 16; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

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

[default] initial_count = 32; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

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

[default] initial_count = 32; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to ignored entities.

[default] initial_count = 8; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to content filtered topic.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to content filter.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED; incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to read condition pool.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to query condition pool.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to the maximum number of samples (from all DDS::DataWriter) waiting to be asynchronously written.

[default] initial_count = 64; max_count = DDS::LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Allocation settings applied to flow controllers.

[default] initial_count = 4; max_count = DDS::LENGTH_UNLIMITED, incremental_count = -1

[range] See allowed ranges in struct DDS::AllocationSettings_t

Hash_Buckets settings applied to local DataWriters.

[default] 4

[range] [1, 10000]

Number of hash buckets for local DataReaders.

[default] 4

[range] [1, 10000]

Number of hash buckets for local Publisher.

[default] 1

[range] [1, 10000]

Number of hash buckets for local Subscriber.

[default] 1

[range] [1, 10000]

Number of hash buckets for local Topic.

[default] 4

[range] [1, 10000]

Number of hash buckets for remote DataWriters.

Remote DataWriters include all DataWriters, both local and remote.

[default] 16

[range] [1, 10000]

Number of hash buckets for remote DataReaders.

Remote DataReaders include all DataReaders, both local and remote.

[default] 16

[range] [1, 10000]

Number of hash buckets for remote DomainParticipants.

Remote DomainParticipants include all DomainParticipants, both local and remote.

[default] 4

[range] [1, 10000]

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

[default] 32

[range] [1, 10000]

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

[default] 32

[range] [1, 10000]

Number of hash buckets for ignored entities.

[default] 1

[range] [1, 10000]

Number of hash buckets for content filtered topics.

[default] 1

[range] [1, 10000]

Number of hash buckets for content filters.

[default] 1

[range] [1, 10000]

Number of hash buckets for flow controllers.

[default] 1

[range] [1, 10000]

Maximum number of destinations per RTI Data Distribution Service send.

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

[default] 8

[range] [4, 1 million]

Maximum length of user data in DDS::DomainParticipantQos and DDS::ParticipantBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

Maximum length of topic data in DDS::TopicQos, DDS::TopicBuiltinTopicData, DDS::PublicationBuiltinTopicData and DDS::SubscriptionBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

Maximum length of group data in DDS::PublisherQos and DDS::PublicationBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

Maximum length of group data in DDS::SubscriberQos and DDS::SubscriptionBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

Maximum length of user data in DDS::DataWriterQos and DDS::PublicationBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

Maximum length of user data in DDS::DataReaderQos and DDS::SubscriptionBuiltinTopicData.

[default] 256

[range] [0,0x7fffffff]

Maximum number of partition name strings allowable in a DDS::PartitionQosPolicy.

This value cannot exceed 64.

[default] 64

[range] [0,64]

Maximum number of combined characters allowable in all partition names in a DDS::PartitionQosPolicy.

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

This value cannot exceed 256.

[default] 256

[range] [0,256]

Maximum size of serialized string for type code.

This parameter limits the size of the type code that a DDS::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]

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]

Maximum number of channels that can be specified in DDS::MultiChannelQosPolicy for MultiChannel DataWriters.

[default] 32

[range] [0,0xffff]

Maximum length of a channel DDS::ChannelSettings_t::filter_expression in a MultiChannel DataWriter.

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

[default] 256

[range] [0,0xffff]

Maximum number of properties associated with the DDS::DomainParticipant.

[default] 32

[range] [0,0xffff]

Maximum string length of the properties associated with the DDS::DomainParticipant.

The string length is defined as the cumulative length in bytes of all the pair (name,value) associated with the DDS::DomainParticipant properties.

[default] 1024

[range] [0,0xffff]

Maximum number of properties associated with a DDS::DataWriter.

[range] [0,0xffff]

[default] 32

Maximum string length of the properties associated with a DDS::DataWriter.

The string length is defined as the cumulative length in bytes of all the pair (name,value) associated with the data writer properties.

[default] 1024

[range] [0,0xffff]

Maximum number of properties associated with a DDS::DataReader.

[default] 32

[range] [0,0xffff]

Maximum string length of the properties associated with a DDS::DataReader.

The string length is defined as the cumulative length in bytes of all the pair (name,value) associated with a DDS::DataReader properties.

[default] 1024

[range] [0,0xffff]


RTI Data Distribution Service .Net APIs Version 4.5c Copyright © 9 Jun 2010 Real-Time Innovations, Inc