tcp.peer-name

function

Library: TCP/IP client and server support (OMTCP)
Import : omtcp.xmd

Returns:

Declaration

define external stream function tcp.peer-name
    of value tcp.connection Connection

Argument definitions

Connection: is an existing tcp.connection object.

Purpose

Use tcp.peer-name to get the fully-qualified domain name of the peer host on the other side of a connection.

Requirements

Connection must exist (else external Exception TCP05).

Usage Notes

If tcp.peer-name fails to get the fully-qualified domain name of the host machine, external exception TCP01 is thrown.

Example

  import "omtcp.xmd" prefixed by tcp.
  
  process
     local tcp.service Demo
     local tcp.connection Client
  
     set Demo to tcp.service at 5600
  
     repeat
        set Client to tcp.accept-connection from Demo
        output "Request from " ||  tcp.peer-name of Client || "%n"
        ;process request
     again

Related Topics

Other Library Functions