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

Declaration

  define external function TCPServiceClose
     value TCPService this-TCPService

This function closes a TCP service object, effectively detaching the program from the TCP port. Once closed, no more client connection requests can be accepted.

It is valid to use TCPServiceClose on a TCP service object that is already closed or that was never opened. In both cases, TCPServiceClose simply does nothing.

Note that allowing an OmniMark TCP service variable to go out of scope (exiting a local scope for a local variable, or exiting the OmniMark program for a global variable) has the effect of doing a TCPClose on the variable. As long as TCP service variables are declared at a scope level that corresponds to the lifetime of the service (which is good programming practice) there is never any need to use TCPClose.

Argument:

• "this-TCPService" is an OMX component of type TCPService.

Example

  TCPServiceClose omdemo-service

Other Library Functions    TCPConnection    TCPConnectionClose    TCPConnectionGetCharacters    TCPConnectionGetLine    TCPConnectionGetOutput    TCPConnectionGetPeerIP    TCPConnectionGetPeerName    TCPConnectionGetSource    TCPConnectionGetStatusReport    TCPConnectionHasCharactersToRead    TCPConnectionIsConnected    TCPConnectionIsInError    TCPConnectionOpen    TCPConnectionPut    TCPConnectionSetBuffering    TCPConnectionSignalSourceEnd    TCPIsVersionCompatible    TCPLibraryVersion    TCPService    TCPServiceAcceptConnection    TCPServiceClose    TCPServiceGetPort    TCPServiceGetStatusReport    TCPServiceIsInError    TCPServiceIsOpen    TCPServiceOpen    TCPTraceConnectionOpen

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