Start the Debugger and
the Remote Program
To remotely debug a program, follow these steps:
- On the machine where the program to be debugged will run,
issue the irmtdbg command.
- On the machine where the debugger will run, issue the idebug
command and provide the remote host name. Either
specify the program you want to debug as the last
argument of the command, or enter the program name in the
Startup dialog that appears.
The irmtdbg command has the following syntax:
irmtdbg [-qprotocol=tcpip [-qport=port]]
[-qsession=single|multi]
where:
- -qprotocol=tcpip
- Specifies the communications protocol to use. Only the
TCP/IP communications protocol is supported. This is the
default protocol.
- -qport=port
- Specifies the TCP/IP port used for the connection. If you
specify -qprotocol=tcpip but you do
not specify a port, or if you do not specify a protocol
(so that TCP/IP becomes the default protocol), the
default port is 8000.
- -qsession=single|multi
- Specifies whether to support single session debugging or
multiple session debugging. The default is single
session.
The command for invoking the debugger has the following syntax
when used for remote debugging:
idebug [-qprotocol=tcpip [-qport=port]]
-qhost=remotehost remote-program
[program-parameters]
where:
- -qhost=remotehost
- Specifies the TCP/IP name or address of the host to
connect to. This argument is required.
- remote-program
- Is the name of the executable program on the remote
machine (including an optional path)
- program-parameters
- are any parameters you want to pass to the executable
program
The communications options for the idebug command
are the same (and have the same defaults) as those for the irmtdbg
command. Note that you do not specify a host name on the irmtdbg
command because the remote machine initiates the connection.