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

3.4.2 COBW3_CHECK_VALUE, COBW3_CHECK_VALUE_X and COBW3_CHECK_VALUE_N

These subroutines retrieve an arbitrary value (VALUE) from the Web parameters that were acquired using COBW3_INIT. These subroutines are used for the VALUE check of the item which was checked on the WWW browser when these subroutines are called from an application-invoking Web page with a check box. The functions of these subroutines are as follows:

ASCII environment

COBW3_CHECK_VALUE

Retrieves an alphanumeric character string value (VALUE).

Unicode environment

COBW3_CHECK_VALUE_X

Retrieves an alphanumeric character string value (VALUE).

COBW3_CHECK_VALUE_N

Retrieves a national character string value (VALUE).

Format

CALL "COBW3_CHECK_VALUE" USING COBW3.
CALL "COBW3_CHECK_VALUE_X" USING COBW3.
CALL "COBW3_CHECK_VALUE_N" USING COBW3.

Data setting at calling

COBW3-SEARCH-DATA or COBW3-SEARCH-DATA-N

Specify a retrieval value (VALUE).

When COBW3_CHECK_VALUE and COBW3_CHECK_VALUE_X are used, specify the value in COBW3-SEARCH-DATA.

When COBW3_CHECK_VALUE_N is used, specify the value in COBW3-SEARCH-DATA-N.

COBW3-SEARCH-LENGTH [Optional]

To retrieve a value (VALUE) that has a valid blank at the end, specify the byte length of the blank-containing value.

Value

Explanation

0

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

1 to 1024

Retrieves a value of the specified character string length.

COBW3-NUMBER [Optional]

When two or more identical values (VALUE) are specified in the CGI parameter, specify the occurrence sequence of the retrieval targets.

Condition name

Value

Explanation

COBW3-NUMBER-INIT

1

Retrieves the first matching value.

-

2 to 9999

Retrieves the value with the specified occurrence sequence.

Processing result data

COBW3-SEARCH-FLAG

Condition name

Value

Explanation

COBW3-SEARCH-FLAG-NON

"0"

The retrieved value was not found.

COBW3-SEARCH-FLAG-EXIST

"1"

The retrieved value was found.