NetCOBOL V11.0 CGI Subroutines User's Guide

3.10.2 COBW3_GEN_UPLOADFILE,COBW3_GEN_UPLOADFILE_X and COBW3_GEN_UPLOADFILE_N

These subroutines generate an uploaded file by using a specified file name. The details of these subroutines are as follows:

ASCII environment

COBW3_GEN_UPLOADFILEX

Searches the name (NAME) of an alphanumeric character string, and generates the found uploaded file by using the specified file name.

Unicode environment

COBW3_GEN_UPLOADFILE_X

Searches the name (NAME) of an alphanumeric character string, and generates the found uploaded file by using the specified file name.

COBW3_GEN_UPLOADFILE_N

Searches the name (NAME) of a national character string, and generates the found uploaded file by using the specified file name.

Note

Uploaded files must not be generated as executable files because of the threat to security. Especially, uploaded files must not be generated as files that can be automatically executed by the system.

How to write

CALL "COBW3_GEN_UPLOADFILE" USING COBW3.

CALL " COBW3_GEN_UPLOADFILE_X" USING COBW3.

CALL " COBW3_GEN_UPLOADFILE_N" USING COBW3.

Data setting for calling

COBW3-SEARCH-DATA and COBW3-SEARCH-DATA-N

Set the name (NAME) of the uploaded file to be searched (The name specified in "name" of the HTML document [Web page for invoking application] must be set instead of the file name).

For COBW3_GEN_UPLOADFILE and COBW3_GEN_UPLOADFILE_X, set the name to COBW3-SEARCH-DATA.

For COBW3_GEN_UPLOADFILE_N, set the name to COBW3-SEARCH-DATA-N.

COBW3-SEARCH-LENGTH [optional]

If the value (VALUE) has a valid blank at the end, set the string length (byte length) of the value including the blank.

Value	Meaning
0	Searches the name using the length up to the last character excluding the blank.
1 to 1024	Searches the name using the specified string length.

COBW3-NUMBER [optional]

Sets the order of appearance of NAMES to be searched when there are multiple NAMES with the same name in the Web parameters.

Condition name	Value	Meaning
COBW3-NUMBER-INIT	1	Searches the name that matches first.
-	2 to 9999	Searches the name in the specified order of appearance.

COBW3-UPLOADED-FILENAME

Specify the name of the file to be generated on the server.

Processing result data

COBW3-SEARCH-FLAG

Condition name	Value	Meaning
COBW3-SEARCH-FLAG-NON	"0"	The name to be searched does not exist.
COBW3-SEARCH-FLAG-EXIST	"1"	The name to be searched exists.