z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


GetHostString

z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference
SC27-3660-00

The GetHostString procedure call uses a table lookup to convert an internet address dotted decimal format to a host name, and returns this string in the Name field. The first host name found in the lookup is returned. If no host name is found, a gateway or network name is returned. If no gateway or network name is found, a null string is returned. An example is shown in Figure 1.

Figure 1. GetHostString example
   procedure GetHostString
            (
                 Address: InternetAddressType;
        var    Name: SiteNameType
            );
            external;
Parameter
Description
Address
The address to be converted. The address must be in dotted decimal format.
Name
Set to the corresponding host, gateway, or network name, or to null string if a match is not found. The maximum length is 24 characters.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014