Building client samples

Ensure that the environment variables JAVA_HOME, ANT_HOME and AXIS2_HOME are set correctly. For example:

1. Generate the client stub code by using the following procedure:
   1. Change directory to the client directory. Example: C:\IIWS_client_samples
   2. Edit generateStub.bat by modifying the following information:
      • Set ANT_HOME, AXIS2_HOME and JAVA_HOME to the appropriate paths.

      • Set the appropriate URL value point to a running BMC Impact Integration Web Services instance. Example: http://host1234:9080/imws/services/ImpactManager?wsdl

        Warning

        Note

        Ensure that BMC Impact Integration Web Services is running, and that the URL is correct.

   3. Save the generateStub.bat file.
   4. Run the generateStub.bat file. It creates the iiwsClient directory and generates the stub source and build.xml in the iiwsClient directory.
2. Build the client stub by using the following procedure:
   1. Change directory to iiwsClient and find build.xml.

   2. Run the ant command. It generates ImpactManager-test-client.jar under C:\IIWS_client_samples\iiwsClient\build\lib.

      Warning

      Note

      This stub JAR file must be included in the client application.

3. Modify the build_setenv.bat file.
    The build_setenv.batfile sets the environment variables, which are used by all the sample programs in their build process.
   1. Change directory to the client sample top directory. Example: C:\IIWS_client_samples
   2. Edit the build_setenv.batfile to set the following parameters:
      • Set the ANT_HOME to the Apache ant home directory. Example: ANT_HOME=C:\apache\apache-ant-1.7.1-bin\apache-ant-1.7.1
      • Set the AXIS2_HOME to the axis2 home directory. Example: AXIS2_HOME=C:\apache\axis2-1.5.1
      • Set the JAVA_HOME to the Java home directory. Example: JAVA_HOME=C:\Program Files\Java\jdk16.0_18
   3. Save the file.
4. Build the client sample programs by using the following procedure:
   1. Change directory to each client sample. Example: C:\IIWS_client_samples\testSendEvents
   2. Run the ant command. The client testSendEvents is ready to run.
   3. Repeat the build procedure for each of the samples.