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. See the CICS System Definition Guide for more information. You must then complete the following tasks:

  1. Install a suitable debugger client in your workstation. You can use the following product as your debugger client: The documentation for these products contains the information you need to install and use them.
  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 User’s Guide.
  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 Java Applications in CICS 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.

When you have completed all these steps, the programs that you have selected at step 7 will run under the control of a debugger.

[[ Contents Previous Page | Next Page Index ]]