Name

Type

Description

application

optional

default=""

The name of the application for which this definition file applies.  Reported in trace when debug="yes".

version

optional

default="0.0"

Version of the file--may be used to track updates, reported in trace when debug="yes"

debug

optional

default="no"

When set to "yes" and the HostConnection traceActive property is TRUE, the HL trace entries will have a detailed analysis of the interpretation of the Recognize tags to assist in diagnosing screen recognition issues.

specialAsBlanks

optional - new with Version 2

default="no"

When set to "no" if a recognition text location on the screen contains an attribute, the recognition will fail.  In addition, if what appears to be a blank on the screen is actually a NULL character, the recognition will also fail unless the spaceType attribute is set to "null" for the individual recognition element.

When set to "yes", at runtime any attribute or NULL character on the active screen will be treated as a blank in a recognition comparison.  This feature requires a marginal increase in CPU time to recognize screens but makes life far easier for developers when performing screen recognition definitions.