__iptcpn() — Retrieve the resolver supplied jobname or user ID

Standards

Standards / Extensions C or C++ Dependencies
z/OS® UNIX both  

Format

#include <__ftp.h>

char *__iptcpn(void);

General description

The __iptcpn() function lets an application determine the values that IP address resolution initialization found in the resolver configuration data set for either of the keywords TCPIPuserid or TCPIPjobname, whichever is the last one read. If neither keyword is found in the resolver configuration data set, the char string returned will be a NULL string.

Returned value

If successful, __iptcpn() returns the NULL-terminated character string which is the name supplied on the TCPIPuserid or TCPIPjobname keyword found in the resolver configuration file.

If unsuccessful, __iptcpn() returns NULL and stores one of the following error values in h_errno. __iptcpn() 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