How to configure a runtime configuration to launch a BES 6 J2EE client application?

Abstract: How to configure a runtime configuration to launch a BES 6 J2EE client application?

Question:

There does not appear to be a runtime configuration for a J2EE application client module. According to BES 6.0 documentation, executing a J2EE client container module must be done by the following command:

appclient.exe [client JAR or EAR] [URI] [args]

Unfortunately there is no corresponding option in the JBuilder runtime configurations. How can I configure a runtime configuration to launch a BES 6 J2EE client application?

Answer:

Rather than using the appclient.exe tool, an alternative is to call the (client) Container directly to start up the J2EE client application:

  1. Create a new runtime configuration
  2. Set the type to be "Application"
  3. Set the main class to be "com.borland.appclient.Container"
  4. Set the application parameters to be, "[client JAR or EAR] [URI] [args]" (just like the parameters for appclient.exe)
  5. Depending on your particular application and OS configuration, you may also need to set some of the following VM Parameters:

    -Dvbroker.agent.port=<port_number>
    -Dorg.omg.CORBA.ORBClass=com.inprise.vbroker.orb.ORB
    -Dorg.omg.CORBA.ORBClass=com.inprise.vbroker.orb.ORB
    -Dorg.omg.CORBA.ORBSingletonClass=com.inprise.vbroker.orb.ORBSingleton
    -Djavax.rmi.CORBA.StubClass=com.inprise.vbroker.rmi.CORBA.StubImpl
    -Djavax.rmi.CORBA.UtilClass=com.inprise.vbroker.rmi.CORBA.UtilImpl
    -Djavax.rmi.CORBA.PortableRemoteObjectClass=com.inprise.vbroker.rmi.CORBA.PortableRemoteObjectImpl
    -Dvbroker.agent.port=<smart agent port>
    -Dvbroker.orb.admDir=$VBROKER_ADM
    -Dvbroker.enterprise.licenseDir=$VBROKER_ADM
    -Djava.class.path=$VBROKERDIR\lib\vbjorb.jar;$VBROKERDIR\lib\lm.jar;$VBROKERDIR\lib\vbsec.jar