These subroutines retrieve an arbitrary name (NAME) from the Web parameters that were acquired using COBW3_INIT, and acquire the corresponding value (VALUE). The functions of these subroutines are as follows:
ASCII environment
Retrieves an alphanumeric character string name (NAME), and returns the alphanumeric character string that is the corresponding value (VALUE).
Unicode environment
Retrieves an alphanumeric character string name (NAME), and returns the alphanumeric character string that is the corresponding value (VALUE).
Retrieves a national character string name (NAME), and returns the alphanumeric character string that is the corresponding value (VALUE).
Retrieves an alphanumeric character string name (NAME), and returns the national character string that is the corresponding value (VALUE).
Retrieves a national character string name (NAME), and returns the national character string that is the corresponding value (VALUE).
To store the acquired value (VALUE), the en-size blank is added as a padding character.
Format
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 at calling
Specify a retrieval name (NAME) that was already specified in the "name" in the HTML document (Web page used to invoke the application).
When COBW3_GET_VALUE, COBW3_GET_VALUE_XX or COBW3_GET_VALUE_XN are used, specify the name in COBW3-SEARCH-DATA.
When COBW3_GET_VALUE_NX or COBW3_GET_VALUE_NN are used, specify the name in COBW3-SEARCH-DATA-N.
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. |
When two or more identical names (NAME) 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 name. |
- | 2 to 9999 | Retrieves the name with the specified occurrence sequence. |
Processing result data
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. |
The value (VALUE) that corresponds to the retrieval name (NAME) is set.
When COBW3_GET_VALUE, COBW3_GET_VALUE_XX or COBW3_GET_VALUE_NX are used, the found value is set in COBW3-GET-DATA.
When COBW3_GET_VALUE_XN or COBW3_GET_VALUE_NN are used, the found value is set in COBW3-GET-DATA-N.
The character string length (byte length) of the value (VALUE) corresponding to the retrieval name (NAME) is set.
