The {{SessionParms}} Tag

This tag allows various session attributes to be set:

SessionParms( InactivityTimeout= seconds | DEFAULT, 
              ServiceTimeout= seconds | DEFAULT, 
              Path = DEFAULT | path,
              Scope = ALL | ISOLATE )

where:

InactivityTimeout Determines how long a session survives without user interaction.
  • DEFAULT - Resets the timeout to the default setting: 600 seconds or 10 minutes.
  • seconds - An integer that specifies the number of seconds before the session terminates. The minimum value is 10 seconds (useful for testing) and the maximum value is 1,000,000 seconds (about 11 days).
ServiceTimeout Determines the maximum length of time the Service Program may run when a request is received.
  • DEFAULT - Resets the timeout to the default setting: 30 seconds.
  • seconds - An integer that specifies the number of seconds before Service Program termination processing begins. The minimum value is 10 seconds (useful for testing) and the maximum value is 3,600 seconds (one hour).
Path Specifies the root path of the current session. This parameter is ignored unless the page being served is the initial session page.
  • DEFAULT - The session root path is set to the path of the current request. See The Session Root Path and Session Scope for more details.
  • path - Explicitly sets the session root path to path. The path may be specified as a relative or an absolute URL path and must specify a path segment contained in the URL path of the initial page.

    In addition, under IIS, the specified path must contain at least as many path segments as the application root path (the base directory for the BIS application)-that is, the path cannot be closer to the root of the web than the BIS virtual directory.

    For example, if the requested page is

    http://microfocus.com/xbis/apps/states/texas/default.srf

    the default session path is

    /xbis/apps/states/texas

    These paths may be specified to set the session root path to xbis/apps:

    Path="/xbis/apps"
    Path=../../

    These paths set the default session path to the directory containing the requested object:

    Path=DEFAULT
    Path=.
    Path=”/xbis/apps/states/texas”
    
    These paths are invalid and are reported as being invalid in the trace file:
    Path=/xbis/apps/states/california
    Path=../florida
    

    These directories are not contained in the path.

    In addition, for IIS servers, the path cannot be closer to the root than the application base path (the path that describes the virtual directory that contains the BIS server).

Scope Determines the scope of the current session. This parameter may be specified at any time and is not inherited by new sessions.
  • ALL - All pages served from the session base directory and subdirectories of the session base directory are served as part of the current session. This option is the initial default for all new sessions and is appropriate for most applications.
  • ISOLATE - Only pages served from the session base directory are included in the current session. A new, non-isolated session is started when a page is requested from a subdirectory of the session base directory. The ISOLATE option allows a single user agent to use more than one BIS session as long as the sessions are based in separate directories on the server.