Inet_Trace function
Description
Internet procedure, executed from a Web browser, that tests whether OECGI.EXE is running on the Web server. Additionally, it can be used to debug a Web page. It returns the http headers associated with the request.
Syntax
Inet_Trace(Request)
Note: Request is any text after the string INET_TRACE?
Parameters
The Inet_Trace function has the following parameter:
Parameters | Description |
---|---|
Request | [in] HTTP-request. |
Returns
Incoming request as an HTML script, displayed in the Web browser.
See Also
Example
To test whether OECGI.EXE is properly installed, use the IP address 127.0.0.1 (the local host loopback address), and enter the following URL in the server's Web browser:
http://127.0.0.1/cgi-bin/oecgi.exe/INET_TRACE?FOO=BAR
If OECGI.EXE is properly installed, you will get a set of http headers, similar to the output below:
CONTENT_LENGTH = 0 CONTENT_TYPE = GATEWAY_INTERFACE = CGI/1.1 HTTPS = off HTTP_ACCEPT = image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */* HTTP_COOKIE = HTTP_FROM = HTTP_REFERER = HTTP_USER_AGENT = Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) PATH_INFO = /INET_TRACE PATH_TRANSLATED = C:\Inetpub\wwwroot\INET_TRACE QUERY_STRING = FOO=BAR REMOTE_ADDR = 127.0.0.1 REMOTE_HOST = 127.0.0.1 REMOTE_IDENT = REMOTE_USER = REQUEST_METHOD = GET SCRIPT_NAME = /cgi-bin/oecgi.exe SERVER_NAME = 127.0.0.1 SERVER_PORT = 80 SERVER_PROTOCOL = HTTP/1.1 SERVER_SOFTWARE = Microsoft-IIS/5.1 SERVER_URL =
This is important information for debugging a Web application, since it indicates information such as the query string (QUERY_STRING), the Web server name and version (SERVER_SOFTWARE), the location of INET_TRACE (PATH_TRANSLATED), and the browser (HTTP_USER_AGENT).
If OECGI.EXE is not properly installed, an error message indicating that no http headers were returned, or that INET_TRACE was not found, will display.