Starting a team debug session with Rational Developer for Power Systems Software

A team debug session can be started from the command line on a remote system or from a Debug Configuration in Rational Developer for Power Systems Software. After entering some additional information, you can start the compiled application in the same way that you start a normal debug session.

Before you begin

All systems participating in a team debug session must be on the same network. In particular:

Find the details of starting a team debug session for AIX and Power Linux programs in the tasks on this page:

Results

A Team debug session looks the same as a normal debug session with these differences:

Starting a team debug session from the command line

About this task

To start a team debug session from the command line, the following parameters need to be passed when running the irmtdbgc command:

  • -qhost=RTC_server_host_name_or_ip:RTC_compiled_application_debug_port
    Tip: This may also be set in the DER_DBG_ADDR environment variable.
  • -qteamuser=RTC_user_ID@RTC_server_repository_URI

where:

  • RTC_server_host_name_or_ip is the host name, or IP address, of the Rational Team Concert server. For example, rtcserver.example.com.
  • RTC_compiled_application_debug_port is the port on which the Rational Team Concert server is waiting for a compiled language debug connection.
  • RTC_user_ID is the user's ID on the Rational Team Concert server
  • RTC_server_repository_URI is the URL of the repository on the Rational Team Concert server. For example, https://rtcserver.example.com:1234/jazz/.

Example

The full command would be:

irmtdbgc -qhost=rtcserver.example.com:56789 -qteamuser=myid@https://rtcserver.example.com:1234/jazz/ myprogram

Starting a team debug session from a debug configuration

About this task

A team debug session can be started from any of the following 3 types of debug configurations for Rational Developer for Power Systems Software, Version 8.0 or later:

  • Remote Compiled Application
  • Remote Core File
  • Remote Process

Procedure

  1. Edit an exiting debug configuration of a supported type, or create a new one.
  2. Select the Team tab.
  3. Select the checkbox Start as Team Debug session
  4. Select the Rational Team Concert server that will host the team debug session
  5. Enter the port number on which the Rational Team Concert server is listening for compiled language debug connections.

Results

Team tab

Feedback