Table of Contents

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:

ParametersDescription
Request[in] HTTP-request.

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.