When unwrap is true and continuous is false

When the continuous attribute is false, the row and column pairs represent the corners of a rectangular block of text. When you set the unwrap attribute to true, the macro runtime reads each row of the rectangular block of text and processes each field in the row as follows:
  • If the field begins outside the row and continues into the row, then the macro runtime ignores the field.
  • If the field begins inside the row and ends inside the row, then the macro runtime includes the field's contents in the result.
  • If the field begins inside the row and ends outside the row, then the macro runtime includes the contents of the entire field (including the part outside the rectangular block of text) in the result.

The intent of the unwrap attribute is to capture the entire contents of a field as one string even if the field wraps from one line to the next.

For example, suppose that the host terminal is 80 characters wide and that rows 9, 10, 11, and 12 of the host terminal are as follows:
...............................................Compress or print data set.......
..............................................................Reset statistics..
..............................................................Catalog or display
information of an entire data set...............................................
Suppose also that the following text areas in the lines above are fields:
Reset statistics
Catalog or display information of an entire data set
Finally, suppose that:
  • The continuous attribute is false (this is the default setting).
  • The unwrap attribute is true.
  • The row and column pairs are (9,63) (the 'n' of 'print') and (11,73) (the ' ' after 'or').
  • The extraction name is 'Extract1'.
  • The data plane is TEXT_PLANE.

The macro runtime concatenates the individual strings and stores them as a single string into the variable that you specified in the Extract window. In this example the macro runtime stores the string 'Reset statisticsCatalog or display information of an entire data set' into the variable.