This subroutine acquires session data registered with the current session.
Note
Call this subroutine while a session is open. If this subroutine is called before a session is started or after a session is terminated, session data cannot be acquired.
The format of session data cannot be changed while a session is opened. Acquire session data fitting to the format of session data set when "COBW3_START_SESSION" was called.
How to write
CALL "COBW3_GET_SESSION_DATA" USING COBW3 session data.
Data setting for calling
Specify the group item length (byte length) in which the acquired session data is to be stored. This specification is valid only if COBW3-SESSION-DATA-GROUPITEM is set as the format of session data when a session is started.
Value | Meaning |
|---|---|
1 to 999999999 | Acquires session data using the specified length of the session data. An error occurs if the length is different from that of the session data registered with the session. |
Specify the session data to be acquired. Specify a group item or an object reference item matching the format of the session data when a session was started.
Note
If object reference items are registered as session data, the object reference item specified as a call parameter of this subroutine must have been initialized by the NULL object. If not initialized by the NULL object, session data cannot be acquired. When specifying an object reference item as session data, specify an object reference item with the USAGE OBJECT REFERENCE clause without any other selection specification.
If session data to be acquired is in a different format from that set when a session was opened, operations of Web applications cannot be guaranteed.
When specifying a group item as the session data, we recommend using a library file to match the configuration of the session data in which the configuration of the subordinate basic items are registered.
Processing result data
None
