iTP Secure WebServer System Administrator's Guide (iTPWebSvr 5.1+)

Using Common Gateway Interface (CGI) Programs
iTP Secure WebServer System Administrator’s Guide—522659-001
8-19
Passing CGI Environment Variables
FORM_DECODING_
PREFIX
This environment variable is used to attach a prefix to the
environment variables that are created when the value of the
AUTOMATIC_FORM_DECODING environment variable is set to
ON.
Format:
Region /* {
AddCGI AUTOMATIC_FORM_DECODING ON
AddCGI FORM_DECODING_PREFIX your_prefix_
}
Example:
To retrieve the value of the form entry:
<INPUT SIZE=30 NAME="First_Name"> <b> Your
First Name</b> <br>
Use the following:
getenv ("your_prefix_First_Name");
In this example, the names of all environment variables have the
prefix your_prefix_. The prefix option can be useful if you
expect duplication of names between the names in your form and
the names of predefined environment variables.
TANDEM_CGI_
FFLUSH_TIMER
This environment variable determines the number of seconds that
the CGI process will retain buffered data before flushing the data to
the httpd process (which, in turn, sends the data to the client). You
can include this variable in the configuration of your server class
and/or set it by using the CGI_set_fflush_timer procedure.
Format :
Server path {Env
TANDEM_CGI_FFLUSH_TIMER=value}
The valid values for this variable are from 0 to 3600. The default
value, 0, causes the CGI process to retain buffered data until the
buffer is full. Any other value causes the process to wait the
specified number of seconds before flushing the buffer.
Example:
Server /dir5/flush.pway {Env
TANDEM_CGI_FFLUSH_TIMER=1}
The flush timer uses an OSS signal handling routine that catches a
SIGALARM signal. When the alarm signal is delivered to a
process, it can interrupt long I/O operations and cause an error. In
this case, the errno variable is set to 4004 (interrupted system call).
If you want your program to do its own SIGALARM processing,
set the value of TANDEM_CGI_FFLUSH_TIMER to 0.
Table 8-2. Pathway Specific Environment Variables (page 3 of 3)
Environment
Variable Description