Setup Eclipse Environment for OIM API debugging

1. OIM Design Console must be installed.  This setup uses the files installed by the OIM Design Console.
2. Add the Design Console JAR files to Eclipse:
   1. Select your project, then select Windows -> Preferences (Eclipse -> Properties on a Mac).
   2. Select Java, Build Path, User Libraries from the menu items on the left.
   3. Click the New button, and enter a library name (OIM API Library), then click OK.
   4. Click the Add Jars button, navigate to the "lib" directory where your OIM Design Console is installed (OIMDesignHome/xlclient/lib), and select all the jar files.  It is left as an exorcise to set the javadoc location -- these might be located somewhere in OIMDesignHome/documentation/SDK/javadocs.  If you find them, please update this page.
3. Add the User Library created in 2 to your Eclipses project:
   1. Select your project, then select Project -> Properties.
   2. Select Java Build Path from the menu items on the left.
   3. Select the Libraries tab.
   4. Click on the Add Library button, select User Library from the list, then Next.
   5. Select OIM API Library from the list, then click Finish.
4. Add the files in the Design Consoles "ext" directory to the class path, and set the VM Arguments:
   1. Select your project, then select Project -> Properties.
   2. Select Run/Debug Settings form the menu items on the left.
   3. If a launch configuration has not already been setup for your project, click on the New button and select Java Application as the type.  Otherwise, select your configuration and press the Edit button.
   4. On the Main tab, ensure that your Main class is set to the correct class file.
   5. On the Arguments tab, enter the following:

      -DXL.HomeDir=.
      -Djava.security.policy=config/xl.policy
      -Djava.security.auth.login.config=config/auth.conf
      -Dlog4j.configuration=config/log.properties

   6. Change the working directory to OIMDesignHome/xlclient.
   7. On the JRE tab, make sure that a 1.4.2 JVM is selected.  Otherwise you run the risk of using features not available to OIM.
   8. On the Classpath tab, select User Entries, then click on the Add External JARs button.
   9. Navigate to OIMDesignHome/xlclient/ext and select all the JAR files.
5. Eclipse is now configured to run and debug your code that uses the OIM API.