<@CGIPARAM NAME=name [ENCODING=encoding]>
Evaluates to the value of the specified CGI attribute. CGI attributes are values passed to Tango Server by your Web server. CGI attributes are passed whether you are using the CGI or the plug-in version of Tango Server.
The following table shows valid values for the NAME attribute and descriptions of the value returned by each.
Attribute Name |
Description |
The fully-qualified domain name of the user who called the application file, if your Web server is set to do DNS lookups; otherwise, this attribute contains the user's IP address. For example, "fred.xyz.com". |
|
The IP address of the user who called the application file. For example, "205.189.228.30". |
|
Rarely returns anything; with some older Web browser applications, the user's e-mail address. |
|
Returns the value of the HTTP cookie specified in the COOKIE attribute. For example, <@CGIPARAM NAME="HTTP_COOKIE" COOKIE="SICode"> returns the value of the SICode cookie. (This attribute is retained for backwards compatibility with Tango 2.3. It is recommended that you use <@VAR> with SCOPE="COOKIE" to return the values of cookies in Tango 2000. See <@VAR>.) |
|
The HTTP request method used for the current request. If a normal URL call, or form submitted with the GET method, "GET"; if a form submitted with the POST method, "POST". |
|
Text after the Tango CGI name and before any search arguments in the URL. If using the plug-in, or suffix-mapping to call the CGI automatically, no value is returned by this attribute. You may also use the <@APPFILE> meta tag to get this value (it works regardless of calling method and whether you use the plug-in or CGI). For example, a "/" after the CGI name indicates the beginning of the path args. |
|
The raw POST (form submission) argument contents, containing the names and values of all form fields. |
|
The URL of the Web page from which the current request was initiated. Not provided by all Web browsers. (The misspelling of this attribute is for consistency with the CGI specification.) |
|
Fully-qualified domain name of the Web server, if your Web server is set to do DNS lookups; otherwise, this attribute contains the server's IP address. For example, "www.example.com". |
|
The TCP/IP port on which the Web server is running. A typical Web server runs on port 80. |
|
The user name, obtained with HTTP authentication, of the user who requested the URL. This attribute is available only if the URL used to call the current application file required authentication by the Web server software. |
|
The internal name of the Web browser application being used to request the URL. This often contains information about the platform (Mac OS, Windows, etc.) on which the Web browser is running, and the application's version. For example, Internet Explorer 3.0 for Macintosh returns Mozilla/2.0 (compatible; MSIE 3.0; Mac_PowerPC). |

The parameters listed in the following table are available under the Mac OS only. Some may be available only with the StarNine WebSTAR server. Check your server documentation to see if it supports a particular CGI parameter.
<P>Hi there, <TT><@CGIPARAM
NAME=CLIENT_ADDRESS>
</TT>. You are connected to <TT><@CGIPARAM
NAME=SERVER_NAME></TT>, port <@CGIPARAM NAME=SERVER_PORT>.
This returns a personalized greeting to the client, for example:
Hi there, whitman.leavesofgrass.com. You are connected to baudelaire.flowersofevil.com, port 80.
Copyright © 1999, Pervasive Software. All rights reserved.