PQ67705: GENERATED DIRECTIONS FOR RUNNING BBOIRC2 NEED CORRECTION.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
In the generated directions from boss_wizard the BBOIRC2 section
that begins "If you get message BBOU0713W and/or abend EC3
rsn-04130001, indicating a time-out, do the following:" has two
problems.
1) file configuration.env is not a valid file name at this time
2) Before re-running BBOIRC2, the IR server must be recycled
   (to pick up the changed OTS timeout values)
Local fix
1) Instead of configuration.env, update file current.env
2) Before re-running BBOIRC2, recycle the IR server
   (to pick up the changed OTS timeout values)
"Recycle" means you stop and then start the server.
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: The WebSphere for z/OS Customization    *
*                      Dialog has some incorrect text          *
*                      concerning BBOIRC2 in the generated     *
*                      instructions.                           *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
"configuration.env" is not currently a valid file name, and the
IR server must be recycled before re-running BBOIRC2 in order to
pick up the changed OTS timeout values.

The dialogs were updated to change "configuration.env" to
"current.env", add a step in the process instructing the user to
recycle the IR server, and renumber the steps. The change will
be reflected in the WebSphere for z/OS Installation and
Customization book in a future refresh.
Problem conclusion
A change to the WebSphere V4.0.1 for z/OS Customization Dialogs
was made.

The change is to the file BBOINSTR, section BBOIRC2 which now
reads:

+----------+---------------------------------------------------+
| BBOIRC2  | User ID requirement: CBADMIN user ID.             |
+----------+                                                   |
| Done:    | This job runs the second Interface Repository     |
|          | client.                                           |
|          |                                                   |
|          | Run this job with a user ID that is in the access |
|          | list for the CORBA portion of the name space.     |
| By:      |                                                   |
|          | ...                                               |
|          |                                                   |
|          | If you get message BBOU0713W and/or abend EC3     |
|          | rsn-04130001, indicating a time-out, do the       |
|          | following:                                        |
|          |                                                   |
|          | 1.  Update the OTS_DEFAULT_TIMEOUT and            |
|          |     OTS_MAXIMUM_TIMEOUT values in the environment |
|          |     file for the INTFRP01 server instance.  The   |
|          |     environment file is located in:               |
|          |                                                   |
|          |       /WebSphere390/CB390                         |
|          |         /controlinfo                              |
|          |            /envfile                               |
|          |               /MCLXCF01                           |
|          |                  /INTFRP01/current.env            |
|          |                                                   |
|          |     Set the values of both environment variables  |
|          |     to 3600 or greater.                           |
|          |                                                   |
|          | 2.  Recycle the IR server in order to pick up the |
|          |     changed OTS timeout values.                   |
|          |                                                   |
|          | 3.  Re-run BBOIRC2, starting at the failed step as|
|          |     explained above.                              |
|          |                                                   |
|          | 4.  After BBOIRC2 completes successfully, re-set  |
|          |     the OTS_DEFAULT_TIMEOUT and                   |
|          |     OTS_MAXIMUM_TIMEOUT values to 300.            |
|          |                                                   |
+----------+---------------------------------------------------+

The following publication was revised as a result
of APAR PQ67705:
________________________________________________________________
WebSphere Application Server V4.0.1 for z/OS and OS/390
Installation and Customization
GA22-7834-06
________________________________________________________________
This APAR requires changes to documentation.

NOTE: Periodically, we refresh the documentation on our
Web site, so the changes might have been made before you
read this text. To access the latest on-line
documentation, go to the product library page at:


http://www.ibm.com/software/webservers/appserv/zos_os390
________________________________________________________________

Appendix B, pg. 451 (changed information)

+----------+---------------------------------------------------+
| BBOIRC2  | User ID requirement: CBADMIN user ID.             |
+----------+                                                   |
| Done:    | This job runs the second Interface Repository     |
|          | client.                                           |
|          |                                                   |
|          | Run this job with a user ID that is in the access |
|          | list for the CORBA portion of the name space.     |
| By:      |                                                   |
|          | ...                                               |
|          |                                                   |
|          | If you get message BBOU0713W and/or abend EC3     |
|          | rsn-04130001, indicating a time-out, do the       |
|          | following:                                        |
|          |                                                   |
|          | 1.  Update the OTS_DEFAULT_TIMEOUT and            |
|          |     OTS_MAXIMUM_TIMEOUT values in the environment |
|          |     file for the INTFRP01 server instance.  The   |
|          |     environment file is located in:               |
|          |                                                   |
|          |       /WebSphere390/CB390                         |
|          |         /controlinfo                              |
|          |            /envfile                               |
|          |               /MCLXCF01                           |
|          |                  /INTFRP01/current.env            |
|          |                                                   |
|          |     Set the values of both environment variables  |
|          |     to 3600 or greater.                           |
|          |                                                   |
|          | 2.  Recycle the IR server in order to pick up the |
|          |     changed OTS timeout values.                   |
|          |                                                   |
|          | 3.  Re-run BBOIRC2, starting at the failed step as|
|          |     explained above.                              |
|          |                                                   |
|          | 4.  After BBOIRC2 completes successfully, re-set  |
|          |     the OTS_DEFAULT_TIMEOUT and                   |
|          |     OTS_MAXIMUM_TIMEOUT values to 300.            |
|          |                                                   |
+----------+---------------------------------------------------+
APAR PQ67705 is associated with SERVICE LEVEL W401406 of
WebSphere Application Server V4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ67705
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-10-29
Closed date 2002-12-10
Last modified date 2003-01-04

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
BBOUBINF          

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ72501    UP02/12/17 P F212

  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


Product categories: Software > Application Servers > Distributed Application & Web Servers > WebSphere Application Server for z/OS
Operating system(s):
Software version: 401
Software edition:
Reference #: PQ67705
IBM Group: Software Group
Modified date: Jan 4, 2003