The key to standardizing FlashConnect applications is the use of these subroutines. Only a partial list of the FlashConnect routines available is included here. Refer to the FlashConnect Programmer’s Online Reference for more information.
wbp w3Include
The wbp w3Include subroutine defines the named common area and is required in all applications that use FlashConnect. It is the include file used for all w3 programs.
w3GetVal()
The w3GetVal() subroutine is used to extract the user’s response from the submitted Web page.
w3HtmlFormBeg()
Use the w3HtmlFormBeg() subroutine when building a new form. To reuse the same server pool, use w3HtmlFormBeg() to set the w3ServerPool in the URL.
The w3HtmlFormBeg routine sets up HTML tags (such as <FORM ACTION...>), and the form’s hidden variables used internally by FlashConnect (such as w3Exec, w3ServerPool, and w3SessionId, as appropriate). At this time, the form’s method can be changed from POST to GET by using the w3HtmlFormGet flag.
w3HtmlFooter()
The w3HtmlFooter() subroutine is used to insert the footer section of the HTML file (Myapp.headfoot.htm in our examples) into the Web page.
w3HtmlFormEnd()
The w3HtmlFormat() subroutine is used to end a Web form and insert the appropriate </FORM> HTML information.
w3HtmlHeader()
The w3HtmlHeader() subroutine is used to insert the header section of the HTML file (Myapp.headfoot.htm in our examples) into the Web page and to modify any flags in the Heading section.
w3HtmlInit()
The w3HtmlInit() subroutine initializes HTML pages by reading the page template from the w3html file, and setting up the application or Web site name. This name is used by the w3HtmlHeader() and w3HtmlFooter() subroutines to output a consistently formatted set of Web pages. Normally, FlashConnect generated Web pages are not cached by the browser. To disable this feature, use the w3HtmlFormCache option of the w3HtmlInit() function.
w3Input()
The w3Input() subroutine sends the form to the user’s browser and waits for a reply (much like a BASIC input statement). Special processing for state driven applications is turned off using the w3InputTrackPageNumberOff option.
w3HtmlInsertSection()
The w3HtmlInsertSection() subroutine is used to insert part of an HTML template (Myapp.body in our examples) into a Web page and change FlashConnect flags defined in the template. The inserted portion can be a direct piece of the inserted HTML template, or an outside template that is referenced in the inserted HTML template. Either type of HTML template can contain nested include files.
The w3HtmlInsertSection() subroutine logs a message in the w3Logs file if the referenced portion of the HTML template is not available.
See Also