NetCOBOL for SPARC Architecture SAF Subroutines User's Guide

Session Management Functions
Chapter 3. How to Use SAF Subroutines 21
Using the session management functions enables Web applications to handle
multiple requests from a specific client session (WWW browser).
Function Subroutine name Usage
Session
COBW3_START_SESSION Starting the session
management
COBW3_END_SESSION Terminating the session
COBW3_SET_SESSION_DATA Setting the session data
COBW3_GET_SESSION_DATA Getting the session data
COBW3_ALTER_SESSION_TIME
OUT
Changing the time of session timeout
COBW3_GET_SESSION_INFO Getting the current session
information
The session management functions cannot be used with COBOL CGI subroutines.
It is possible to maintain the connection status with a specific client (WWW browser)
by using the session management functions for opening the session. In a single
session, the data entered on a previous page can be inherited by a subsequent page
using the session data functions.
WWW Browser WWW Server
Screen1
Screen2
Screen3
Web
Application 1
Web
Application 2
Session data
is inherited
Session
start
Session
end
A session time-out occurs when the client session transmits no data for an extended
period or when the transaction is interrupted due to some reason such as the WWW
browser being closed before completing the session .
A time-out occurs when the time counted from when the Web application returned a
response to the WWW browser to when the next request is issued by the WWW
browser in the same session has exceeded the specified time. When a time-out
occurs, the session management terminates the session leaving the application’s
resources in the same status as when the session was interrupted . To cope with
such a status, the session management functions provide a registration mechanism
of time-out processing.