Configuring service invocation

About this task

To configure service invocation:

Procedure

  1. Rename the INSTALL_DIR/resources/yifclient.properties.in file to INSTALL_DIR/resources/yifclient.properties.
  2. Ensure that the CLASSPATH contains the following:
    • log4j-1.2.15.jar
    • xercesImpl.jar
    • install_foundation.jar
    • platform_afc.jar
    • resources.jar
    • entities.jar
    • xapi.jar
    • JARs required by your application server
    • JARs required by user exits and custom APIs
  3. Set your java command line property to:
    -Dlog4j.configuration=resources/log4jconfig.xml
  4. Make sure that the INSTALL_DIR directory is in your CLASSPATH.
  5. Set the log4j properties in the log4jconfig.xml file to the appropriate values for your environment. If these properties are not specified correctly, the Service Definition Framework does not initialize correctly.
    • If you are using the EJB protocol and Oracle WebLogic, make sure that weblogic.jar is in your CLASSPATH environment variable. In addition, xercesImpl.jar and xalan.jar must precede weblogic.jar in your CLASSPATH.
    • If you are using the EJB protocol and JBoss, make sure that JBOSS_HOME/client/jbossall-client.jar is in your CLASSPATH environment variable.
    • If you are using the EJB protocol and IBM® WebSphere®, make sure that the CLASSPATH environment variable contains the necessary JAR files. For information about the WebSphere JAR files, see the IBM documentation. Make sure that the CLASSPATH environment variable contains the appropriate properties directory.
      Note: If you are invoking the service or API from the machine on which the server is running, make sure that the CLASSPATH environment variable contains the WAS_HOME/AppServer/properties/ directory.

      If you are invoking the service or API from a different machine, make sure that the CLASSPATH environment variable contains the WAS_HOME/AppClient/properties/ directory.

    • If you are configuring a COM+ protocol call, use one of the following COM signatures that you need:
      createEnvironment(VARIANT *lEnvHandle, BSTR sProgID, 
      BSTR sUserID, int *iRetval)
      Signature for calling standard APIs:
      	<SterlingAPI>(VARIANT *lEnvHandle, BSTR inXML, 
      VARIANT *outXML, VARIANT *errXML, int *retval)
      Signature for calling services:
      	executeFlow(VARIANT *lEnvHandle, BSTR flowName, 
      BSTR flowMsg, VARIANT *outXML, VARIANT *errXML, int *retval)
      For examples of VB code, see the samples in the INSTALL_DIR/xapidocs/code_examples/complus directory.