TuningParams


This type is a class for model objects.

Tuning parameters for session support.

Package: webcontainer

Classifier ID:  -1
Instance class name:  * Unspecified *
Instance class:  * Unspecified *

Reference attributes having this type:
  SessionManager.tuningParams



Attributes Summary
usingMultiRowSchema : EBoolean Whether to place each instance of application data in a separate row in the database, allowing larger amounts of data to be stored for each session. This can yield better performance in certain usage scenarios. If using multirow schema is not enabled, instances of application data can be placed in the same row.
maxInMemorySessionCount : EInt Specifies the number of sessions to maintain in memory. The meaning differs depending on whether you are using in-memory or persistent sessions. For in-memory sessions, this value specifies the number of sessions in the base session table. Use the Allow Overflow property to specify whether to limit sessions to this number for the entire Session Manager, or allow additional sessions to be stored in secondary tables. For persistent sessions, this value specifies the size of the general cache. If the Cache property is enabled, the Max In-Memory Session Count specifies how many session updates will be cached before the Session Manager reverts to reading session updates from the database automatically.This value holds when you are using in-memory sessions, persistent sessions with caching, or persistent sessions with manual updates. (The manual update cache keeps the last n time stamps representing "last access" times, with n being the Max In-Memory Session Count value).
allowOverflow : EBoolean Whether to allow the number of sessions in memory to exceed the value specified by Max In Memory Session Count property.
scheduleInvalidation : EBoolean Enables the scheduled invalidation process for cleaning up the invalidated HttpSessions from the sessions database. When enabled, this setting specifies the two hours of a day in which the invalidator process cleans up the invalidated persistent sessions in the database.
writeFrequency : WriteFrequencyEnum When the session is written to the database. If we specify END_OF_ SERVLET_SERVICE, a session is written to the database after the servlet completes execution. If we specify MANUAL_UPDATE, programmatic sync on the IBMSession object is required in order to write the session data to the database. If we specify TIME_BASED_WRITE, session data is written to the database based on the specified Write Interval value.
writeInterval : EInt If the Write Frequency is specified as TIME_BASED_WRITE, this value specifies how often the session data will be written to the database. The value must be a number of seconds, specified as a positive integer in the range from 5 to 9999. At minimum, a configured Invalidation Timeout should be twice as large as the configured write interval.
writeContents : WriteContentsEnum Whether only updated attributes should be written to the database. Otherwise, all of the session attributes will be written to the database, whether or not they have changed.
invalidationTimeout : EInt How long a session is allowed to go unused before it will be considered valid no longer. The value is in minutes. Use a -1 to specify that the session will not be invalidated.

The value of this setting is used as a default when the session timeout is not specified in a Web module deployment descriptor.

Note, to preserve performance, the invalidation timer is not accurate "to the second." It is safe to assume that the timer is accurate to within two minutes. When the Write Frequency is time based, this value should be at least twice as large as the write interval. TuningParams.maxInMemorySessionCount.description=Specifies the maximum number of sessions to maintain in memory.

The meaning differs depending on whether you are using in-memory or persistent sessions. For in-memory sessions, this value specifies the number of sessions in the base session table. Use the Allow Overflow property to specify whether to limit sessions to this number for the entire Session Manager, or to allow additional sessions to be stored in secondary tables.

For persistent sessions, this value specifies the size of the general cache. If the Cache property is enabled, this value specifies how many session updates will be cached before the Session Manager reverts to reading session updates from the database automatically.

This value holds when you are using in-memory sessions, persistent sessions with caching, or persistent sessions with manual updates. (The manual update cache keeps the last n time stamps representing "last access" times, with n being the Max In Memory Session Count value).
invalidationSchedule : InvalidationSchedule @ Specifies the times for scheduled session invalidation as two hours of the day for scheduled session invalidation to run.



Attribute Details

usingMultiRowSchema  -  Whether to place each instance of application data in a separate row in the database, allowing larger amounts of data to be stored for each session. This can yield better performance in certain usage scenarios. If using multirow schema is not enabled, instances of application data can be placed in the same row.
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

