Naming the Adapter in Webject INSTANCE Parameters
You define the adapter name to use in the INSTANCE parameter when you configure the adapter through the Info*Engine Property Administration utility.
An adapter name can be one of the following forms:
• A simple name, which is defined in the Service Name field on the Info*Engine Property Administration LDAP form.
Simple names are stored in the ptcServiceName attribute of the adapter LDAP entry. To use a simple name, the adapter LDAP entry must reside within the Naming Service search path.
For example, assume that "com.myCompany.myHost.jdbcAdapter" is the ptcServiceName attribute of the adapter LDAP entry in the Naming Service search path. Then, the following INSTANCE parameter can be used:
<ie:param name="INSTANCE" data="com.myCompany.myHost.jdbcAdapter"/>
• A fully qualified distinguished name.
When configuring the adapter, you specify the distinguished name on the Info*Engine Property Administration form. This name consists of the ptcServiceName attribute and the other attributes that define the location of the LDAP entry.
For example if the "com.myCompany.myHost.jdbcAdapter" entry is located on "host1" at "dc=IeProps,dc=myHost,dc=myCompany, dc=com,ou=Applications,o=myCompany" then the distinguished name is used in the INSTANCE parameter in the following form:
<ie:param name="INSTANCE" data="ldap://host1/
ptcServiceName=com.myCompany.myHost.jdbcAdapter,
dc=IeProps,dc=myHost,dc=myCompany,dc=com,
ou=Applications,o=myCompany"/>
ptcServiceName=com.myCompany.myHost.jdbcAdapter,
dc=IeProps,dc=myHost,dc=myCompany,dc=com,
ou=Applications,o=myCompany"/>
• A domain-based reference name.
This name is just another way of identifying the distinguished name when the LDAP directory that has the Info*Engine entries is constructed using dc=com as a root-level entry and other dc attributes for subtree entries.
The format of a Info*Engine domain-based reference name is:
ptcServiceName@dc_attributes
◦ ptcServiceName is the value of the ptcServiceName attribute.
◦ dc_attributes are the dc attributes that make up the domain location of the LDAP entry. Each attribute is separated from the next attribute using a period.
 |
The domain-based reference name can only be used when the LDAP directory that has the Info*Engine entries is constructed using dc=com as a root-level directory or when the Naming Service .serviceDomainBase property is set to include those attributes beyond the domain that are used in the distinguished name of the entry.
For example, if the ptcServiceName attribute value is "com.myCompany.myHost.jdbcAdapter" and the entry is located in the "dc=myHost,dc=myCompany,dc=com,ou=Applications, o=myCompany" branch, then the following domain-based reference name could only be used in the INSTANCE parameter if the .serviceDomainBase property is set to "ou=Applications,o=myCompany":
<ie:param name="INSTANCE" data="com.myCompany.myHost.
jdbcAdapter@myHost.myCompany.com"/> |