Library: TCP/IP client and server support (OMTCP) legacy Include: omtcp.xin

Return type: tcp-connection Returns:

Declaration

define external tcp-connection function tcp-accept-connection
       value    tcp-service    service

Argument definitions

service

is a previously created tcp-service object.

Use tcp-accept-connection in a server program to accept incoming client-initiated service requests. The function returns a tcp-connection OMX component.

Requirements

You must include the following line at the beginning of your OmniMark program:

  include "omtcp.xin"

service must have been previously created and must exist (else external exception TCP05).

Usage Notes

External exception TCP10 is thrown if an error occurs while the connection request is being accepted. The message supplied with the exception contains the error code from the operating system for the error that occurred.

Example #1

In this example a variable of type tcp-service was declared. For the service to be destroyed the variable must either go out of scope or be explicitly destroyed with tcp-destroy-service.

  local tcp-service omdemo-service
  local tcp-connection client
  
  set omdemo-service to tcp-create-service at 5600
  
  repeat
     set client to tcp-accept-connection omdemo-service
     ;process request
  again

Example #2

In this example no tcp-service type variable was declared. The only way for the service to be destroyed is for the service to go out of scope.

  local tcp-connection client
  
  repeat
     set client to tcp-accept-connection tcp-create-service at 5600
     ;process request
  again

Other Library Functions    tcp-accept-connection    tcp-connect    tcp-connection    tcp-create-service    tcp-destroy-service    tcp-disconnect    tcp-get    tcp-has-characters    tcp-is-connected    tcp-is-version-compatible    tcp-library-version    tcp-peer-ip    tcp-peer-name    tcp-port    tcp-put    tcp-service    tcp-set-buffering    tcp-signal-source-end    tcp-sink    tcp-source

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]