__ipdspx() — Retrieve the data set prefix specified

Standards

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

Format

#include <__ftp.h>

char *__ipdspx(void);

General description

The __ipdspx() function determines the value that IP address resolution initialization found in the resolver configuration data set for the keyword DataSetPrefix. If no DataSetPrefix keyword is found in the resolver configuration data set, then the default value is returned.

Returned value

If successful, __ipdspx() returns the NULL-terminated character string that was supplied in the configuration data set. If the configuration data set did not supply a value for the keyword DataSetPrefix, then __ipdspx() returns the string TCPIP.

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