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:
- 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:
- 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.
- Create the debugging profile data sets.
- Include the resource definition for the debugging profile file in a resource
definition list that is named in the GRPLIST system
initialization parameter.
- 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.
- 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.

CICS Application Programming Guide
CICS Application Programming Guide
[[ Contents Previous Page | Next Page Index ]]