swirl Guide to OmniMark 6   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesOMX VariablesErrors
 
  Related Syntax     Other Library Functions  
function   tcp-peer-name   Available in:
Professional
Enterprise

Library: omtcp - TCP/IP client and server support
Include: omtcp.xin
Return type: String
Returns:       

Declaration

  define external stream function tcp-peer-name
         value tcp-connection Connection
  where
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

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

  include "omtcp.xin"

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


  local tcp-service Demo
  local tcp-connection Client

  set Demo to tcp-service at 5600

  repeat
     set Client to tcp-accept-connection Demo
     output "Request from " ||  tcp-peer-name Client || "%n"
     ;process request
  again

    Related Syntax
   tcp-connection
   tcp-disconnect
   tcp-sink
   tcp-get
   tcp-peer-ip
   tcp-source
   tcp-has-characters
   tcp-is-connected
   tcp-put
   tcp-connect
   tcp-set-buffering
   tcp-signal-source-end
 
  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
 
----  

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ ERRORS ]

OmniMark 6.5 Documentation Generated: December 23, 2002 at 6:25:42 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © OmniMark Technologies Corporation, 1988-2002.