Before creating or attempting to execute any task instances, an application must initialize its connection with the Info*Engine Naming Service. The Naming Service enables the tasks executed by the application to locate adapters and other services deployed across the enterprise network. The Naming Service connection is established by calling a static factory method as follows:

This static factory method locates a Naming Service definition named “com.myCompany.namingService” (a Naming Service that serves a particular enterprise) in the LDAP directory. It searches the LDAP directory tree for the Naming Service definition. The root where the search starts is defined by the directory entry with the distinguished name dc=myCompany,dc=com and the host on which the LDAP server resides is named “ldap.mycompany.com”. This value could be a path to the ie.properties file or an LDAP URL that points to the place in the directory to find the properties. To avoid confusion it is best to point to the ie.properties file.

You must replace this Naming Service name, the distinguished name, and the LDAP host name with ones that apply to your network and LDAP directory structure. The LDAP directory structure and the Naming Service definition are typically created when the Info*Engine software is first installed.

Upon locating the Naming Service definition, the SAK reads its connection parameters, automatically loads all Info*Engine configuration properties from the LDAP directory service, and then returns control to the calling application. At that point, the application can create and execute task instances.