RTI Connext Java API Version 7.1.0

System Properties.

System Properties.

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

Unless the default com.rti.dds.domain.DomainParticipantQos value is overwritten, the system properties are automatically set in the com.rti.dds.domain.DomainParticipantQos obtained by calling the method com.rti.dds.domain.DomainParticipantFactory.get_default_participant_qos or using the constant com.rti.dds.domain.DomainParticipantFactory.PARTICIPANT_QOS_DEFAULT.

System properties are also automatically set in the com.rti.dds.domain.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 builtin.ParticipantBuiltinTopicData.property.

You can disable the propagation of individual properties by setting the flag com.rti.dds.infrastructure.Property_t.propagate to com.rti.dds.infrastructure.false or by removing the property using the method com.rti.dds.infrastructure.PropertyQosPolicyHelper.remove_property.

The number of system properties set on the com.rti.dds.domain.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 com.rti.dds.infrastructure.DomainParticipantResourceLimitsQosPolicy.participant_property_list_max_length and com.rti.dds.infrastructure.DomainParticipantResourceLimitsQosPolicy.participant_property_string_max_length.