maxInMemorySessionCount  -  Specifies the number of sessions to maintain in memory. The meaning differs depending on whether you are using in-memory or persistent sessions. For in-memory sessions, this value specifies the number of sessions in the base session table. Use the Allow Overflow property to specify whether to limit sessions to this number for the entire Session Manager, or allow additional sessions to be stored in secondary tables. For persistent sessions, this value specifies the size of the general cache. If the Cache property is enabled, the Max In-Memory Session Count specifies how many session updates will be cached before the Session Manager reverts to reading session updates from the database automatically.This value holds when you are using in-memory sessions, persistent sessions with caching, or persistent sessions with manual updates. (The manual update cache keeps the last n time stamps representing "last access" times, with n being the Max In-Memory Session Count value).
    Data Type: EInt
    Default value:  1000
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

allowOverflow  -  Whether to allow the number of sessions in memory to exceed the value specified by Max In Memory Session Count property.
    Data Type: EBoolean
    Default value:  true
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

scheduleInvalidation  -  Enables the scheduled invalidation process for cleaning up the invalidated HttpSessions from the sessions database. When enabled, this setting specifies the two hours of a day in which the invalidator process cleans up the invalidated persistent sessions in the database.
    Data Type: EBoolean
    Default value:  false
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

writeFrequency  -  When the session is written to the database. If we specify END_OF_ SERVLET_SERVICE, a session is written to the database after the servlet completes execution. If we specify MANUAL_UPDATE, programmatic sync on the IBMSession object is required in order to write the session data to the database. If we specify TIME_BASED_WRITE, session data is written to the database based on the specified Write Interval value.
    Data Type: WriteFrequencyEnum
    Default value:  unspecified
    Allowed values:
        0 - END_OF_SERVLET_SERVICE
        1 - MANUAL_UPDATE
        2 - TIME_BASED_WRITE
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

writeInterval  -  If the Write Frequency is specified as TIME_BASED_WRITE, this value specifies how often the session data will be written to the database. The value must be a number of seconds, specified as a positive integer in the range from 5 to 9999. At minimum, a configured Invalidation Timeout should be twice as large as the configured write interval.
    Data Type: EInt
    Default value:  120
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

writeContents  -  Whether only updated attributes should be written to the database. Otherwise, all of the session attributes will be written to the database, whether or not they have changed.
    Data Type: WriteContentsEnum
    Default value:  unspecified
    Allowed values:
        0 - ONLY_UPDATED_ATTRIBUTES
        1 - ALL_SESSION_ATTRIBUTES
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

invalidationTimeout  -  How long a session is allowed to go unused before it will be considered valid no longer. The value is in minutes. Use a -1 to specify that the session will not be invalidated.

The value of this setting is used as a default when the session timeout is not specified in a Web module deployment descriptor.

Note, to preserve performance, the invalidation timer is not accurate "to the second." It is safe to assume that the timer is accurate to within two minutes. When the Write Frequency is time based, this value should be at least twice as large as the write interval. TuningParams.maxInMemorySessionCount.description=Specifies the maximum number of sessions to maintain in memory.

The meaning differs depending on whether you are using in-memory or persistent sessions. For in-memory sessions, this value specifies the number of sessions in the base session table. Use the Allow Overflow property to specify whether to limit sessions to this number for the entire Session Manager, or to allow additional sessions to be stored in secondary tables.

For persistent sessions, this value specifies the size of the general cache. If the Cache property is enabled, this value specifies how many session updates will be cached before the Session Manager reverts to reading session updates from the database automatically.

This value holds when you are using in-memory sessions, persistent sessions with caching, or persistent sessions with manual updates. (The manual update cache keeps the last n time stamps representing "last access" times, with n being the Max In Memory Session Count value).
    Data Type: EInt
    Default value:  30
    Required:  false
    Changeable:  true
    Unsettable:  true
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false

invalidationSchedule  -  Specifies the times for scheduled session invalidation as two hours of the day for scheduled session invalidation to run.
    Reference Type: InvalidationSchedule @
    Containment:  true
    Container:  false
    Required:  false
    Changeable:  true
    Unsettable:  false
    Many:  false
    Ordered:  true
    Lower bound:  0
    Upper bound:  1
    Unique:  true
    Derived:  false
    Transient:  false
    Volatile:  false



(C) COPYRIGHT International Business Machines Corp. 1996-2006