PQ91340: ORB_LISTENER_ADDRESS and ORB_SSL_LISTENER_ADDRESS values documented incorrectly

 A fix is available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
The server End Points ORB_LISTENER_ADDRESS and
ORB_SSL_LISTENER_ADDRESS are incorrectly documented in the
WebSphere for z/OS infocenter.
These fields default to "*" if not set in the adminconsole.
These fields may only contain "*" or a dotted decimal IP address
in the form www.xxx.yyy.zzz where www, xxx, yyy and zzz are the
decimal values 0-255. These fields may not contain IP names of
any sort. The infocenter should be updated to correct this
documentation error.
  When an IP name is specified then the control region ends
abnormally during initialization with minor code C9C21152.
Local fix
Ensure that ORB_LISTENER_ADDRESS and ORB_SSL_LISTENER_ADDRESS
are either set to * (asterisk) or to the dotted decimal IP
address of the specific network interface to which the server
should be bound.
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V5.0 for z/OS                                *
****************************************************************
* PROBLEM DESCRIPTION: The server End Points                   *
*                      ORB_LISTENER_ADDRESS and                *
*                      ORB_SSL_LISTENER_ADDRESS are            *
*                      incorrectly documented in the           *
*                      InfoCenter.                             *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The server End Points  ORB_LISTENER_ADDRESS and
ORB_SSL_LISTENER_ADDRESS are incorrectly documented in the
InfoCenter.
These fields default to "*" if not set  in the administrative
console.  These fields may only contain "*" or a dotted decimal
IP address in the form www.xxx.yyy.zzz where www,
xxx, yyy and zzz are the decimal values 0-255. These fields may
not contain IP names of any sort.
Problem conclusion
A change to the InfoCenter is required as a result of APAR
PQ91340. Also, help text shipped with the administrative console
are also updated.

To access the latest online documentation, go to the product
library page at:

www.ibm.com/software/webservers/appserv/zos_os390/library/

"End point settings"(urun_rendpoint_inst.html),
now reads:

On the z/OS platform, the ORB_LISTENER_ADDRESS and
ORB_SSL_LISTENER_ADDRESS end points can be set only to a wild
card (*) value, or a dotted
decimal IP address in the form www.xxx.yyy.zzz where www, xxx,
yyy and zzz are the decimal values 0-255. These end points
cannot be set to a fully qualified DNS name such as
myhost.myco.com.

"Administration application settings as they compare to the
Version 5 administrative console settings"(rins_adminz.html),
now reads:
IIOP Firewall port
Click Servers > Application Servers > server_name.
Under Additional Properties, click End Points >
ORB_LISTENER_ADDRESS.
Leave the host field blank or specify it as a wild card (*).
Do not set the host field to a fully qualified DNS name such as
myhost.myco.com.  Type the port number into the Port field.

SSL Firewall port
Click Servers > Application Servers > server_name.
Under Additional Properties, click End Points >
ORB_SSL_LISTENER_ADDRESS.
Leave the host field blank or specify it as a wild card (*).
Do not set the host field to a fully qualified DNS name such
as myhost.myco.com. Type the port number into the Port field.

"Configuring inbound transports" (tsec_inboundtransport.html),
now reads:
On the z/OS platform, the host field for ORB_LISTENER_ADDRESS
can be set only to a wild card (*) value, or a dotted decimal
IP address in the form www.xxx.yyy.zzz where www, xxx, yyy and
zzz are the decimal values 0-255. These end points cannot be
set to a fully qualified DNS name such as myhost.myco.com.

APAR PQ91340 is associated with SERVICE LEVEL W502018 of
WebSphere Application Server V5.0 for z/OS.
Temporary fix Comments
APAR information
APAR number PQ91340
Reported component name WEBSPHERE FOR Z
Reported component ID 5655I3500
Reported release 500
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Special Attention NoSpecatt
Submitted date 2004-07-13
Closed date 2004-11-12
Last modified date 2004-12-02

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:
PQ90567

Modules/Macros
BBOUBINF          

Publications Referenced

Fix information
Fixed component name WEBSPHERE FOR Z
Fixed component ID 5655I3500

Applicable component levels
R500 PSY UQ95030    UP04/11/18 P F411

  Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.


Document Information


Current web document: swg1PQ91340.html
Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 500
Software edition:
Reference #: PQ91340
IBM Group: Software Group
Modified date: Dec 2, 2004