PQ55745: RECEIVING RC=4 CB390CFG WHILE EXECUTING WCMIGRATE.REXX FROM BBOWCMIG JCL

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
The customer received a return code " 4 " after submitting
BBOWCMIG JCL to execute wcmigrate.rexx to migrate a J2EE server
with a V4.0 RemoteWebContainer to a V4.0.1 RemoteWebContainer.
Error messages:
BBON3007E Writing output file failed.
message.1  =  BBON3199E Method commitconversation failed.
message.2  =  BBON3197E UserID xxxxxxx not authorized for
administration
Returncode from Create J2EE Resource is: 4
Returncode from Commit Conversation is: 4
BBOWCMIG MCFGA - STEP WAS EXECUTED - COND CODE 0012
..
If the return code is '0', you will get a 'clean' output of the
object properties on which you have processed this function.
..
If the return code is '4', the script fails and the error
message will be written into the 'output_file' which, in the
previous case, would include the 'clean' output.
There you can get the error message out and print it to the
script output (i.e. with XMLPARSE).
Local fix
1) Copy wcmigrate.rexx from /usr/lpp/WebSphere/bin to some other
 directory where you can modify the file
2) Edit the file and search for the line where
'tmp_wc_ear_prefix'
is set.  It will need to be modified to point
to a directory that has universal access for read and write (ie
permission 777, but not the 'sticky' bit).  For example, it
could be set to
tmp_wc_ear_prefix="/u/john/mytmp/wc_"  MAKE SURE THIS DIRECTORY
EXISTS AND HAS THE RIGHT PERMISSIONS.
This will ultimately be used as the path and first part of the
file name for the ear file (ie, /u/john/mytmp/wc_servername.ear)
3) Save away wcmigrate.rexx
4) Copy wcmigrate.sh from /usr/lpp/WebSphere/bin to some other
directory where you can modify the file  (Note, this may have
already been done because of the previous '*' problem.
If so, just use that one to add another modification.
5) Edit the file and go to the last line.  This is where
wcmigrate.sh calls wcmigrate.rexx. By default, it calls the one
in installpath.  It will need to be modified to point to the
 modified wcmigrate.rexx.
 6) Lastly, BBOWCMIG JCL will need to be modified (if it hadn't
already been done because of '*'), to point at the new
 wcmigrate.sh.

 Then run the job.
Problem summary
****************************************************************
* USERS AFFECTED: All users of the WebSphere Application       *
*                 Server Version V4.0.1 for z/OS and OS/390.   *
****************************************************************
* PROBLEM DESCRIPTION: While executing wcmigrate.rexx, if      *
*                      the script fails with a non-zero        *
*                      return code, there is no output to      *
*                      determine what the exact error is and   *
*                      it is also difficult to determine which *
*                      part of the script is failing.          *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The script should be updated in the case of a non-zero return
code to obtain the error messages and print them to STDOUT so
that the user can determine what is failing.
Problem conclusion
The wcmigrate.rexx script has been modified to check the
return code from each CB390CFG call.  On any non-zero return
code, XMLPARSE is invoked to obtain error messages
associated with the failing return code and print them to
STDOUT.

Additionally, wcmigrate.rexx was modified to create a
subdirectory within /tmp as a temporary location to store the
symbolic link to the .ear file that is being deployed.  The
permissions of this directory are set so that the Systems
Management Server can properly access the .ear file.

This change affects COMPID 5655A9800 R401 for z/OS and OS/390.
The code changes are stored in CMVC under defect PQ55745.
401Y
EJSSMI01

* Cross Reference between External and Internal Names
Temporary fix Comments
APAR information
APAR number PQ55745
Reported component name WEBSPHERE OS/39
Reported component ID 5655A9800
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2001-12-11
Closed date 2002-04-12
Last modified date 2002-05-02

APAR is sysrouted FROM one or more of the following:

APAR is sysrouted TO one or more of the following:

Modules/Macros
EJSSMI01          

Fix information
Fixed component name WEBSPHERE OS/39
Fixed component ID 5655A9800

Applicable component levels
R401 PSY UQ65118    UP02/04/26 P F204

  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 #: PQ55745
IBM Group: Software Group
Modified date: May 2, 2002