The Pattern tab contains all of the settings used to define patterns on a selected entity. If you've just added a new pattern to your model, the following sections will be available:
Defines the name or names of the currently defined patterns. When you add a new pattern to an entity, a default name, such as Pattern_1, is generated and default settings are applied in the Position, Properties, and Pattern use boxes. When a pattern is selected in the Name box, the cursor highlights the position of the pattern on the host screen. Next to the Name box, there are buttons that allow you to add a new pattern, delete the current one, or auto-generate patterns.
If a pattern is no longer valid (for example, the layout of the screen on the host has changed), the pattern is marked with a red X in the list after running the Entity Repair utility or setting the model to offline mode.
Note: Auto-generating patterns simplifies the modeling process, but you may need to delete some auto-generated patterns later to enhance server performance. If you choose to have the Design Tool auto-generate patterns, you can configure properties recognition on the Pattern tab of the Preferences Setup dialog box. In addition, patterns cannot be generated automatically for a VT host.
Defines the position settings (Row,
Height, Column, and Width) that describe the actual position
of the pattern on the host screen. First, select a Selection
mode.
By default, the pattern is assumed to always be located in the same
place on the terminal window. If the pattern can occur in another position,
use one or both of the following to describe where to look to for the pattern.
Search for pattern relative to cursor
Relative to cursor means relative to initial cursor position, not relative
to the current Terminal window cursor position. If you select Relative to
cursor, click Update Initial Cursor Position on the Model menu to
change the initial cursor position to the current cursor position. If you have
configured any entity properties relative to a cursor position, these property
coordinates will be automatically updated. Click Apply to save your changes
or click Cancel to revert your initial cursor position back to its original
state.
Search for pattern in expanded region
The actual pattern or "text" can float inside a larger region defined
in the Position box. In these instances, the positioning noted in the
Position box functions more as a search region than an exact position.
In default color configuration, select the Position settings for region using
the green selection rectangle. Select the pattern definition using the red selection
rectangle, or use the settings on the Location tab.
At runtime, the Host Integrator will search the entire region outlined in green
for the text defined by the settings in the Location tab.
If both of these options are enabled, the expanded region is defined relative
to the cursor position specified.
Describes the physical characteristics of the pattern and provides a view of any characters appearing on that area of the host screen. The Design Tool displays different property settings for different types of terminals. For more information, see using display attributes for patterns.
Field type and text color
For IBM 3270 and 5250 hosts, the Text check box is selected when a new
pattern is created by default. To view the field
type or the text color of the pattern
as recognized by the host, select the Field type or Text color
check boxes.
For VT and HP hosts, the Field type and Text color properties are replaced with the following:
ERROR [0-9]{1, 4}: .*
Use in entity signature
Defines whether or not a pattern will be included in the entity signature. By
default, the Use in entity signature check box is selected, which requires
that a pattern be present as part of a defined entity. To view details about
a specific entity signature, click Signature
Analyzer on the Debug menu.
Screen properties not present
Defines whether or not screen properties for this pattern will be recognized
by the Design Tool. Select the Screen properties not present check box
to make sure the properties described above for the pattern are not included
in the pattern's entity signature.
Note: By default, a pattern is considered "present" when Host Integrator
finds its properties on the terminal screen in the correct location. In some
cases, however, a pattern is "present" when its properties are not on the terminal
screen in the defined location. For example, when modeling the process of scrolling
through a set of records such as a bank statement, the host may use a text prompt
to tell the user how to scroll when there are more records, then remove the
prompt on the final screen. In Host Integrator, a good way to define a NoMoreRecords
pattern would be to select the host prompt text, define the pattern, and then
select the Screen properties not present check box. The NoMoreRecords
pattern will then be considered "present" when the host prompt text is not.
If you have selected Search for pattern in expanded region,
the settings on this tab identify the location of the pattern definition. Select
the region in the terminal window using the red selection rectangle or fill
in the settings for row, column, height, and width (Rectangular mode), or offset
and length (Linear mode). In default color configuration, this pattern definition
area is outlined in red, while the Position settings
for region are outlined in green.
|