Using ISAPI

How to:

You can use the proprietary API for the Microsoft Internet Information Server (known as ISAPI) to call WebFOCUS. ISAPI works the same way as the CGI, providing identical functionality.

It also provides reduced memory use and quicker response time. However, you can only use it with a Microsoft Internet Information Server on Windows. Other operating environments must use the WebFOCUS Servlet or CGI.


Top of page

x
Syntax: How to Call ISAPI From a Hyperlink
<A HREF="/ibi_apps/webapi.dll?IBIF_ex=procedure[&var=value[&var=value]...]">text</A>

where:

procedure

Is the name of the procedure to run.

var=value

Is a variable and its corresponding value. The call can include both HTTP environment variables and application variables passed to the procedure.

You can pass more than one variable-value pair, but do not include a space between pairs. Use an ampersand (&) as a delimiter to separate each variable-value pair.

If a value contains an embedded blank, substitute a plus sign (+) or the characters %20 for the blank.

text

Is the text on the launch page that serves as the hyperlink that runs the procedure.

Note: The maximum length of the URL can be 4K or 4,096 bytes. There is no limit on the number of the parameters, but their total length cannot exceed 4K.


Top of page

x
Syntax: How to Call ISAPI From a Form
<FORM ACTION="/ibi_apps/webapi.dll" METHOD="get">
<INPUT NAME="IBIF_ex" VALUE="procedure" TYPE="hidden">
   .
   .
   .
</FORM>

where:

procedure

Is the name of the procedure to run. The call can include both HTTP environment variables and application variables passed to the procedure.

For guidelines on creating a form, see Conventions for Creating a Form.


WebFOCUS