IBM Support

Starting the Rational Developer for System z, V9, team debug feature by specifying new suboptions to the TEST run time option

News


Abstract

This document describes how to modify the TEST run time option so that when you run your program, a team debug session is started. This document assumes you are familiar with the topic "Debug extension for Rational Team Concert Client" in the Rational Developer for System z, Version 9, information center, which describes how to use the team debug feature.

Content

Before you begin, read the Overview topic in the Rational Developer for System z information center to understand how team debug works and what software you must install. Read the Preparing to debug topic to understand how the instructions in this technote help start a team debug session.

The method currently available to start a team debug session with Debug Tool for z/OS is to modify the JCL that starts your debugging session. Normally, you specify the TCP/IP address and port number of your client in the TEST run time parameter so that the debug session runs on your client. However, when you want to start a team debug session, you must change the TEST run time parameter to include additional arguments. The TEST run time parameter normally looks like the following format:

'/TEST(,,,TCPIP&<tcpip_workstation_id>%<port_id>:)'

You need to change the TEST run time parameter to look like the following format:



'/TEST(,,"<RTC_user_ID>@<RTC_server_repository_URL>",
TCPIP&<RTC_server_host name_or_IP>
%<RTC_compiled_application_debug_port>:)'

The following list describes the new parameters:

<RTC_user_ID>
The ID used to log on to a team repository.
<RTC_server_repository_URL>
The URL of the repository used to connect to the Rational Team Concert server. For example, https://rtcserver.example.com:1234/jazz/
<RTC_server_host name_or_IP>
The host name of the Rational Team Concert server. For example,
rtcserver.example.com
<RTC_compiled_application_debug_port>
The Rational Team Concert port waiting for a debug connection. You can find this port number in the Advanced Properties on the Rational Team Concert server. The property is named :Team Debug for Compiled Languages.

[{"Product":{"code":"SSTQWA","label":"IBM Debug for z\/OS"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"Not Applicable","Platform":[{"code":"PF035","label":"z\/OS"}],"Version":"12.1;13.1","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Product":{"code":"SSJK49","label":"IBM Developer for z Systems"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Component":"General Information","Platform":[{"code":"PF033","label":"Windows"}],"Version":"","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
27 October 2020

UID

swg21405180