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.