====== 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 ====
 
[[inet_msg|Inet_Msg()]], [[inet_queryparam|Inet_QueryParam()]], [[inet_repos|Inet_Repos()]], [[inet_rlist|Inet_Rlist()]], [[inet_security|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:

<code>
http://127.0.0.1/cgi-bin/oecgi.exe/INET_TRACE?FOO=BAR
</code>

If OECGI.EXE is properly installed, you will get a set of http headers, similar to the output below:

<code>
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 =
</code>
 

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.