sessionStart

sessionStart(sessionDataObject: Object; 
             expiryMinutes:     Integer; 
             timeoutMinutes:    Integer): IOrbSessionCursor typeMethod;

The sessionStart method of the Orb class starts a persistent session, associating the object specified by the sessionDataObject parameter, which can be any object. The object must exist for the duration of the session or the behavior is undefined. The object specified by the sessionDataObject parameter is not affected in any way when the session is terminated.

The sessionData method can be used to retrieve the provided sessionDataObject.

The session is terminated after the number of minutes specified by the expiryMinutes parameter is exceeded.

Additionally, the session is terminated if no requests are made within the number of minutes specified by the timeoutMinutes parameter.

Each request resets the timer and if the period specified by the timeoutMinutes parameter elapses without a request, the session terminates. The timeoutMinutes parameter value can be specified as zero (0) to not have an idle timeout (equivalent to setting the timeoutMinutes parameter to the same value as the expiryMinutes parameter).

This method returns an opaque IOrbSessionCursor instance that references the underlying session. For details, see "IOrbSessionCursor Interface", elsewhere in this document.

This method cannot be called in transaction state.