Create a table for session persistence

We can use a database table to collect and store session data. For a database table for session persistence, create and define a database table that is associated with the application server.

Whenever the session manager is set for database persistence, the session manager creates a table for its use. To expand the column size limits to make it more appropriate for the website, we can create the table externally. If the external table is specified as the target table in the session manager database persistence configuration, then during the session manager start up, the external table is used. In most cases it is better to let the session manager create the table during startup.

To create a table for collecting session data, do the following:

1. Have the administrator create a database table for storing your session data using one of the following DDL: For DB2 :

   CREATE TABLE <SchemaName>.sessions  (
     ID               VARCHAR(128) NOT NULL , PROPID           VARCHAR(128) NOT NULL , APPNAME          VARCHAR(128) NOT NULL, LISTENERCNT      SMALLINT , LASTACCESS       BIGINT, CREATIONTIME     BIGINT, MAXINACTIVETIME  INTEGER , USERNAME         VARCHAR(256) , SMALL            VARCHAR(3122)  FOR BIT DATA , MEDIUM           LONG VARCHAR FOR BIT DATA , LARGE            BLOB(2M)
       )
     

   For Oracle:

   CREATE TABLE SESSIONS  (
     ID               VARCHAR(128) NOT NULL , PROPID           VARCHAR(128) NOT NULL , APPNAME          VARCHAR(128) NOT NULL, LISTENERCNT      SMALLINT , LASTACCESS       INTEGER, CREATIONTIME     INTEGER, MAXINACTIVETIME  INTEGER , USERNAME         VARCHAR(256) , SMALL            RAW(2000), MEDIUM           LONG RAW , LARGE            RAW(1)
     )

   If the web container custom property UseOracleBLOB is set to true then:

   CREATE TABLE SESSIONS  (
     ID               VARCHAR(128) NOT NULL , PROPID           VARCHAR(128) NOT NULL , APPNAME          VARCHAR(128) NOT NULL, LISTENERCNT      SMALLINT , LASTACCESS       INTEGER, CREATIONTIME     INTEGER, MAXINACTIVETIME  INTEGER , USERNAME         VARCHAR(256) , SMALL            RAW(2000), MEDIUM           BLOB, LARGE            RAW(1)
     )

   1. At run time, the session manager accesses the target table using the identity of the Java EE server in which our owning web application is deployed. Any web container configured to use persistent sessions must have both read and update access to the subject database table.

   2. HTTP session processing uses the index defined using the CREATE INDEX statement to avoid database deadlocks. In some situations, such as when a relatively small table size is defined for the database, DB2 may decide not to use this index. When the index is not used, database deadlocks can occur. If database deadlocks occur, see the DB2 Administration Guide for the version of DB2 you are using for recommendations on how to calculate the space required for an index and adjust the size of the tables that you are using accordingly.

   3. It might be necessary to tune DB2 to make efficient use of the sessions database table and to avoid deadlocks when accessing it. Your DB2 administrator should refer to the DB2 Administration Guide for specific information about tuning the version of DB2 that you are using.

   4. During run time, the session manager may create an entry in the database for each web module of the application. This row of data is used internally for session management purposes, such as in session invalidation. Do not be concerned with this entry. It can be overlooked.

   5. If a primary key constraint is required for the sessions database table, the primary key constraint must be defined using the ID, PROPID, and APPNAME columns.

2. (zos) Configure a table for session persistence.

Related tasks

(zos) Configure a table for session persistence