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

3.4.1 COBW3_GET_VALUE, COBW3_GET_VALUE_XX, COBW3_GET_VALUE_NX, COBW3_GET_VALUE_XN, and COBW3_GET_VALUE_NN

These subroutines search any name (NAME) from Web parameters obtained by "COBW3_INIT" to acquire the corresponding value (VALUE). The following lists the meaning of each subroutine:

ASCII environment

COBW3_GET_VALUE

Searches the alphanumeric character string name (NAME) to return the corresponding value (VALUE) as an alphanumeric character string.

Unicode environment

COBW3_GET_VALUE_XX

Searches the alphanumeric character string name (NAME) to return the corresponding value (VALUE) as an alphanumeric character string.

COBW3_GET_VALUE_NX

Searches the national character string name (NAME) to return the corresponding value (VALUE) as an alphanumeric character string.

COBW3_GET_VALUE_XN

Searches the alphanumeric character string name (NAME) to return the corresponding value (VALUE) as a national character string.

COBW3_GET_VALUE_NN

Searches the national character string name (NAME) to return the corresponding value (VALUE) as a national character string.

The padding string (padding character) used when the acquired value (VALUE) is blank.

How to write

CALL "COBW3_GET_VALUE" USING COBW3.
CALL "COBW3_GET_VALUE_XX" USING COBW3.
CALL "COBW3_GET_VALUE_NX" USING COBW3.
CALL "COBW3_GET_VALUE_XN" USING COBW3.
CALL "COBW3_GET_VALUE_NN" USING COBW3.

Data setting for calling

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

Set the name (NAME) to be searched (The name here is that specified in name of the HTML document of the Web page for the invoking application).

For COBW3_GET_VALUE, COBW3_GET_VALUE_XX and COBW3_GET_VALUE_XN, set the name to COBW3-SEARCH-DATA.

For COBW3_GET_VALUE_NX and COBW3_GET_VALUE_NN, set the name to COBW3-SEARCH-DATA-N.

COBW3-SEARCH-LENGTH [optional]

If the name has a valid blank at the end, set the string length (byte length) of the name 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]

If multiple entities with the same name (NAME) exist in Web parameters, set the order of appearance of names to be searched.

Condition name

Value

Meaning

COBW3-NUMBER-INIT

1

Searches the name that matches first.

-

2 to 9999

Searches the names in the specified order of appearance.

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.

COBW3-GET-DATA and COBW3-GET-DATA-N

The value (VALUE) corresponding to the name (NAME) to be searched is set.

For COBW3_GET_VALUE, COBW3_GET_VALUE_XX and COBW3_GET_VALUE_NX, the value is set to COBW3-GET-DATA.

For COBW3_GET_VALUE_XN and COBW3_GET_VALUE_NN, the value is set to COBW3-GET-DATA-N.

COBW3-GET-LENGTH

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