NAMES INCLUDE command

Use the NAMES INCLUDE command to indicate to Debug Tool that your program is a user load module or compile unit, not a system program. See "Debugging user programs that use system prefix names" in the Debug Tool User's Guide for more information.

>>-NAMES--INCLUDE--+-LOADMOD-+--+-name-----------+--;----------><
                   '-CU------'  |    .-,----.    |      
                                |    V      |    |      
                                '-(----name-+--)-'      

LOADMOD

Indicates that you want to debug the specified load module.

CU

Indicates that you want to debug the specified compile unit.

name

Specifies the name of the load module or compile unit.

Usage notes

• You can use this command in remote debug mode.
• You cannot use the NAMES INCLUDE command on load modules or compile units that are already known to Debug Tool.
• You cannot use the NAMES INCLUDE command to indicate to Debug Tool that you want to debug the initial load module or the compile units contained in the initial load module. If you want to do this, you must specify the EQAOPTS NAMES command, as described in "Using the EQAOPTS NAMES command to include or exclude the initial load module" in the Debug Tool User's Guide.
• Do not use the NAMES INCLUDE command to debug system components (for example, Debug Tool, Language Environment, CICS®, IMS™, or compiler run-time modules). If you attempt to debug these system components, you might experience unpredictable failures. Only use this command to debug user programs that are named with prefixes that Debug Tool recognizes as system components.
• Debug Tool generates implicit NAMES INCLUDE commands for the following situations:
  • The target of a deferred AT ENTRY command
  • The target of an AT LOAD command
  • The target of a LOADDEBUGDATA command
  • In CICS, the programs specified in DTCN and CADP, unless they contain an asterisk (*)

Refer to the following topics for more information related to the material discussed in this topic.

• Related tasks
• "Debugging user programs that use system prefixed names" in the Debug Tool User's Guide
• Related references
• Debug Tool commands supported in remote debug mode