Use the Start Process dialog box to run a client application from the OLT Viewer. The client application must be resident on this machine or accessible from a shared drive.
You cannot
start AIX applications from the Start Process dialog box. Instead, type the application
name in a korn shell.
C++ applications:
Browse for the executable file and double-click its name. If you intend to debug client
code from startup, you must add one of the following commands in front of the executable
name:
idebug -qlang=cpp yourapp
where yourapp is the fully qualified path to your program. For example, C:\MyApps\MyApp.exe on Windows or /usr/me/myapps/myapp on AIX or Solaris .
irmtdbgc -qhost=<Hostname> -quiport=8001 yourapp
where:
<Hostname> is the hostname of the machine where you started the Debugger
Daemon.
8001 is the port number for the Debugger Daemon. This parameter is optional, and can
be used when port 8001 is busy.
yourapp is the fully qualified path to your
program. For example, C:\MyApps\MyApp.exe on Windows
or /usr/me/myapps/myapp on AIX or Solaris .
Java applications:
The string to start a Java application is
more complex, and should be entered from the command line. The system classpath must
include anything required to run your application.
To trace the application:
java
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
yourapp
To debug the application through OLT:
for Java 1.1.x:
java_g -debug -nojit
-Dcom.ibm.CORBA.requestTimeout=0
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
-classpath <path\YourAppJarFile>;<path\somojor.zip>;<path\dertrjrt.jar>;%CLASSPATH%
yourappfor the Java 2 platform:
java -Xdebug -Djava.compiler=NONE
-Dcom.ibm.CORBA.requestTimeout=0
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
-Xbootclasspath <path\YourAppJarFile>;<path\somojor.zip>;<path\dertrjrt.jar>; %JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\jre\lib\rt.jar;%CLASSPATH%
yourapp
To debug the client application locally from startup:
for Java 1.1.x:
idebug -qlang=java -qhost=<Hostname>
-qjvmargs="
-nojit
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.requestTimeout=0
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
-classpath <path\YourAppJarFile>;<path\somojor.zip>;<path\dertrjrt.jar>;%CLASSPATH%"
yourappfor the Java 2 platform:
idebug -qlang=java -qhost=<Hostname>
-qjvmargs="
-Djava.compiler=NONE
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.requestTimeout=0
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
-Xbootclasspath <path\YourAppJarFile>; <path\somojor.zip>; <path\dertrjrt.jar>; %JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\jre\lib\rt.jar;%CLASSPATH%"
yourappTo debug the client application remotely from startup:
On the machine where you want to run the debugger user interface, start the debugger daemon with this command:
idebug -qdaemon -quiport=<ui_daemon_port> -qlang=java
for Java 1.1.x:
irmtdbgj -qhost=<Hostname> -quiport=<ui_daemon_port>
-jvmargs="
-nojit
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.requestTimeout=0
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
-classpath <path\YourAppJarFile>;<path\somojor.zip>;<path\dertrjrt.jar>;%CLASSPATH%"
yourappfor the Java 2 platform:
irmtdbgj -qhost=<Hostname> -quiport=<ui_daemon_port>
-jvmargs="
-Djava.compiler=NONE
-Dcom.ibm.CORBA.EnableApplicationOLT=true
-Dcom.ibm.CORBA.requestTimeout=0
-Dcom.ibm.CORBA.BootstrapHost=<BootstrapHostname>
-Dcom.ibm.CORBA.OLTApplicationHost=<OLT_Server_Host>
-Dcom.ibm.CORBA.OLTApplicationPort=<OLT_Server_Port>
-DOLTClient=true
-Xbootclasspath <path\YourAppJarFile>; <path\somojor.zip>; <path\dertrjrt.jar>; %JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\jre\lib\rt.jar;%CLASSPATH%"
yourapp
where:
<Hostname> = host name of the machine where the Debugger Daemon is
running
<ui_daemon_port> =TCP/IP port number for the debugger daemon, if not 8001. This parameter is optional, and can be used when port 8001 is busy.
<BootstrapHostname> = your fully-qualified server application host name (only needed if System Manager is running on a different host)
<OLT_Server_Host> = the fully-qualified name or TCP/IP address of the machine running your OLT server
<OLT_Server_Port> = the port where the OLT server listens for connecting OLT clients
<path\somojor.zip> = is only required when debugging a Component Broker client. It should be set as follows: /usr/lpp/CBConnector/lib/somojor.zip on AIX, /opt/CBConnector/lib/somojor.zip on Solaris, and x:\CBroker\lib\somojor.zip on Windows.
<path\dertrjrt.jar> = /usr/idebug/lib/dertrjrt.jar on AIX and x:\IBMDebug\lib\dertrjrt.jar on Windows.
yourapp is the fully qualified path to your program. For example, C:\MyApps\MyApp.exe on Windows or /usr/me/myapps/myapp on AIX or Solaris
Run options: