__iphost() — Retrieve the resolver supplied hostname
Standards
| Standards / Extensions | C or C++ | Dependencies |
|---|---|---|
| z/OS® UNIX | both |
Format
#include <__ftp.h>
char *__iphost(void);General description
The __iphost() function lets an application determine the values that IP address resolution initialization found in the resolver configuration data set for the keyword HOSTname. If the keyword is not found in the resolver configuration data set, the char string returned will be a NULL string.
Returned value
If successful, __iphost() returns the NULL-terminated character string, which is the name supplied on the HOSTname keyword found in the resolver configuration file.
If unsuccessful, __iphost() returns NULL and stores one of the
following error values in h_errno. __iphost() is only unsuccessful
if IP Address Resolution initialization fails to complete.
- Error Code
- Description
- NO_RECOVERY
- An error occurred that will continue to fail if tried again. Storage could not be obtained for this thread to contain the _res structure.
- TRY_AGAIN
- An error occurred while initializing the __res_state structure name selected, which can be retried.
Related information
- __ftp.h — FTP resolver functions
- __ipdbcs() — Retrieve the list of requested DBCS tables to load
- __ipdspx() — Retrieve the data set prefix specified
- __ipmsgc() — Determine the case to use for FTP messages
- __ipnode() — Retrieve the resolver supplied node name
- __iptcpn() — Retrieve the resolver supplied jobname or user ID