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
· Contents of the GET or POST
· iHTML engine parsing data (loops
· 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
the current user password after any authentication. (where available)
type (basic on most systems).
variable provides the current user name after any authentication.
is used to identify the browser being used. (where available)
environment variable provides the size of the data sent with the
previous POST submission.
i _error-This provides
the last error condition number.
variable provides the error message returned by the last error.
the client's email address if their browser is set up for mail.
(older browsers only)
variable provides the current user's IP address (may be a proxy
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).
variable provides the current path of the request (virtual directories
additional path information , URL between path and query portions.
(on IIS only)
displays the TCP/IP port number of the http conversation (normally
set of variable names are reserved for internal use.
the current query string that the browser passes between pages
(trailing part of URL after the question mark).
the previous page's URL if available. (on NS Server only)
provides the name and version of the extension software (iHTML).
environment variable provides the protocol currently in use (e.g.,
provides the http server software name and version.
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).
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.
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
path for a cookie to be valid within, can be set
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
absolute path for include files if not explictly defined, can
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
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.