SERVER-CONNECTION-BOUND-REQUEST attribute

(AppServer only; PAS for OE only)

Tells an AppServer agent running on a stateless AppServer to bind or unbind its current client connection.

Data type: LOGICAL

Access: Readable/Writeable

Applies to: SESSION system handle

This attribute is valid only if the REMOTE attribute is TRUE and the operating mode is stateless.

When set to TRUE, requests that the AppServer agent makes its connection bound to the current client connection identified by the SERVER-CONNECTION-ID attribute.

When set to FALSE, requests that the AppServer agent makes its connection unbound from the currently bound client connection pending the deletion of all remote persistent procedures running in the session. When all remote persistent procedure for the connection have been deleted, the AppServer agent becomes available to service a different client connection. The SERVER-CONNECTION-BOUND attribute for the session is also set to FALSE when the AppServer agent becomes available.

In state-free operating mode, any attempt to set this attribute raises a WARNING condition in the AppServer agent, which writes a message to the AppServer 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 state-free operating mode, this attribute always has the Unknown value (?).

Note: This attribute has no effect on AppServer sessions running in state-aware or state-reset mode.