NAMES EXCLUDE command

The NAMES EXCLUDE command enables you to indicate to z/OS® Debugger the names of load modules or compile units that you do not need to debug. If these are data-only modules, z/OS Debugger does not process them. If they contain executable code, z/OS Debugger might process them in some cases. See "Optimizing the debugging of large applications" in the IBM® z/OS Debugger User's Guide for more information about these situations.

Read syntax diagramSkip visual syntax diagramNAMESEXCLUDE LOADMODCUpattern(,pattern)CUNOTEST ;
LOADMOD
Indicates that you do not want to debug the specified load module.
CU
Indicates that you do not want to debug the specified compile unit.
NOTEST
Indicates that you do not want to debug any compile units that were not compiled with debug data.
pattern
Specifies the name of the load module or compile unit, or a string surrounded by quotation marks (") or apostrophes (') that contains a partial load module or compile unit name followed by an asterisk to indicate that you do not want to debug all load modules or compile units beginning with the specified string.

Usage notes

  • You can use this command in remote debug mode.
  • You cannot use the NAMES EXCLUDE command on load modules or compile units that are already known to z/OS Debugger.

    If you specify the name of a currently known load module or compile unit, it is added to the exclude list so that if the name becomes unknown, it is excluded in subsequent appearances. However, the currently known load module or compile unit remains known.

  • You cannot use the NAMES EXCLUDE command to indicate to z/OS Debugger that you want to exclude 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.
  • For C and C++ programs, the pattern parameter is case sensitive. For all other languages, the pattern is not case sensitive.

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 IBM z/OS Debugger User's Guide
  • "Debugging programs containing data-only modules" in the IBM z/OS Debugger User's Guide
  • Related references
  • z/OS Debugger commands supported in remote debug mode