SOCK gate, SURRENDER function

This function requests the owner of a dormant session table entry (STE) to surrender control of it so that its resources can be used by another transaction. A dormant STE is one that is between transactions: it is waiting for another client interaction in a persistent connection.

Input Parameters

STE_PTR
The address of the session table entry (STE).

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • LOCK_FAILURE
  • LOOP
  • SOCKET_IN_USE
The following values are returned when RESPONSE is EXCEPTION:
  • ADDRESS_IN_USE
  • ADDRESS_NOT_AVAILABLE
  • ALREADY_ASSOCIATED
  • CLIENT_ERROR
  • CONNECTION_CLOSED
  • CONNECTION_REFUSED
  • INSUFFICIENT_STORAGE
  • INSUFFICIENT_THREADS
  • INVALID_OPTION
  • IO_ERROR
  • MISSING_OPTION
  • NEVER_ASSOCIATED
  • NO_CONNECTION
  • NO_SOCKET_AVAILABLE
  • NOT_AUTHORIZED
  • NOT_PENDING
  • NOTIFICATION_UNAVAILABLE
  • NOTIFIED
  • SCHEDULED
  • SSL_HANDSHAKE_ERROR
  • STATE_ERROR
  • TCP_NOT_ACTIVE
  • UNKNOWN_SESSION_TOKEN
The following values are returned when RESPONSE is INVALID:
  • INVALID_FORMAT
  • INVALID_FUNCTION
The following values are returned when RESPONSE is PURGED:
  • TASK_CANCELLED
  • TIMED_OUT
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


dfhs3_SOCKsurrender.html | Timestamp icon Last updated: Monday, 5 June 2017