Top
NetCOBOL V11.0 CGI Subroutines User's Guide
FUJITSU Software

3.11.1 COBW3_NAME

These subroutines retrieve an arbitrary name (NAME) from the Web parameters that were acquired using the COBW3_INIT.

These subroutines also acquire the value (VALUE) that corresponds to the name (NAME). To store the acquired value (VALUE), the en-size blank is added as a padding character.

Format

CALL "COBW3_NAME" USING COBW3.

Data setting at calling

COBW3-SEARCH-DATA

Specify a retrieval name (NAME) that was specified in the "name" in the HTML document (Web page used for invoking the application).

COBW3-SEARCH-LENGTH [Optional]

To retrieve a name (NAME) that has a valid blank at the end, specify the byte length of the name containing the blank (character string).

Value

Explanation

0

Retrieves a name up to the last character other than the blank.

1 to 1024

Retrieves a name of the specified character string length.

COBW3-NUMBER [Optional]

When two or more identical names (NAME) are specified in the Web parameter, specify the occurrence sequence of the retrieval targets.

Condition name

Value

Explanation

COBW3-NUMBER-INIT

1

Retrieves the first matching name.

-

2~9999

Retrieves the name with the specified occurrence sequence.

Processing result data

COBW3-SEARCH-FLAG

Condition name

Value

Explanation

COBW3-SEARCH-FLAG-NON

"0"

The retrieved name was not found.

COBW3-SEARCH-FLAG-EXIST

"1"

The retrieved name was found.

COBW3-GET-DATA

The value (VALUE) that corresponds to a retrieval name (NAME) is set.

COBW3-GET-LENGTH

The character string length (byte length) of the value (VALUE) corresponding to the retrieval name (NAME) is set.