SET SHADOW

Read syntax diagramSkip visual syntax diagram SET SHADow ONOFF

Purpose

Use the SHADOW option to display a notice (called a shadow line) indicating how many lines are excluded from the display. The shadow line appears where the excluded line(s) would be in the file. For an example of how to combine SET SHADOW effectively with the other selective line editing subcommands (SET SELECT, SET SCOPE, and SET DISPLAY), see SET SELECT.

Operands

ON
displays a shadow line telling the number of lines omitted in the display by the SET DISPlay subcommand. Each shadow line shown is in the place of the omitted line or block of lines.
OFF
removes shadow lines, so there is no visual representation for lines not displayed.

Initial Setting

SHADOW ON

Usage Notes

  1. For examples of this and other selective line editing subcommands, examine the following IBM-supplied macros: ALL (whose file ID is ALL XEDIT), which restricts editing to a particular set of lines, and the X prefix macro (whose file ID is PREFIXX XEDIT), which excludes lines from the display. See also Effects of Selective Line Editing Subcommands.
  2. If a prefix macro is entered on a shadow line, the line number of the first excluded line is passed to the macro as pline (the line number on which the prefix macro was entered). (See SET PENDING.)
  3. With SET NUMBER ON, the sequence numbers let you determine which lines are excluded from the display. This is especially useful with SHADOW OFF. With SHADOW ON, the sequence number in a shadow line is the first line in a block of excluded lines.

Messages and Return Codes

520E
Invalid operand: operand [RC=5]
545E
Missing operand(s) [RC=5]

where return codes are:

0
Normal
5
Invalid or missing operand(s)
6
Subcommand rejected in the profile due to LOAD error, or QUIT subcommand has been issued in a macro called from the last file in the ring