PQ78058: ASSEMBLING J2EE APPLICATIONS MANUAL FAILS TO NOTE THAT EXPORT / IMPORT OF A SERVER MAY CAUSE AN ERROR

APAR status
Closed as documentation error.

Error description
Assembling J2EE Applications manual: SA22-7836
Chapter 17. Installing applications in a WebSphere for z/OS
server.
Steps for using the export/import process through the
Administration application
------------------------------------------------------------
  Customer used EXPORT and IMPORT of a server "model".  This
caused an error because the RemoteWebContainer app exported
was at a different maint level than the system it was imported
on.
  The documentation needs to note that the RemoteWebContainer
app is dependent on the current websphere maint level and that
it may not be compatable with the websphere maint level of the
system you are importing your model to.
---------------------------------------------------
local fix:  You can guarentee you have the correct version of
RemoteWebContainer app by:
1) deleting the RemoteWebContainer app in a sm eui conversation.
2) download the latest copy of RemoteWebContainer_resolved.ear
 in binary from the WebSphere/bin dir to a temp dir on your pc.
3) in a SEPERATE conversation from the one used to delete the
 RemoteWebContainer app, install RemoteWebContainer_resolved.ear
Local fix
HBC
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: "Chapter 17. Installing applications in *
*                      a WebSphere for z/OS server," of        *
*                      "WebSphere Application Server V4.0.1    *
*                      for z/OS: Assembling J2EE               *
*                      Applications," SA22-7836-06, describes  *
*                      how to use the Administration           *
*                      application export/import process for   *
*                      a J2EE server configuration.            *
*                                                              *
*                      The Customer followed the process, as   *
*                      documented. An error occurred because   *
*                      the RemoteWebContainer application was  *
*                      at a different service level than the   *
*                      service level of the WebSphere          *
*                      Application Server for z/OS system to   *
*                      which it was being imported.            *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The documentation needs to note that the RemoteWebContainer
application is dependent on the current WebSphere for
z/OS maintenance level and that it may not be compatible
with the WebSphere for z/OS maintenance level of the
system to which you are importing your J2EE server
configuration.
Problem conclusion
The following information will be added to "WebSphere
Application Server V4.0.1 for z/OS: Assembling J2EE
Applications," SA22-7836-06, section "Steps for using the
export/import process through the Administration application."
It will precede the steps to perform this export/import:

Before you begin:

The RemoteWebContainer application that is used for this
export/import process must be at the same service level as the
WebSphere Application Server for z/OS system to which you are
exporting your J2EE server configuration. to ensure that this
application is at the correct service level:

1. Delete the RemoteWebContainer application that is contained
   in your Administration application conversation.
2. Locate the latest copy of the
   RemoteWebContainer_resolved.ear file in the
   WebSphere/bin directory of the WebSphere Application Server
   for z/OS system to which you are importing the J2EE Server
   configuration.
3. Download, in binary format, this version of the EAR file to
   a temporary directory on the workstation on which you are
   running the WebSphere Application Server Administration
   application.
4. Install this new version of the
   RemoteWebContainer_resolved.ear file in a separate
   conversation from the one used to delete the original
   version.

NOTE: Periodically, we refresh the documentation on our
      Web site, so this change 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/library/
Temporary fix Comments
APAR information
APAR number PQ78058
Reported component name WEBSPHERE OS/39
Reported component ID 5655A9800
Reported release 401
Status CLOSED DOC
PE NoPE
HIPER NoHIPER
Submitted date 2003-09-03
Closed date 2003-10-02
Last modified date 2003-10-06

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


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 #: PQ78058
IBM Group: Software Group
Modified date: Oct 6, 2003