Developing WebSpeed Applications

get-cgi-long

This function returns any CGI or other environment variables specific to a Web request as a LONGCHAR data type. This function serves as a wrapper for the GET-CGI-LONGCHAR-VALUE method of the WEB-CONTEXT system handle.

Location

web\method\cgiutils.i

Parameters

INPUT p_name AS CHARACTER

The variable name. If the Unknown value (?) is specified, the return value is a list of variables.

Returns

LONGCHAR

Notes

Most standard CGI and a number of HTTP environment variables are available as global variables. This function is only needed to access environment variables not defined in web\method\cgidefs.i.

INPUT/OUTPUT operations are not allowed with LONGCHAR variables. For example, the following code would fail:

{&OUT} vpath.

Examples

DEFINE VARIABLE vpath AS LONGCHAR.
vpath = get-cgi-long("PATH-INFO":U).