iTP Secure WebServer System Administrator's Guide (Version 7.0)

Using Common Gateway Interface (CGI) Programs
iTP Secure WebServer System Administrator’s Guide—523346-012
8-20
Passing CGI 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 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.
TANDEM_CGI_
RELATIVE_PATH_
SUPPORT
This environment variable maps the current working directory to
the CGI script directory when its value is set to YES.
Format:
Server path {
Env TANDEM_CGI_RELATIVE_PATH_SUPPORT=value}
The valid values for this variable are YES/yes and NO/no.
The default value, NO, causes the current working directory to be
mapped to the directory specified by the CWD attributes of the
server directive. If a directory is not specified by the CWD
attributes, the current working directory, by default, will be mapped
to the directory in which the generic-cgi.pway is located.
Example:
Server $root/bin/generic-cgi.pway {
Eval $DefaultServerAttributes
Env TANDEM_CGI_RELATIVE_PATH_SUPPORT=YES}
Generic CGI will move the current working directory to the location
of the script file. You can specify a relative path inside a cgi script
by using this feature.
Table 8-2. Pathway Specific Environment Variables (page 4 of 4)
Environment Variable Description
* When AUTOMATIC_FORM_DECODING is used, only the last value in a multiple selection will be returned if the
POST method is used along with the multiple tag. To see all values, use the GET method and the
QUERY_STRING variable.