z/OS ISPF Edit and Edit Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Specifying a range

z/OS ISPF Edit and Edit Macros
SC19-3621-00

If you use this syntax for a PROCESS macro command in an edit macro:
ISREDIT PROCESS RANGE operand
the macro expects to receive a specified range of lines to process. The operand following the RANGE operand identifies either one or two commands that are to be accepted. For example, the command PROCESS RANGE Q Z allows the line commands Q or Z (but not both) to be processed with this macro. The line commands could take any of these forms:
  • Q or Z, to specify a single line.
  • QQ or ZZ, to specify a block of lines. This form is obtained by doubling the last letter of the single-line command.
  • Qn or Zn where n is a number that specifies a series of lines.

After the PROCESS command is completed, the dialog variable .ZFRANGE is automatically set to the first line of the specified range. The dialog variable .ZLRANGE is set to the last line of the specified range. These labels can refer to the same line. If no range is entered, the range defaults to the entire data set. In this situation, a return code shows that no range was specified.

Two line command names can be specified for PROCESS In this situation, use the RANGE_CMD assignment statement to return the value of the command entered. For example, if you issue this PROCESS command:

CLIST Statement REXX Statements
 
ISREDIT PROCESS RANGE Z $
ADDRESS ISPEXEC
'ISREDIT PROCESS RANGE Z $'

The RANGE_CMD assignment statement returns either a Z or a $.

The names of line commands that define the range can be 1 to 6 characters, but if the name is 6 characters long, it cannot be used as a block format command by doubling the last character. The name can contain any alphabetic or special character except blank, hyphen (-), apostrophe ('), or period (.). It cannot contain any numeric characters.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014