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:

ParametersDescription
Request[in] HTTP-request.
return[out] Incoming request as an HTML script.

Returns

Incoming request as an HTML script, displayed in the Web browser.

See also

Inet_Msg(), Inet_QueryParam(), Inet_Repos(), Inet_Rlist(), Inet_Security()

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.

  • No labels