PLBWEB_CGI_INFODIR

PLBWEB_CGI_INFODIR Keyword

9.8A

This keyword enables the PL/B Web Server to capture CGI (Common Gateway Interface) data. When the CGI data is captured, it can be retrieved using the runtime object CgiString method. This keyword can be changed to take immediate affect without having to restart the PWS server. If this keyword is not used, the 'CgiString' method does not return any CGI data.

PLBWEB_CGI_INFODIR={ [ path ] [ prefix ] }

Where:

path: Optional. The path value is an OS specific path where the CGI work files are to be located. If the 'path' is not specified the CGI work files are located in the current work directory of the PWS server.
prefix: Optional. The prefix value is a user defined prefix character sequence that is prepended to the CGI work files. If the 'prefix' is not specified, the CGI work file name simply does not have a user defined prefix.

Note:

1. When the PLBWEB_CGI_INFODIR keyword is defined, the CGI work files are named using the following format:

['path']['prefix']T{progid}.cgi

Where:

path: is an optional OS path.
prefix: is an optional user defined prefix character sequence.
progid: is the PWS child process unique identification number.

2. The CGI works files are temporary and immediately deleted after transferring the CGI data to the PWS child process. In this case, the CGI work files are deleted by default. If the user defines the PLBWEB_CGI_KEEP=ON keyword in the plbwebsrv.ini file, the CGI files are NOT deleted. When the PLBWEB_CGI_KEEP=ON is used, the PWS administrator is responsible for deleting the CGI files. Therefore, the PLBWEB_CGI_KEEP=ON should only be used when debugging and should never be left defined for production operations for an extended period of time.

Examples:

[Environment]

PLBWEB_CGI_INFODIR=z

In this case, a CGI work file name 'zTnnnn.cgi' is created in the PWS current working directory. This CGI work file is immediately deleted after data is initially transferred to the PWS child process.

PLBWEB_CGI_INFODIR=

In this case, a CGI work file named 'Tnnnn.cgi' is created in the PWS current working directory. This CGI work file is immediately deleted after data is initially transferred to the PWS child process.

PLBWEB_CGI_INFODIR=c:\temp\pwstmp

In this case, a CGI work file named 'Tnnnn.cgi' is created in the 'c:\temp\pwstmp' directory. This CGI work file is immediately deleted after data is initially transferred to the PWS child process.

PLBWEB_CGI_INFODIR=c:\temp\pwstmp\z_

In this case, a CGI work file named 'z_Tnnnn.cgi' is created in the 'c:\temp\pwstmp' directory. This CGI work file is immediately deleted after data is initially transferred to the PWS child process.