Progress
Language Reference


SERVER-CONNECTION-CONTEXT Attribute

An arbitrary value that you set within an Application Server process that is passed between all Application Server processes servicing the same client connection.

Data Type: CHARACTER

Access: Readable/Writeable

Applies To: SESSION System Handle

This attribute is ignored unless the REMOTE attribute is TRUE.

When a client application requests a connection with an AppServer, the Application Broker creates an area to store this value for the connection. The initial value is the unknown value (?).

This attribute, while available in all AppServer operating modes, has practical application only on a stateless AppServer, where more than one Application Server process can service the same client connection. This value is available to any Connect procedure, Activate procedure, Deactivate procedure, or Disconnect procedure that you have configured for the AppServer, as well as any application procedure. Thus, each Application Server process that services a client connection can pass context information to the next.

Within an Application Server process, Progress sets the SERVER-CONNECTION-CONTEXT attribute to the unknown value (?) each time a new connection is assigned to the process. If the AppServer operating mode is state-aware or state-reset, Application Server procedure can also reset this attribute to an application-specific value. However, any such value does not last beyond the current client connection within the current Application Server session. Thus, Application Server processes running on a state-aware or state-reset AppServer cannot pass information among themselves using this attribute.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095