Return values

Lookup operations are expected to return values. The format of the return data is described below.

  No Hits One Hit Multiple Hits
Directories DSML DSML DSML
Naming Repositories No data Raw data DSML

Lookups on a specific name in a naming repository might only return one hit. Lookups on a general domain within a naming repository return a collection of hits.

Each object returned from any lookup naming and directories is examined by the adapter. If it is a simple object, its value is returned. If it is not a simple object, it is stored in the Object Pool and its reference id is returned.

Multiple values return data similar to the following:

<dsml:dsml xmlns:dsml="http://www.dsml.org/DSML"> 
 <dsml:directory-entries>
    <dsml:entry dn="cn=Test, o=IBM Software, c=US">
     <dsml:objectclass>
      <dsml:oc-value>
         <![CDATA[ top ]]>
       </dsml:oc-value>
       </dsml:objectclass>
     <dsml:attr name="homepage">
         <dsml:value>
         <![CDATA[ www.ibm.com ]]>
         </dsml:value>
     </dsml:attr>
    <dsml:attr name="someObject">
     <dsml:value>
         <![CDATA[ Ref.786542 ]]>
     </dsml:value>
    </dsml:attr>
   </dsml:entry>
  </dsml:directory-entries>
</dsml:dsml>

Return data for a single value in a naming context is similar to the following:

Ref.786542

or

www.ibm.com