Space announcement This documentation space provides the same content as before, but the organization of the content has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

EXCLUDE

COBOL

PL/I

Assembler

C Language

The EXCLUDE command suppresses the display of a line or range of lines from the Source screen. A record of the command is written to the session log.

EXCLUDE is not valid in an unattended batch test.

Input

image2021-2-15_16-40-47.png

EXCLUDE Line Command Syntax

X - Exclude a line
XX - Exclude a block of lines

The following are the parameter descriptions for the EXCLUDE command:

ALL

Keyword used to exclude all statement lines.

address (Assembler)

Address for the range of lines when the line command area indicates 24- or 31-bit addressing.

offset (Assembler)

Offset for the range of lines when the line command area is offset. Offset is a valid hexadecimal number preceded by a plus (+) sign.

statement#

A valid statement number. You can also specify a list or a range of statement numbers.

THRU

Required keyword when excluding a range of statements.

Usage Notes

ALL Languages

  1. Excluded lines are replaced on the screen by a single broken line. A message is displayed noting how many lines were omitted. For example:
      - - - - - - - - - - - - - - - 11 LINES NOT DISPLAYED
    Use the NOLINES command to suppress the xx LINES NOT DISPLAYED message.
  2. The only valid line commands on excluded lines are D (Delete), F (First), Fn, L (Last), and Ln.
  3. Excluded lines can be restored using one of the methods listed as follows:
    • Use the DELETE or RESET command with the EXCLUDE keyword or the END command to restore all excluded lines throughout the program.
    • A pause or trace breakpoint at an excluded line restores that line.
    • Use the FIND, LOCATE, and PEEK commands to restore the excluded lines that meet the search criteria.
    • Use the D line command to restore a block of excluded lines. Use the Fn or Ln line commands to restore the first or last n lines from a block of excluded lines.
  4. Use EXCLUDE in the Keep window to show additional kept items or to reduce the size of the Keep window.

PL/I

  1. Use the THRU keyword or the X and XX line commands to reach lines that do not have statement numbers associated with them.

Examples

  1. To remove lines 45 through 55 from the display, enter the following:
       EXCLUDE 45 THRU 55

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*