Restriction: This
command is only used when debugging interpreted Java programs remotely. Use the idebug
command to debug interpreted Java locally.
Requirement: You must have the debug engine installed on the remote system in order to use this command.
The irmtdbgj command starts the Java debug engine on the remote system. Once started, the debug engine waits to connect to the debugger user interface on the local system. You can use the debugger Load Program on the local system or use the idebug command with the remote debug parameters to start the debugger interface on the local system.
The irmtdbgj command has the following syntax:
irmtdbgj [irmtdbgj_options] [JVM_attach_parameters] [engine_daemon_parameters |ui_daemon_parameters [class_name [class_parameters]]]
This page contains discussions of the following categories of irmtdbgj parameters:
Basic irmtdbgj options
The irmtdbgj_options are zero or more of the following:
Parameter | Description |
---|---|
-help | Displays help for the irmtdbgj command. |
-qquiet | Suppresses console output. |
-qfilter=filename | Specifies the file that lists the packages not to be debugged. |
JVM attach parameters
Use the JVM_attach_parameters if you want to attach the debugger
to a running Java Virtual Machine (JVM). You can attach to a JVM if you are
starting a debug engine daemon or connecting to a debugger user interface
daemon.
The jvm_attach_parameters are:
Parameter | Description |
---|---|
-password= | Causes the password or port number to be displayed when you start your Java program.
This parameter is required when attaching to a running JVM.
For the commands necessary to start the Java program, please see the related attaching to a running JVM topic below. |
-host= <JVM_host> |
Specifies the name or address of the machine where the JVM
is running.
If the JVM is running on the same machine where the debug engine will run, use "localhost". |
Parameters to use the Debugger engine as a daemon
Use zero or more of the engine_daemon_parameters if you want to
start the debug engine as a daemon on the remote system. The debug engine daemon
listens on a port number for a connection from the debugger user interface. Once
a connection is made, you can begin debugging your program from the local
system. The engine_daemon_parameters are:
Parameter | Description |
---|---|
-multi | This option enables multiple session debugging. If this
option is omitted, only single session debugging is enabled.
In single session debugging, the debug engine terminates when the program you are debugging runs to completion or is terminated manually. In multiple session debugging, the debug engine re-initializes itself and waits for a new connection when the program you are debugging runs to completion or is terminated manually. The debug engine must be terminated manually on the remote system. |
-jvmargs= <jvm_arguments> |
Specifies arguments passed to the JVM that will run the
program you want to debug. If you specify more than one option, enclose the
list of options in quotation marks.
Restriction: This option cannot be used when attaching to a running JVM. Any JVM arguments must be specified when starting the JVM you want to attach to. Attention:
|
-qport=<port> | Specifies the TCP/IP port where the debug engine daemon will
listen for the user interface. The default port is 8000.
If you do not use the default port, specify the same port number you use here in the -qport parameter of the idebug command. |
Parameters to use the Debugger user interface as a daemon
Use the ui_daemon_parameters if you have started the debugger
user interface as a daemon. As daemon, the debugger user interface listens on a
port for a debugger engine connection. Upon connecting, the debugger user
interface starts and you can begin debugging your program. The ui_daemon_parameters
are:
Parameter | Description |
---|---|
-qhost=<ui_daemon_host> | Specifies the IP address or name of the machine where the
user interface daemon is running.
This parameter is required when connecting to a debugger user interface daemon. |
-qtitle=<ui_daemon_title> | Specifies the title that will appear on the process tab |
-quiport=<ui_daemon_port> | Specifies the TCP/IP port used for the connection. The
default port is 8001.
If you do not use the default port, specify the same port number you use here in the -quiport parameter of the idebug command. |
If you do not specify class_name when issuing the irmtdbgj command with the ui_daemon_parameters, the debugger will prompt you for the required information in the Load Program dialog of the debugger user interface.
Starting
the debugger for debugging compiled languages remotely
Starting
the debugger for debugging interpreted Java remotely
Starting the debugger interface daemon
Attaching
to a running Java Virtual Machine
idebug command
Supported
Java Virtual Machine arguments
CLASSPATH environment variable