irmtdbg command

ngjava.gif (225 bytes)Restriction:   This is supported for Java only.

Requirement: You must have the debug engine installed on the remote system in order to use this command. Check the install documentation for instructions on how to install the debug engine on a remote system.

The irmtdbg command starts the debug engine on the remote system. If the debug engine detects a debugger user interface daemon, then you can start debugging your program immediately. If no debugger user interface daemon is detected, the debug engine will run as a daemon until you start the debugger user interface on the local system with the idebug command.

The irmtdbg command has the following syntax:

irmtdbg [irmtdbg_parameters] [--] [program_name [program_parameters]]

where irmtdbg_parameters are:

  Parameter Description
-qprotocol=<protocol> Specifies the communications protocol to use. Only TCP/IP is supported. This is the default protocol.
-qport=<port> Specifies the TCP/IP port used for the connection.

If you do not use the default port, specify the same port number you use here in the -qport parameter of the idebug command. The default port is 8000.

If you use the -qdaemon option of the idebug command, this port number must match the port number used in the -quiport parameter of the idebug command.

-qsession=single|multi Specifies whether to support single session debugging or multiple session debugging. The default is single.

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 deubugging runs to completion or is terminated manually. The debug engine must be terminated manually on the remote system.

Use the "--" parameter to separate irmtdbg parameters from the program name and parameters. Use this option if your program name or parameters include forward slashes ("/") or dashes ("-"). If you do not use this option, anything preceded by a slash or a dash will be interpreted as a debugger option.

If you do not specify program_name when issuing the irmtdbg command, the debugger will prompt you for the required information in the Load Program dialog of the debugger user interface.

ngrelr.gif (548 bytes)
idebug command