/path/cgi-name/handle/rest/of/path
Where handle is an exact match of the handle provided in the Accept-HTSession
CGI header for the program cgi-name.
Note: The cgi-name that is being resolved is the name as it appears in the URL. It
is not necessarily the actual name of the program being started on the
system. This is to remain consistent with the name resolution performed by
the server.
HTTimeout CGI Header
The HTTimeout header is for the CGI program to define the amount of time, in
minutes, that this CGI program wants to wait for a subsequent request. If not
specified, the value specified on the PersistentCGITimeout directive is used. If
specified, it takes precedence over the PersistentCGITimeout directive, but the
server will not wait longer than the time specified on the
MaxPersistentCGITimeout directive. This allows individual CGI programs to give
users more time to respond to lengthy forms or explanations. However, it still
gives the server ultimate control over the maximum time to wait.
HTTimeout = "HTTimeout" ":" minutes
The time-out value is a non-negative decimal integer, representing the time in
minutes. This header must be preceded by an Accept-HTSessionheader, if not, it
is ignored. If you omit the header, the default time-out value for the server is used.
When a CGI program is ended because of a time-out, a message is logged in the
error log of the server.
Considerations for using Persistent CGI Programs
You should be aware of the following considerations when using persistent CGI
programs:
vThe web administrator can limit the number of persistent CGI programs that the
server supports by using the MaxPersistentCGI configuration directive.
vThere are some job or thread-level resources that the server code running in the
CGI job usually manipulates (directly or indirectly) on behalf of CGI programs.
The following attributes will (potentially) change across calls:
Environment variables the server sets
Stdin/Stdout/Stderr file descriptors
User profile
Library list
vThe server will not set the rest of the job attributes set by the server, and
therefore, will maintain state across calls if changed by the CGI program. Note,
however, that the CGI program must restore the initial state of these values
before ending its persistence in order to guarantee compatibility across
subsequent server requests:
Job Language, Country, CCSID
Job Priority
Printer/Output Queue
Message Logging
Environment variables set by the CGI program
vFor added security, web server administrators can protect their persistent CGI
programs using registered Internet users, thereby forcing authentication by the
user before processing each request.
82 WebProgramming Guide V4R5