Wait for OIA to Become Uninhibited descriptor (<oia> element)

Table 1 shows:
  • The three permissible settings for the Wait for OIA to Become Uninhibited listbox.
  • The corresponding values used in the <oia> element.
  • How the macro runtime evaluates the setting.
Table 1. Valid settings for the descriptor Wait for OIA to Become Uninhibited
Setting on the Description tab: Value of the status attribute in the <oia> element: Meaning:
true NOTINHIBITED If the input inhibited indicator in the session window is cleared (that is, input is not inhibited) then the macro runtime evaluates the descriptor as true. Otherwise the macro runtime evaluates the descriptor as false.
false DONTCARE The macro runtime always evaluates the descriptor as true.
<Expression> 'NOTINHIBITED', 'DONTCARE', or any expression that evaluates to one of these strings. The macro runtime evaluates the expression and then interprets the resulting string.
In almost all scenarios you can accept the default setting for this descriptor, which is true (on the Description tab) and NOTINHIBITED (in the macro language). Then, during screen recognition:
  • If the input inhibited indicator in the session window is set (that is, input is inhibited), then the macro runtime will evaluate this descriptor as false.
  • But if the input inhibited indicator is cleared (that is, input is not inhibited), then the macro runtime will evaluate this descriptor as true.
These are the results that you would want and expect. You typically do not want the macro runtime to recognize the macro screen and immediately start processing its actions while the input inhibited indicator is still set. An important timing issue is involved here, which you should read about separately (see Screen completion). But no matter how you resolve that issue, you should almost always leave this descriptor at the default setting, which is true.

However, if you have a scenario in which you want the macro runtime to ignore the input inhibited condition, then set this descriptor to false on the Description tab (the equivalent setting in the macro language is DONTCARE).