Preparing your CICS region for debugging

Before application programmers can use certain debugging tools with CICS®, you must configure your CICS region accordingly. This topic describes preparing your CICS region for debugging application programs using the following tools:

This topic does not apply to other debugging tools, such as the CICS Execution Diagnostic Facility (CEDF).

Since you will need to restart the region, it is advisable to plan which regions will be used for debugging applications.

To prepare your CICS region for debugging:

  1. If you plan to use the region for debugging compiled language programs, include the Debug Tool library SEQAMOD in the DFHRPL concatenation in your CICS startup JCL.
  2. Create the debugging profile data sets.
  3. Include the resource definition for the debugging profile file in a resource definition list that is named in the GRPLIST system initialization parameter.
  4. Optionally, specify the following value for the DEBUGTOOL system initialization parameter:
    DEBUGTOOL=YES

    If you do not specify DEBUGTOOL=YES, you can enable the region for debugging when it is running:

    Enabling the region for debugging when it is running is recommended for regions which are not normally used for debugging. When debugging is complete, you can disable the region for debugging, using the same commands.

  5. Define and install Debug Tool's resource definitions. They are located in member EQACCSD in Debug Tool's SEQASAMP data set. For more information, see the Debug Tool for z/OS and OS/390 User’s Guide.

Related concepts
CICS Application Programming Guide
CICS Application Programming Guide
Related tasks
Using the sample startup job stream
Setting up the debugging profiles data sets
[[ Contents Previous Page | Next Page Index ]]