Previous Page | Next Page

Administering SAS Web Applications

Configuring the Display of a Warning Message for Inactive User Sessions

In SAS 9.2 and previous maintenance releases for SAS 9.2, users with inactive user sessions were logged out and automatically redirected to the time-out Web page displayed by the SAS Logon Manager. Beginning with the third maintenance release for SAS 9.2 and later, you can alert users by displaying a warning message before they are logged out of their inactive sessions. By default, this warning message displays for 5 minutes, but you can customize it by specifying a different value in minutes.

This feature is supported for:

Beginning with the 4.3 Release of SAS BI Dashboard, this feature is supported.

Note:   If SAS Information Delivery Portal 4.2 is configured at your site, this feature should not be enabled. Beginning with the November 2010 release, SAS Information Delivery Portal 4.3 enables you to alert users by displaying a warning message before they are logged out of their inactive sessions.  [cautionend]

The following table summarizes the features of the warning message.

Display Warning Message for Inactive User Sessions
Feature Third Maintenance Release for SAS 9.2
For inactive user sessions associated with SAS applications (SAS Information Delivery Portal, SAS Web Report Studio, SAS Package Viewer, SAS Shared applications, SAS Preferences, SAS Web Infrastructure Platform administration, and SAS Stored Process), display a warning message to users before logging them off their applications. (Optional) Specify the Policy.DisplaySessionTimeoutWarning property and set the value to true. By default, this warning message displays for 5 minutes.
Specify the length of time for the display of a warning message that is enabled when the Policy.DisplaySession TimeoutWarning property is set to true. (Optional) Specify the App.SessionTimeoutWarningInterval property and provide a value in minutes. Specifying the Policy.DisplaySession TimeoutWarning property is a prerequisite for using this property. The default value is 5 minutes. The value specified for this property cannot exceed the value defined for the session time-out interval in the web.xml file.

Configuring the Display of a Warning Message for Inactive User Sessions

Inactive users are logged off their Web applications when their sessions are inactive for 30 minutes or for the amount of time specified by the administrator in the web.xml files. In the third maintenance release for SAS 9.2, before logging out inactive sessions, you can alert users about the impending log off by displaying a warning message. When the warning message is displayed, users can click the Continue button to activate and extend their sessions. In the third maintenance release for SAS 9.2, the following applications support the display of a warning message:

Beginning with the November 2010 release, SAS Information Delivery Portal 4.3 supports the display of a warning message.

Beginning with the 4.3 Release of SAS BI Dashboard, this feature is available.

To configure a warning message for inactive user sessions associated with SAS applications and specify the number of minutes that the warning message should be displayed, follow these steps:

  1. On the Plug-ins tab, under Application Management [arrow] Configuration Manager, right-click SAS Application Infrastructure and select Properties.

    In the SAS Application Infrastructure Properties dialog box, click the Advanced tab.

  2. Click Add.

  3. In the Define New Property dialog box, enter each property name and property value as follows and click OK. Note that specifying the App.SessionTimeoutWarningInterval is optional. If the App.SessionTimeoutWarningInterval property is not specified with a custom value, the default value of 5 minutes applies to the Policy.DisplaySessionTimeoutWarning property. The value specified for the App.SessionTimeoutWarningInterval must be smaller than the value or values specified for session time-out intervals in the web.xml files. For information about web.xml files, see Configuring the HTTP Session Time-out Interval.

    Property Name Policy.DisplaySessionTimeoutWarning

    Property Value true

    Property Name App.SessionTimeoutWarningInterval

    Property Value Value for Session Time-out Warning Interval

  4. Click OK to save your changes.

  5. To enable these properties to take effect, restart the Web application server.

If you want to specify a different session time-out interval for each SAS application, complete this task for each SAS application by defining the App.SessionTimeoutWarningInterval property and a custom value in minutes.

Previous Page | Next Page | Top of Page

Copyright © 2010 by SAS Institute Inc., Cary, NC, USA. All rights reserved.