Skip to main content

%CSP.SessionEvents

Class %CSP.SessionEvents Extends %RegisteredObject [ Abstract, Not ProcedureBlock, System = 3 ]

Abstract class which defines the interfaces that are called during the lifetime of a %CSP.Session object. In order to use this you should subclass this and implement the method code you wish to be executed. Then within the CSP application configuration set the event class to the class you have created.

Methods​

OnEndSession​

ClassMethod OnEndSession()

Called when the session is about to be deleted, either because of a timeout (in which case OnTimeout is called first) or because the application has explicitly closed this session. Use the %session object to examine this session. If you wish to abort this deletion then: Set %session.EndSession=0

OnTimeout​

ClassMethod OnTimeout()

Called when the CSP Daemon times out out this session before calling EndSession. Use the %session object to examine this session. If you wish to abort this deletion then: Set %session.EndSession=0

OnStartSession​

ClassMethod OnStartSession()

Called when a new session is created and its values are initialised.

This is called before the license for this session is allocated, and if you wish to abort this session and return the standard out of licenses error page then: Set %session.EndSession=1

OnApplicationChange​

ClassMethod OnApplicationChange(oldapp As %String, newapp As %String) As %Status

Called when a session that was in CSP application oldapp is now going to run a page in CSP application newapp. If this returns an error value then instead of running the page in the new application it will redirect to the error page (error page looked up from old application).

OnLogin​

ClassMethod OnLogin() As %Status

Called when a login occurs that changed the $username or the roles this user is running with. If this returns an error status then this is reported via the standard error page.

OnLogout​

ClassMethod OnLogout() As %Status

Called when a logout. The current authentication for the session is invalidated. occurs that changed the $username or the roles this user is running with. If this returns an error status then the logout will be stopped. If you wish to end the session after the logout then: Set %session.EndSession=1

OnStartRequest​

ClassMethod OnStartRequest() As %Status

Called when we start getting data from the CSP gateway for a request

OnEndRequest​

ClassMethod OnEndRequest() As %Status

Called when we have finished processing this request