(PAS for OE only)

An application-determined value that you set within an application server session. The AVM passes this value to each application server session that executes a request on behalf of the client connection identified by the SERVER-CONNECTION-ID attribute.

Data type: CHARACTER

Access: Readable/Writeable

Applies to: SESSION system handle

This attribute is valid only if the REMOTE attribute is TRUE.

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

This attribute, while available in session-managed and session-free operating modes, has practical application only on a session-managed application server, where more than one application server session 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 application server, as well as any application procedure. Thus, each application server session that services a client connection can pass context information to the next.

For an application server session, the AVM sets the SERVER-CONNECTION-CONTEXT attribute to the Unknown value (?) each time a new connection is assigned to the process. If the application server operating mode is session-managed, the application server session 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 sessions running on a session-managed application server cannot pass information among themselves using this attribute.

In session-free operating mode, any attempt to set this attribute raises a WARNING condition in the application server session, which writes a message to the application server log file, and the value remains unchanged. You can handle the WARNING condition by including the NO-ERROR option in the statement that attempts to set the value, and checking ERROR-STATUS:NUM-MESSAGES for a value greater than zero. In session-free operating mode, this attribute always has the Unknown value (?).