Previous Topic: How New Short Names are Created and Verified

Next Topic: LND Etautil Conventions

Configure the Location for Verifying Short Names

Normally, the new short name is checked for uniqueness in the available address books. However, you can configure Identity Manager to check the new short name's uniqueness in one or more other databases. To set this up, you need to edit a configuration file.

To change the database view used to verify short names

  1. Find CUSTOM_SHORTNAME_VALIDATION.connector.xml, in jcs-home/conf/override/lnd.

    Note: jcs-home is the installation location of the Java Connector Server. For more information, see Connector Configuration File and Default Installation Directories in Java Connector Server Implementation Guide.

  2. Copy the file into the same directory, and rename it to connector.xml.
  3. Open the new XML file, and find the <property name="shortNameSearchViews"> section, which is commented out.
  4. Remove the comment marks to activate the shortNameSearchViews section.
  5. Edit the <entry> section to point to the database view that contains the short names:
    <property name="shortNameSearchViews">
        <map>
            <entry key="database-name.nsf"><value>$view-name</value></entry>
        </map>
    </property>
    

    where

    database-name

    Specifies the name of a database in which to search for matching short names

    view-name

    Specifies the view in that database. You can specify only one view for each database.

    Note: To search multiple database views, add extra <entry> lines.

  6. Save the file.
  7. Restart the Java Connector Server.

Example: Point to multiple databases

<property name="shortNameSearchViews">
    <map>		        
       <entry key="db1.nsf"><value>$view1</value></entry>
  	<entry key="db2.nsf"><value>$view2</value></entry>
  	<entry key="db3.nsf"><value>$view3</value></entry>
    </map>
</property>