ASP in a Nutshell, 2nd Edition

Name

Session Object Events and Session Scope

Synopsis

<SCRIPT LANGUAGE=strLangEngine RUNAT = SERVER>
Sub Session_OnStart
      Event procedure code...
End Sub

Sub Session_OnEnd
      Event procedure code...
End Sub
</SCRIPT>

In the GLOBAL.ASA file, you can include event procedure code for the two events of the Session object: OnStart and OnEnd. These two events are triggered when a client requests a page within your application for the first time and at the end of the user's session (20 minutes after the user's last request, by default), respectively. These events are covered in detail in Chapter 10. In this chapter, we will reiterate some of the topics covered there and how those topics relate to the GLOBAL.ASA file and its use.

Parameters

strLangEngine

A string whose value represents the name of a valid server-side scripting engine. This engine is VBScript by default on IIS web servers, but you can use JScript, PerlScript, Python, REXX, or any other scripting engine that supports the IIS scripting context.

Example

[Excerpt from GLOBAL.ASA] <OBJECT RUNAT=Server SCOPE=Session ID=Tool1 PROGID="MSWC.Tools"> </OBJECT> <SCRIPT LANGUAGE = "VBScript" RUNAT="Server"> Sub Session_OnStart Dim strLogonUser Dim StrUserSecurity ' The following session-level variables will hold ' the user's logon name and security clearance. strLogonUser = Request.ServerVariables("USER_LOGON") strUserSecurity = "PUBLIC" End Sub Sub Session_OnEnd ' The following code destroys the session-scoped ' Tools component. Set Tool1 ...