Defining INSTANCE Names for Adapters

In conjunction with defining the conventions for how your site names Info*Engine components such as adapters and gateways, you must communicate to your user community which names they should use to access the adapters and gateways. These names are specified in the data value for the INSTANCE parameter on adapter webjects.

• A simple name as defined in the ptcServiceName attribute of the LDAP entry. This name can be used when the entry is in the Naming Service search path. For example if the ptcServiceName attribute is set to “com.myCompany.myHost.jdbcAdpt”, then the INSTANCE data value is the following:

• A fully-qualified distinguished name. This name can be used to locate a specific Info*Engine LDAP entry that is anywhere in the LDAP directory.

For example if the “com.myCompany.myHost.jdbcAdpt” entry is located at “dc=myHost,dc=myCompany,dc=com,ou=Applications,o=myCompany” then the distinguished name is used in the following form:

ptcServiceName=com.myCompany.myHost.jdbcAdpt,dc=myHost,dc=myCompany,
dc=com,ou=Applications,o=myCompany

In this format, ptcServiceName is the value of the ptcServiceName attribute and dc_attributes are the dc attributes that make up the domain location of the LDAP entry, where 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.jdbcAdpt” 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 if the .serviceDomainBase property is set to “ou=Applications,o=myCompany”:

Use the Info*Engine Property Administration utility to set the .serviceDomainBase property. For more information, see the property help in the Property Administration utility.

Usually, entering the simple name that is defined in ptcServiceName attribute works well for the INSTANCE parameter value. However, you must look at how you are constructing the Info*Engine LDAP entries and where the entries are located relative to the Naming Service search path to determine the best strategy for your site.