__ipdbcs() — Retrieve the list of requested DBCS tables to load

Standards

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

Format

#include <__ftp.h>

struct __ipdbcss *__ipdbcs(void);

General description

The __ipdbcs() function determines the values that IP address resolution initialization found in the resolver configuration data set for the keywords LoadDBCSTables. If the LoadDBCSTables keywords are not found in the resolver configuration data set, the structure returned has a count of zero and each element in the structure list points to a NULL string.

Returned value

If successful, __ipdbcs() returns a NULL-terminated character string containing the complete structure __ipdbcss with each entry in __ip_dbcs_list[] initialized either to a valid name or to a NULL string. The number of valid names, up to the maximum of 8, is placed in __ipdbcsnum. If no table names are specified then __ipdbcsnum is set to zero.

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