System Properties

System Properties

Summary: System Properties

RTI Connext uses the DDS.PropertyQosPolicy of a DomainParticipant to maintain a set of properties that provide system information such as hostname.

Unless the default DDS.DomainParticipantQos value is overwritten, the system properties are automatically set in the DDS.DomainParticipantQos obtained by calling the procedure DDS.DomainParticipantFactory.get_default_participant_qos or using the constant DDS.PARTICIPANT_QOS_DEFAULT.

System properties are also automatically set in the DDS.DomainParticipantQos loaded from an XML QoS profile unless you disable property inheritance using the attribute inherit in the XML tag <property>.

By default, the system properties are propagated to other DomainParticipants in the system and can be accessed through DDS.ParticipantBuiltinTopicData.property.

You can disable the propagation of individual properties by setting the flag DDS.Property_t.propagate to DDS.BOOLEAN_FALSE or by removing the property using the procedure DDSPropertyQosPolicyHelper.remove_property.

The number of system properties set on the DDS.DomainParticipantQos is platform specific.

System Properties List

The following table lists the supported system properties. For more information, see Section 8.7, System Properties, in the Core Libraries and Utilities User's Manual.

Property Name Description
dds.sys_info.hostname Name of the host where the process is running
dds.sys_info.process_id Process ID
dds.sys_info.username Name of the user running the process
dds.sys_info.execution_timestamp Time when the execution started
dds.sys_info.creation_timestamp Time when the executable was created
dds.sys_info.executable_filepath Name and full path of the executable
dds.sys_info.target Architecture for which the library was compiled

System Resource Consideration

System properties are affected by the resource limits DDS.DomainParticipantResourceLimitsQosPolicy.participant_property_list_max_length and DDS.DomainParticipantResourceLimitsQosPolicy.participant_property_string_max_length.