Restriction: This
is supported on AIX and Windows 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 irmtdbgc 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 irmtdbgc command has the following syntax:
irmtdbgc [irmtdbgc_parameters] [--] [program_name [program_parameters]]
where irmtdbgc_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. Restriction: Do not use this parameter when connecting to a debugger user interface daemon. You must use the -quiport option. |
-quiport=<ui_daemon_port> | Specifies the TCP/IP port used for connecting to a debugger user interface
daemon listening on another machine. This port number must match the port number used in the -quiport parameter of the idebug command. |
-qhost=<ui_daemon_host> | Specifies the TCP/IP name or address of the machine where the debugger user interface daemon is listening. |
-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 irmtdbgc 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 irmtdbgc command, the debugger will prompt you for the required information in the Load Program dialog of the debugger user interface.
Tip: If this command gives you an error, you may have an older version of the debug engine on your remote system. Install a new version of the debug engine, if available. If no newer version of the debug engine is available, try using the irmtdbg command.