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.
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 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.