tcp-destroy-service

function

Library: TCP/IP client and server support (OMTCP legacy, OmniMark versions 6.0.2 - 7.0)
Include: omtcp.xin

Declaration
define external function tcp-destroy-service
 value tcp-service thisTCPService
 as TCPServiceClose


Purpose

Use tcp-destroy-service to explicitly close a TCP service object, effectively detaching the program from the TCP port.

Requirements

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

  include "omtcp.xin"

Usage Notes

You can use tcp-destroy-service to destroy a sevice that has never been created or has already been destroyed.

Allowing the tcp-service variable to go out of scope has the same effect as using tcp-destroy-service.

No more client connection requests can be accepted once the connection is closed.

Example


  local tcp-service DemoService
  	. . .
  set DemoService to tcp-create-service at 5600
  	. . .
  tcp-destroy-service DemoService