PQ60591: MSGBBOU0510E FUNCTION GETHOSTBYNAME() FOR HOSTNAME "HOST" FAILEDWITH RV=0, RC=0, RSN=000000000 EDC5000I NO ERROR OCCURRED.

APAR status
Closed as fixed if next.

Error description
Message BBOU0501E is issued followed by message BBOU0051E during
WebSphere Application Server startup.
BBOU0510E function gethostbyname() for host "host.name" failed
with RV=0, RC=0, RSN=00000000, EDC5000I  EDC5000I No error
occurred.
BBOU0051E Internal communications error: REASON=C9C20C30.
Using the command onslookup for "host.name", the customer
discovered his "host.name" had not been added to his domain name
server.  Message BBOU0510E should have had a non-zero value for
RC and RSN, and instead of the text "No error occurred", some
other more meaningful text should have appeared, such as "Host
not found".
The customer used the onslookup command for the host name given
in MSGBBOU0510I and discovered it did not exist in his Domain
Name Server. With errors of this type the general process is to
nslookup the host name to obtain the IP address. Then nslookup
the returned IP address to make sure the IP address names the
expected host name.  Once the IP name exists and maps to the
correct IP address these kinds of problems go away.
Local fix
Issue the onslookup command from TSO or OMVS specifying the host
name from MSGBBOU0510E. If onslookup fails then examine the
networking definitions to ensure the host has been defined. If
the onslookup command succeeds and returns an IP address, issue
another nslookup command specifying the returned IP address. If
the returned host name is not the same as the one in message
BBOU0510E then again examine the networking definitions. These
simple tests usually identify the problem preventing
gethostbyname() from completing successfully.
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: Insufficient error information is       *
*                      returned in messages BBOU0510E and      *
*                      BBOU0509E when reporting errors in      *
*                      gethostbyaddr and gethostbyname.        *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
Messages BBOU0510E and BBOU0509E are used to report errors
in the gethostbyaddr and gethostbyname services.  The messages
contain the values of errno and the message text that goes
with that errno.  However, these services do not set errno,
so the message always reports a value of zero.  The correct
place to look for this information is in the h_errno variable.
The relevant code should be updated to report the correct
error value.  Since these problems are usually related to Domain
Name Server (DNS) problems,  the nslookup and onslookup
commands may help debug whatever problem is occuring.
Problem conclusion Temporary fix Comments
This APAR is being closed FIN with concurrence from the
submitting customer. A solution to this problem will be
delivered in a WebSphere Application Server for z/OS
and OS/390 release within the next 18 months.
APAR information
APAR number PQ60591
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED FIN
PE NoPE
HIPER NoHIPER
Submitted date 2002-04-26
Closed date 2002-05-17
Last modified date 2002-05-17

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros

Fix information

Applicable component levels
R401 PSN    UP


Document Information


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ60591
IBM Group: Software Group
Modified date: May 17, 2002