PQ63259: BBON3199E AND BBON3113E ISSUED WHEN RUNNING BBOWCUPD AND ATTEMPTING TO UPDATE MORE THAN TWO J2EESERVERS.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
Customer is running job BBOWCUPD and fails with the following
two messages: BBON3199E Method listj2ee application failed and
BBON3113E attribute j2eeservername = 4 starts with non OS/390
letter.
These messages are received when customer attempts to update
more than two J2EE servers.
Local fix
Run BBOWCUPD for each server.
Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390                   *
****************************************************************
* PROBLEM DESCRIPTION: The Systems Management scripting API    *
*                      (SMAPI) REXX scripts XMLFIND, XMLPARSE  *
*                      and XMLEXTRACT fail on processing input *
*                      files which contain lines that exceed a *
*                      defined length limit.                   *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
The REXX scripts XMLFIND, XMLPARSE and XMLEXTRACT provided as
part of the SMAPI use a syscall routine (readfile) to read the
input files for processing. The REXX routine imposes a line
length limit of 1024 chars

The scripts need to be modified to allow processing of files
without the restriction of the line length limit to allow for
successful parsing of the input files.
Problem conclusion
A new REXX script (XMLUTIL) was introduced which  implements
the functionality of the original REXX scripts, as well as adds
new functionality. The REXX scripts XMLFIND, XMLPARSE
and XMLEXTRACT now act as wrappers to XMLUTIL.

APAR PQ63259 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:

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

WebSphere Application Server V4.0.1 for z/OS and OS/390
System Management Scripting API (SA22-7839-04)
will be changed as follows:

Chapter 6. XMLPARSE
  Subtopic "XMLPARSE Script Code"

The header information of the REXX script remains the
the same, but replace the code of the REXX script with the
following:

parse arg filename nameorvalue

filename = "/tmp/"||filename


rc=XMLUTIL("PARSE" filename nameorvalue)

return rc
exit

Chapter 7. XMLFIND
  Subtopic "XMLFIND Script Code"

The header information of the REXX script remains the
the same, but replace the code of the REXX script with the
following:

parse arg filename namevalue

filename="/tmp/"||filename

rc=XMLUTIL("FIND" filename namevalue)

return rc
EXIT

Chapter 8. XMLEXTRACT
  Subtopic "XMLEXTRACT Script Code"

The header information of the REXX script remains the
the same, but replace the code of the REXX script with the
following:

parse arg filename line nameorvalue

filename="/tmp/"||filename

rc=XMLUTIL("EXTRACT" filename line nameorvalue)

return rc
EXIT

Chapter 9. XMLUTIL

This REXX script is called by XMLPARSE, XMLFIND, and
XMLEXTRACT. XMLUTIL cannot be called directly, so there
is no syntax.

XMLUTIL Script Code

/* REXX ---------------------------------------------------- */
/* ========================================================= */
/*                                                           */
/* COPYRIGHT =                                               */
/* Licensed Material - Property of IBM                       */
/*                                                           */
/* 5655-A98 (C) Copyright IBM Corp. 2000                     */
/* All Rights Reserved.                                      */
/* U.S. Government users - RESTRICTED RIGHTS - Use,          */
/* Duplication, or Disclosure restricted by GSA-ADP schedule */
/* contract with IBM Corp.                                   */
/* Status = H28K510                                          */
/*                                                           */
/* FILENAME: XMLUTIL                                         */
/*                                                           */
/*                                                           */
/* FUNCTION:                                                 */
/* REXX script for getting the value of the specified        */
/* attribute                                                 */
/*                                                           */
/* ========================================================= */
/* This script implements the functions of the REXX scripts  */
/* XMLFIND XMLPARSE and XMLEXTRACT                           */

parse arg action parms

select
   when action == "FIND" then do
      parse var parms filename namevalue
      info=readline(filename)
      do i=0 to value(info.0)
         line=value(info'.i')
         parse var line var_name var_value
         if var_name = namevalue then
            return var_value
      end
   return 4
   end

   when action == "PARSE" then do
      parse var parms filename nameorvalue
      info=readline(filename)
      do i=1 to value(info.0)
         line=value(info'.i')
         parse var line var_name var_value
         if nameorvalue = "V" then
            say var_value
         if nameorvalue = "N" then
            say var_name
         if nameorvalue = "ALL" then
            say var_name " = " var_value
      end
   return 0
   end

   when action == "EXTRACT" then do
      parse var parms filename line_num nameorvalue
      info=readline(filename)
      line=value(info'.line_num')
      parse var line var_name var_value
      if var_name = 'status' then
         return 0
      if nameorvalue = "V" then
         return var_value
      if nameorvalue = "N" then
         parse var var_name var_name '.' var_nr
      return var_name
   end
end
EXIT

readline:
   parse arg filename
   info.=0
   ADDRESS SYSCALL
   stat filename st.
   open filename o_rdonly
   if retval=-1 then
      return info
   fd=retval
   read fd buffer st.ST_SIZE
   if retval=-1 then
      return info
   close fd
   ADDRESS

   do i=1 until buffer==""
       parse var buffer info.i (esc_n) buffer
   end
   info.0=i
   return info

Since Chapter 9. XMLUTIL is a new chapter in the
book, the numbers of all subsequent Chapters will
incremented by 1.

APAR PQ63259 is associated with SERVICE LEVEL W401095 of
WebSphere Application Server V4.0.1 for z/OS and OS/390.
Temporary fix Comments
APAR information
APAR number PQ63259
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-07-17
Closed date 2002-08-14
Last modified date 2002-09-04

APAR is sysrouted FROM one or more of the following:

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

Modules/Macros
BBOUBINF BBOZ0694 BBOZ0696 BBOZ0697 BBOZ0986  

Fix information
Fixed component name WASKBASE
Fixed component ID 5655A9801

Applicable component levels
R401 PSY UQ68998    UP02/08/22 P F208

  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 #: PQ63259
IBM Group: Software Group
Modified date: Sep 4, 2002