Starting the debugger engine

When debugging from the user interface client, you start the debugger engine using the user interface daemon mode. In this mode, the user interface is started first, and it waits for the engine to connect to it.

The irmtdbgc command starts the debug engine on the remote system. The irmtdbgc command has the syntax, irmtdbgc [debugger parms] debuggee_name [debuggee parms], where [debugger parms] are, in any order:

Parameter Description
-qhost= <host:port> <host> specifies the host name of the machine running the debugger user interface. This can be a host name or an IP address. If not specified, the value in the environment variable DER_DBG_ADDR is used. If neither is specified, the value localhost is used.

<port> is optional (by default, port 8001 is assumed).

-i If present, specifies that the debugger is to stop immediately after loading the debuggee, and not run to the main entry point of your application. For C++, this means you can debug the static initialization code in your application.

-a xxxx

xxxx may be a process identifier or, if the name of the application is unique, the name of the process as shown by the ps command.
-qdisplay= xxxx

xxxx specifies the X Window display to be used for the debuggee. The default is the value of the DISPLAY environment variable.

The debuggee will X Window display only if:

  • The X Window terminal program (dtterm, aixterm, or xterm) can be found using the PATH environment variable; and
  • The DISPLAY environment variable is set or this parameter is present.

If both conditions are not met, the debuggee will use the session that the debug engine was started in.

Use of this parameter requires that the -qconsole=GUI parameter be present.

-qconsole=<remote, local, or GUI> This controls where the console for the program being debugged will appear.

If -qconsole=remote is specified, output will be directed to the local session and to the user interface.

If -qconsole=local is specified, the console appears in the console window in which the you typed the irmtdbgc command.

If -qconsole=GUI is specified, the console appears in a separate window.

The default value of this parameter is remote.

See also the -qdisplay option for UNIX systems.

-s Specifies that the debuggee is to run immediately. The debuggee will stop when it reaches a breakpoint from the profile, or if a signal occurs.
-- This indicates that the next parameter is the debuggee name. It is only required if the debuggee name begins with the character '-'.

The debugger will search for the program to debug using the PATH environment variable. On AIX®, the program that you are debugging may also be a core file.


Feedback