Setting Completion Rules for Individual Screens

Completion rules determine when the host has completed updating the screen. When you customize a form at design time, default completion rules are automatically generated.

However, there may be situations when a default rule needs to be changed (for example, the default completion rule causes the application to appear slow, or the form appears incomplete). You would use the Recognition Rule Editor - Completion Rule page to optimize the performance of your application.

Note The settings you make from the Screen Recognition Rule Editor - Completion Rule page affect only the currently selected host screen. To set the default completion rules for an entire application, you would specify them from the Host Settings dialog box. (For additional information about customizing completion rules on a global basis, see Setting Default Completion Rules for an Application.)
To set the completion rule for an individual screen
  1. Open Presentation Designer.

  2. Open the project based on an active host session that you want modify.

  3. From the Editor pane, select the Customize tab.

  4. In the Project pane, on the Forms page, right-click the name of the host screen for which you want to modify the completion rule, then select Screen Recognition Rule.

    The Screen Recognition Rule editor appears.

  5. Select the Completion Rule tab.

  6. From Select Rule Type, select the completion rule type that you want to apply to this form.
    Host Settings Use the completion rule defined in the host settings to determine screen completion for this host screen.
    Host Quiet Determine a fully downloaded screen by monitoring the absence of transmissions from the host for a specific time interval (that you indicate) in milliseconds.

    For a specific host screen that always takes longer to download than other screens in your application, the Default time-out setting might be too short. This rule type allows you to set a longer wait-time that applies only to the currently selected screen.

    Recognition Use the screen recognition rule to determine the completion of the screen. If the expected screen recognition rule never evaluates as true, the associated Max Quiet Time (that you specify) sets a maximum length of time the application will wait before timing out.

    • You must first have captured a screen before you can create the recognition rule. Once you have done so, you can configure and use the recognition completion rule.

    • A performance penalty may result unless the recognition completion rule is properly configured.
  7. If you selected the Host Quiet rule type, in the Quiet Time box, adjust the length of time to wait, in milliseconds, before determining the completion of a screen. (The default is 1500 milliseconds.)


    If you selected the Recognition rule type, in the Max Quiet Time box, type the length of time to wait, in milliseconds, for successful evaluation of the screen recognition rule. (The default is 5000 milliseconds.)

  8. Choose the OK button to save your changes.

    The Screen Recognition Rule editor closes.

Related Topics
Bullet Improving Application Performance, Overview
Bullet Setting Default Completion Rules for an Application
Bullet Screen Recognition Rule Syntax