Parameters
TimeoutValue
The number of seconds to wait before returning with a session is busy error code.
RowValue
Specifies the cursor row position in the host screen.
ColumnValue
Specifies the cursor column position is the host screen.
ExtraWaitVal
The number of milliseconds to validate for a keyboard unlocked status.
Returns
0 for success; or a non-zero error code. Refer to
Error codes for a complete listing of error code descriptions.
Remarks
The
EMWaitCursor function can be used to verify that a specific host screen is being displayed before continuing with script execution.
If ExtraWaitVal is a value in the range of 1, 2, 3, … ,50 then script execution is suspended until the host machine sends the specified
number of screen writes containing the keyboard restore/unlock command.
If ExtraWaitVal is greater than 50, the script execution is suspended until the specified number of milliseconds have transpired.
Example 1
EMWriteScreen "list", 19, 7
EMSendKey "@E"
ResultCode = EMWaitCursor( 10, 4, 16, 3 ) 'wait for 3 keyboard restores
If ( ResultCode != 0 ) Then
MsgBox "Timeout Error in Script!", 48
End If
Example 2 (using speed control)
EMWriteScreen "list", 19, 7
EMSendKey "@E"
ResultCode = EMWaitCursor( -1 ) 'use Speed Control to determine script delay
If ( ResultCode != 0 ) Then
MsgBox "Timeout Error in Script!", 48
End If