NAMES INCLUDE command

Use the NAMES INCLUDE command to indicate to z/OS® Debugger 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 IBM® z/OS Debugger User's Guide for more information.

Read syntax diagramSkip visual syntax diagramNAMESINCLUDE LOADMODCU name(,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 z/OS Debugger.
  • You cannot use the NAMES INCLUDE command to indicate to z/OS Debugger 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 IBM z/OS Debugger User's Guide.
  • Do not use the NAMES INCLUDE command to debug system components (for example, z/OS Debugger, 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 z/OS Debugger recognizes as system components.
  • z/OS Debugger 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, unless they contain an asterisk (*)

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