Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : SERVER-CONNECTION-ID attribute
 

SERVER-CONNECTION-ID attribute

(AppServer only; PAS for OE only)
Returns the run-time connection ID of the current client connection assigned to this AppServer session.
Data type: CHARACTER
Access: Read-only
Applies to: SESSION system handle
This attribute is valid only if the REMOTE attribute is TRUE.
This value is assigned by the AppServer broker when an AppServer accepts a connection request from a client application. The AppServer broker and all AppServer agents use the connection ID as an identifier when they log any information associated with the connection. This same connection ID is available to the AppServer agent using the SERVER-CONNECTION-ID attribute and to the connected ABL client using the CLIENT-CONNECTION-ID attribute on the server handle connected to this AppServer.
The value of the connection ID is guaranteed to be globally unique for all time within a single computer network. Connection IDs can be compared to each other strictly for equality, but other types of comparisons are irrelevant.
The AVM ensures that the SERVER-CONNECTION-ID attribute for each AppServer agent is set to the connection ID for the connection that is assigned to the AppServer agent. Each time a new connection is assigned to an AppServer agent, a new value is assigned to the SERVER-CONNECTION-ID attribute.
This attribute is available to any Connect procedure or Disconnect procedure that you have configured for the AppServer. It maintains the same value for these and all other AppServer procedures executed on behalf of the same connection.
If the AppServer operating mode is stateless, the AppServer broker resets the SERVER-CONNECTION-ID attribute for each AppServer agent to the ID of the connection each time it executes a request. The connection ID for a bound stateless AppServer agent remains the same until the server process becomes unbound and receives a request from a new unbound connection.
If the AppServer operating mode is state-free, this value has no meaning.
Note: You can identify client context for a user login session on an AppServer running in any operating mode (including state-free) using the ClientContextId property of the Progress.Lang.OERequestInfo class.