Session may not get released on SNA Server

Technical Note IRE2846
Created 08-Aug-2005

Applies To
Synapta - Presentation Builder 4.0

Presentation Designer 4.0

Microsoft Host Integration Server 2000

HTML application

Symptoms

Session may not get released on SNA Server

Problem occurs after disabling 'Exiting Presentation' alert

'Exiting Presentation' alert is disabled by commenting it out in the file common.js

Common.JS is located under ..\Attachmate\HTTPEngine\webapps\epi\WEB-INF\js\common.js

'Exiting Presentation' alert is included in function _unload event

Cause

Problem occurs because when commenting out this alert the application does not have enough time to unload the application completely when a user closes the HTML application.

Fix

If the 'Exiting Presentation' needs to be disabled add a delay in to the function 'unloadApp to ensure the function gets enough time to complete before the window is closed. This will ensure that resources on the SNA Server are always released immediately when a user closes the HTML application.
To do this follow these steps:
1. Edit Common.js in .\Attachmate\HTTPEngine\webapps\epi\WEB-INF\js
2. Search for:
function _unloadApp()
{
   if (isApplicationPersistence) // if application persistence is set on then do not call unload app command
     return;
   // do unload if not in middle of submit request   
   if (firstSubmit)
  {
     window.status = "";
     firstSubmit = false;
     window.navigate(callUnloadApp);
     // This alert informs user application is exiting. It also provides time for last unload
     // event to be called. If information is not used by user then ensure delay is uncommented.
     //alert("Exiting presentation.");
   }
}
3. Below //alert("Exiting presentation."); add the following line:
delay(1000); //uncomment this line if "Exiting.." alert is commented out. delay needed for unload app to finish
4. Save the file and restart the HTTPEngine Service.