Issue 10670: Clarify usage of find_home_by_name (data-distribution-rtf)
Source: PrismTech (Mr. Erik Hendriks, erik.hendriks(at)prismtech.com)
Nature: Clarification
Severity: 
Summary: Problem:
In section 3.1.6.3.4 on page 3-23 in the description of the operation find_home_by_name of the Cache entity it states that an already registered home can be retrieved using its name. It should be clarified that this name is the fully qualified name (in IDL sense, with '::' as seperator). The name of ObjectHome for Object Foo which is defined in module test thus becomes 'test::Foo'.

Solution:

Replace:
o retrieve an already registered ObjectHome based on its name (find_home_by_name) or based on its index of registration (find_home_by_index). If no registered home can be found that satisfies the specified name or index, a NULL is returned.

With:
o retrieve an already registered ObjectHome based on its fully qualified name (in IDL sense, meaning for an ObjectHome representing class 'Foo' which was defined in module 'test' has the name "test::Foo") (find_home_by_name) or based on its index of registration (find_home_by_index). If no registered home can be found that satisfies the specified name or index, a NULL pointer is returned.

Resolution: 
Revised Text: 
Actions taken:
February 12, 2007: received issue
Discussion: 

End of Annotations:=====
s is issue # 10670

Clarify usage of find_home_by_name

Problem:
In section 3.1.6.3.4 on page 3-23 in the description of the operation find_home_by_name of the Cache entity it states that an already registered home can be retrieved using its name. It should be clarified that this name is the fully qualified name (in IDL sense, with '::' as seperator). The name of ObjectHome for Object Foo which is defined in module test thus becomes 'test::Foo'.

Solution:

Replace:
o retrieve an already registered ObjectHome based on its name (find_home_by_name) or based on its index of registration (find_home_by_index). If no registered home can be found that satisfies the specified name or index, a NULL is returned.

With:
o retrieve an already registered ObjectHome based on its fully qualified name (in IDL sense, meaning for an ObjectHome representing class 'Foo' which was defined in module 'test' has the name "test::Foo") (find_home_by_name) or based on its index of registration (find_home_by_index). If no registered home can be found that satisfies the specified name or index, a NULL pointer is returned.