Setting Default Completion Rules for an Application

The common completion rule specifies how long an application will wait for additional input from the host before determining the identity of a screen. The correct form is displayed as soon as the host screen is identified, or after waiting the specified length of time, whichever comes first.

The default completion rule can enhance performance by determining when the host has completed downloading the screen. Because of differences in host screens, various methods are provided to ensure the most prompt recognition of a fully downloaded screen.

Note The settings for per-screen completion rules are specified from the Screen Recognition Rule editor and apply only to a currently selected host screen. For additional information about tailoring completion rules on a per-screen basis, see Setting Completion Rules for Individual Screens.
To set the default completion rules for an application
  1. Open a project in Presentation Designer.

  2. From the Host menu, choose Host Settings.

    The Host Settings dialog box displays.

  3. From the tree pane, select Completion Rule, then select Common.

  4. In the Maximum Transition Time Allowed box, type the length of time to wait, up to 60,000 milliseconds (1 minute) for host screen downloads.
    Note The value you enter for Maximum Transition Time Allowed overrides all other host time-out settings in your application. For example, if you set this value to 15,000 milliseconds, but you have an individual form in your application set with a Host Quiet Time of 30,000 milliseconds, the Maximum Transition Time Allowed setting would override the Host Quiet Time setting for that individual form.
  5. From the tree pane, under Completion Rule, select Default.

  6. Under Default Rule, in the Host Quiet Time box, type the length of time, in milliseconds, for the default time out. (The default is 1500 milliseconds.)

  7. (Optional) Select Keyboard Must Be Unlocked to delay running the Host Quiet Time until after the keyboard is unlocked by the operating system.

    This may prevent a time out while receiving data from the host, and improve program reliability.

  8. Under Known Destination, select the method for determining at what time the host has fully downloaded a screen whenever the destination screen is known but no rule is specified.
    To use
    Default Rule The Host Quiet Time, set under Default Rules.
    Recognition of Destination Screen The screen recognition rule for the Expected Screen.

  9. If you selected Recognition of Destination Screen, in the Maximum Quiet Time text box, type the length of time to wait, in milliseconds, for successful evaluation of the screen recognition rule.

  10. Choose the OK button to save the settings and close the Host Settings dialog box.
Related Topics
Bullet Improving Application Performance, Overview
Bullet Setting Completion Rules for Individual Screens
Bullet Screen Recognition Rule Syntax