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

3.9.4 COBW3_GET_COOKIE, COBW3_GET_COOKIE_XX, COBW3_GET_COOKIE_NX, COBW3_GET_COOKIE_XN, and COBW3_GET_COOKIE_NN

These subroutines search any Cookie name from the requested Cookie data acquired by "COBW3_INIT". Also, they acquire the Cookie value corresponding to the Cookie name.

The following lists the meaning of each subroutine:

ASCII environment

COBW3_GET_COOKIE

Searches an alphanumeric character string Cookie name to return the corresponding Cookie value as an alphanumeric character string.

Unicode environment

COBW3_GET_COOKIE-XX

Searches an alphanumeric character string Cookie name to return the corresponding Cookie value as an alphanumeric character string.

COBW3_GET_COOKIE-NX

Searches a national character string Cookie name to return the corresponding Cookie value as an alphanumeric character string.

COBW3_GET_COOKIE-XN

Searches an alphanumeric character string Cookie name to return the corresponding Cookie value as a national character string.

COBW3_GET_COOKIE-NN

Searches a national character string Cookie name to return the corresponding Cookie value as a national character string.

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

How to write

CALL "COBW3_GET_COOKIE" USING COBW3.
CALL "COBW3_GET_COOKIE_XX" USING COBW3.
CALL "COBW3_GET_COOKIE_NX" USING COBW3.
CALL "COBW3_GET_COOKIE_XN" USING COBW3.
CALL "COBW3_GET_COOKIE_NN" USING COBW3.

Data setting for calling

COBW3-COOKIE-NAME and COBW3-COOKIE-NAME-N

Set the Cookie name to be searched.

For COBW3_GET_COOKIE, COBW3_GET_COOKIE_XX and COBW3_GET_COOKIE_XN, set the Cookie name to COBW3-COOKIE-NAME.

For COBW3_GET_COOKIE_NX or COBW3_GET_COOKIE_NN, set the Cookie name to COBW3-COOKIE-NAME-N.

COBW3-COOKIE-NAME-LENGTH [optional]

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

Value

Meaning

0

Searches the Cookie name using the length up to the last character excluding the blank. However, if COBW3-COOKIE-NAME or COBW3-COOKIE-NAME-N is completely blank, the string length is set to zero for processing.

1 to 64

Searches the Cookie name using the specified string length.

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-COOKIE-VALUE and COBW3-COOKIE-VALUE-N

The Cookie value corresponding to the Cookie name to be searched is set.

For COBW3_GET_COOKIE, COBW3_GET_COOKIE_XX and COBW3_GET_COOKIE_NX, the Cookie value is set to COBW3-COOKIE-VALUE.

For COBW3_GET_COOKIE_XN or COBW3_GET_COOKIE_NN, the Cookie value is set to COBW3-COOKIE-VALUE-N.

COBW3-COOKIE-VALUE-LENGTH

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