Preparing your CICS region for debugging

Before application programmers can use certain debugging tools with CICS®, you must configure your CICS region accordingly.

About this task

You can prepare your CICS region for debugging application programs using the following tools:
  • Debug Tool, for compiled language application programs (programs written in COBOL, PL/I, C, C++), and for Language Environment-enabled Assembler subroutines).
  • Remote debugging tools (for compiled language application programs, Language Environment-enabled Assembler Subroutines, and Java™ programs). Note that for compiled language programs, and Assembler subroutines, Debug Tool is used as the debugging server.
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.
  • It is unlikely that application programs will be debugged in your production regions, especially if the applications are well established and known to be reliable; it is more likely that debugging will take place in regions which are used to develop and test new applications.
To prepare your CICS region for debugging:

Procedure

  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. For more information, see Using the sample startup job stream.
  2. Create the debugging profile data sets. For more information, see Setting up the debugging profiles 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:
    • To enable the region for debugging from a program, use the EXEC CICS SET SYSTEM DEBUGTOOL command
    • To enable the region for debugging from the master terminal transaction, use the CEMT SET SYSTEM DEBUGTOOL command
    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.


dfha2_prep_cics_region_debugging.html | Timestamp icon Last updated: Sunday, 4 June 2017