Programming Guide › Use the Java XML Agent Content Helper API › Implement the Java XML Agent Content Helper API › Code an XML-Enabled Java Agent

Code an XML-Enabled Java Agent

To write the source code for a custom XML-enabled agent using the XML Agent Content Helper API for Java

1. Review the required software as listed in the accompanying release notes.
2. Review the sample code.
3. Write source code for your client application.

Before You Compile an XML-Enabled Agent

Before you compile your agent application, ensure the following:

• Your system can find the JNI support library when the Java Virtual Machine (JVM) is invoked, as follows:
  • On Windows: Change PATH to include the following, so that smjavaagentapi.dll can be found:

    install_path\sdk\bin\win32

  • On Solaris: Change LD_LIBRARY_PATH to include the following, so that libsmjavaagentapi.so can be found:

    install_path/sdk/bin/solaris

  • On AIX: Change LIBPATH to include the following, so that libsmjavaagentapi.so can be found:

    install_path/sdk/bin/aix

  • On Linux: Change LD_LIBRARY_PATH to include the following, so that libsmjavaagentapi.so can be found:

    install_path/sdk/bin/Linux

    Note: Java agents on Linux require Java SDK v 1.3.1.

  • On HP-UX 11: Change SHLIB_PATH to include the following, so that libsmjavaagentapi.so can be found:

    install_path/sdk/bin/hpux/hpux11

    Note: The Java Agent API is not available for HP10.

• The CA SiteMinder Agent API JAR file (smjavaagentapi.jar) is available by adding it to your CLASSPATH setting. When compiling, you can use the -classpath switch. smjavaagentapi.jar, is stored in the following locations:
  • Windows platforms:

    install_path\sdk\java

  • UNIX platforms:

    install_path/sdk/java

• The XML Agent Content Helper API JAR file is available whenever you compile or run an agent that uses the Java Agent API. The JAR file, soasmapi.jar, is stored in the following locations:
  • Windows platforms:

    Agent_install_location\Java

  • UNIX platforms:

    Agent_install_location\Java

  Add soasmapi.jar to your CLASSPATH setting. When compiling, you can use the -classpath switch.