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

3.11.1 COBW3_START_SESSION

This subroutine starts a session. At this point, the format of the session data of the session to be opened and the timeout period are also set.

Note

Use this subroutine before using "COBW3_PUT_TEXT", "COBW3_PUT_HTML", or "COBW3_FREE". If this subroutine is called after using one of these subroutines even once, the session will not be started.

If this subroutine is called when a session is already started, an error occurs.

The format of the session data cannot be changed while a session is open. To change the format of the session data, call "COBW3_END_SESSION" to terminate the session temporarily.

How to write

CALL "COBW3_START_SESSION " USING COBW3.

Data setting for calling

COBW3-SESSION-DATA-TYPE

Specify the format of session data.

Condition name

Value

Meaning

COBW3-SESSION-DATA-GROUPITEM

"0"

Uses a group item as session data.

COBW3-SESSION-DATA-OBJECT

"1"

Uses an object reference item as session data.

COBW3-SESSION-TIMEOUT

Specify the timeout period (s) of a session. The timeout period is the maximum wait time between the instant when "COBW3_FREE" is called and the instant when "COBW3_INIT" is called in the next thread within the same session.

Value

Meaning

1 to 999999

The timeout processing is performed when the specified time interval (s) passes.

Processing result data

None