w3Input

Each page in an active application must end with a call to w3Input, or return back to the original caller. When you call w3Input, control returns to the browser, and the user must fill out the form or press a button or link to continue. If the browser does not respond within the number of seconds specified in the "timeout" parameter, then w3Input returns to the caller with the "err" parameter (not null). If this occurs, the application must gracefully and silently return back to its caller.

In no case should the STOP statement be used, or the D3 line is lost to FlashCONNECT until a www-stop/www-start sequence occurs.

Syntax

Parameters

err

Out

w3_OK unless there was an error.

timeout

The number of seconds to wait here until we get a complete answer from the browser. Use a value of zero to wait forever. A value greater than 86400 (one full day) is illegal.

flags

Flags that control the input process. The following flags are defined:

w3InputTrackPageNumberOff
Normally FlashCONNECT numbers each form sent to the browser. If the information returned isn't for the last form sent, the information is automatically rejected and the last form sent to the browser is resent. This feature is needed when state driven applications use the Web. However, this feature is not needed when event driven applications use the Web. Specifying w3InputTrackPageNumberOff as a flag to w3Input, turns off automatic page number tracking.