Preparing to debug applications from a workstation

Before you can debug CICS® applications using a workstation, your system programmer must prepare your CICS region for debugging.

1. Install a suitable debugger client such as IBM® Developer for z Systems® on your workstation.
   The documentation available with the debug product contains the information you need to install and use it.
2. Create one or more debugging profiles.
   A debugging profile specifies which programs will run under the debugger's control.

   Note: A debugging profile is not the same thing as a JVM profile. To debug a Java™ application, you need both profiles.
3. If you want to debug programs that are written in COBOL, PL/I, C or C++; or Language Environment®-enabled Assembler subroutines, consider how you want to conduct your debug session, and compile your programs with the appropriate options. For more information, see Debug Tool for z/OS.
4. If you want to debug a Java program, you must ensure that it runs in a Java virtual machine (JVM) that is enabled for debugging.
   To do this:
   1. Create a JVM profile with parameters which enable the JVM for debugging. See Debugging a Java application for more information.
   2. Specify the JVM profile when you create a debugging profile for the Java program. If you do not specify the JVM profile, the JVM uses the profile specified in the PROGRAM definition.
5. Start the debugger client on your workstation.
6. If you are using WebSphere® Studio as your debugger, set at least one breakpoint in your program.
7. Activate the debugging profiles that define the program instances that you want to debug. When you activate profiles for compiled language programs, you must define debugging options that specify the attributes of the debugging session that is started when the program runs.