[DISPATCH-639] Document proper usage of containerId for autoLinks/linkRoutes entities

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 0.7.0
• Fix Version/s: 0.8.0
• Component/s: Documentation
• Assignee: Ganesh Murthy
• Reporter: Matej Lesko
• Created: 23/Feb/17 17:14
• Updated: 02/Oct/19 17:55
• Resolved: 01/Mar/17 18:14

Description

Usage of containerId is shadowed from the user point of the view.
If you look at this code - https://github.com/apache/qpid-dispatch/blob/master/src/router_core/agent_config_auto_link.c#L413
you will see -

qd_parsed_field_t *in_use_conn = is_container ? container_field : connection_field;

which means if there is a container field, use it otherwise use the connection_field to specify the connection to use.

This is not specified in the documentation. It means that when user has created connector entity, assigned to the autoLink/linkRoute entity, this connector won't be used if containerId is specified.

Issue Links

• relates to: DISPATCH-641 Make containerId attribute work with clients