iHTML 2.20 uses environment variables in place of tags for data that is only normally available from the CGI environment. These are available in all iHTML 2.20 Freeware, Basic, Lite, Professional, and Enterprise editions. These can be used anywhere and will return their appropriate value. Environment variables' values are derived from the following sources:

· The server

· Browser information headers

· Browser request headers

· Persistent variables (the cookie header)

· Contents of the GET or POST data

· iHTML engine parsing data (loops & errors)

· An SQL query

Depending on the exact conditions of the http request (the browser used, the server used, their configuration, and the request details such as method, URL form, etc.), all variables may not always be available. Most variables are configured with either an empty string or a 0 depending on their purpose if there is no data for them.

The following is a description of the supported environment variables.

i_auth_pass-This provides the current user password after any authentication. (where available)

i _auth_type-Authentication type (basic on most systems).

i_auth_user-This environment variable provides the current user name after any authentication.

i_browser-This variable is used to identify the browser being used. (where available)

i_content_length-This environment variable provides the size of the data sent with the previous POST submission.

i _error-This provides the last error condition number.

i_errortext-This environment variable provides the error message returned by the last error.

i_http_from-This provides the client's email address if their browser is set up for mail. (older browsers only)

i_ip-This environment variable provides the current user's IP address (may be a proxy server).

i_loop-This variable contains the current count of the iLOOP tag.

i_method-This is the current method being used on the Web server (GET or POST or HEAD).

i_path-This environment variable provides the current path of the request (virtual directories resolved).

i_path_info-This provides additional path information , URL between path and query portions. (on IIS only)

i_port-This variable displays the TCP/IP port number of the http conversation (normally 80).

i_priv_* -This set of variable names are reserved for internal use.

i_query_string-This provides the current query string that the browser passes between pages (trailing part of URL after the question mark).

i_referer-This gives the previous page's URL if available. (on NS Server only)

i_server_extension-This provides the name and version of the extension software (iHTML).

i_server_protocol-This environment variable provides the protocol currently in use (e.g., http/1.0).

i_server_software-This provides the http server software name and version.

i_SQL_fieldname-This is used with iSQL. fieldname is the table column name being referenced. These are synonyms for iHTML 1.x :xxx variables for the field numbers (both are available).

i_sqlempty-This variable evaluates to TRUE or FALSE depending on the most recent SQL Fetch which has taken place, depending whether the query returned any data. Note: This is not an error, it depends on the query and the dataset.

i_sqlerrortext-When i_error contains 350, this variable holds extended information about the native SQL error which occurred.

New in Version 2.20

i_content_type-content type of the file being uploaded

i_cookie_path-The domain path for a cookie to be valid within, can be set

i_cookie_life-The life of the cookies that are defined on the active page, can be set

i_fdate- function to show file date

i_hinttext- hint information for that last error that occurred

i_http_undefinedheader- gives access to any other http header information that might be available; use iHEAPDUMP to find the names of the headers

i_includeroot-Gives the absolute path for include files if not explictly defined, can be set

i_prevpage-this give the previous page absolute directory when a file is not found or an error occurs

i_remote_host-the host name for the value stored in i_ip

i_server_name-The name of the web server being used

i_timestamp- The time stamp of the iHTML DLL, used to check your version of iHTML

i_hostname-The hostname requested by the browser. Useful in IP Less hosting environments.

i_hostip-The IP address of the host requested by the browser.

i_badtag-Provides more information when a 140 or 200 error occurs

i_currentpage-The current page being processed.

i_diedat-The IP address at which an iPING died.

i_dsd-The ODBC datasource driver name retrieved with the iDSN tag.

i_errordetail-This provides the actual line in which an error occurred.

i_os-Provides the name of of the operating system.

i_pop_size-Generated by the iPOPHEADERS tag, it returns message size.

i_sqlerrorstmt-This provides the SQL statement that was last sent to the ODBC driver.

i_vpath-This is used by the virtual paths feature to pass the requested value to the template.