Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
GETHOSTBYADDR z/OS Communications Server: IP Sockets Application Programming Interface Guide and Reference SC27-3660-00 |
|||||||||||||||||
The GETHOSTBYADDR macro returns domain and alias names of the host whose IPv4 Internet address is specified by the macro. A TCP⁄IP host can have multiple alias names and host IPv4 Internet addresses. The following requirements apply to this call:
>>-EZASMI--TYPE=GETHOSTBYADDR--,HOSTADR--=--+-number---+--------> +-address--+ +-*indaddr-+ '-(reg)----' >--,HOSTENT--=--+-address--+--,RETCODE--=--+-address--+---------> +-*indaddr-+ +-*indaddr-+ '-(reg)----' '-(reg)----' >--+-------------------------+--+------------------------+----->< '-,ERROR--=--+-address--+-' '-,TASK--=--+-address--+-' +-*indaddr-+ +-*indaddr-+ '-(reg)----' '-(reg)----' Note: The storage for the HOSTENT structure returned by
this call is released during TERMAPI processing; therefore, the application
program must not use the HOSTENT storage after the TERMAPI.
Figure 1. HOSTENT structure
returned by the GETHOSTBYADDR macro
GETHOSTBYADDR 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. This structure contains:
The HOSTENT structure uses indirect addressing to return a variable number of alias names and Internet addresses. |
Copyright IBM Corporation 1990, 2014
|