Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
Parameter values returned to the application z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference SC27-3660-00 |
|
Figure 1. HOSTENT structure
returned by the GETHOSTYBYNAME call
GETHOSTBYNAME returns the HOSTENT structure shown in Figure 1. The HOSTENT structure is a
tasks's serially reusable storage area. It should not be used or referenced
between MVS™ tasks. The storage
is freed when the task terminates. The assembler mapping of the structure
is defined in macro EZBREHST, which is installed in the data set specified
on your SMP/E DDDEF for MACLIB. The EZBREHST assembler macro is stored
in the SYS1.MACLIB library. The macro defines the resolver hostent
(host entry), address information (addrinfo) mappings, and services
return codes. This structure contains:
The HOSTENT structure uses indirect addressing to return a variable number of alias names and IP addresses. If you are coding in PL/I or assembler language, this structure can be processed in a relatively straight-forward manner. If you are coding in COBOL, this structure may be difficult to interpret. You can use the subroutine EZACIC08 to simplify interpretation of the information returned by the GETHOSTBYADDR and GETHOSTBYNAME calls. For more information about EZACIC08, see EZACIC08. |
Copyright IBM Corporation 1990, 2014
|