Attributes

value
Required string. The sequence of characters.
row
Optional integer (the default is to search the entire screen). The row location of one corner of a rectangular block of text.
col
Optional integer. The column location of one corner of a rectangular block of text.
erow
Optional integer. The row location of the opposite corner of a rectangular block of text.
ecol
Optional integer. The column location of the opposite corner of a rectangular block of text.
casesense
Optional boolean (the default is false). Setting this attribute to true causes the macro runtime to do a case-sensitive string compare.
wrap
Optional boolean (the default is false).
  • Setting this attribute to false causes the macro runtime to search for the sequence of characters in each separate row of the rectangular block of text. If the sequence of characters wraps from one row to the next, the macro runtime will not find it.
  • Setting this attribute to true causes the macro runtime to check for the sequence of characters occurring in any row or wrapping from one row to the next of the rectangular block of text (see How the macro runtime searches the rectangular area (Wrap option)).
optional
Optional boolean (the default is false). See Optional.
invertmatch
Optional boolean. See Inverse Descriptor.
hostid
Optional string. See Specifying a session.