PQ56468: THIS APAR ADDRESSES DEFECTS IN WEBSPHERE APPLICATION SERVER V4.0.1 FOR Z/OS AND OS/390.

 A fix may be available

Obtain the fix for this APAR



APAR status
Closed as program error.

Error description
This APAR addresses defects in WebSphere Application Server
V4.0.1 for z/OS and OS/390.
Local fix Problem summary
****************************************************************
* USERS AFFECTED: All users of WebSphere Application Server    *
*                 V4.0.1 for z/OS and OS/390.                  *
****************************************************************
* PROBLEM DESCRIPTION: APAR PQ56468 addresses various problems *
*                      in WebSphere Application Server V4.0.1  *
*                      for z/OS and OS/390.                    *
****************************************************************
* RECOMMENDATION:                                              *
****************************************************************
APAR PQ56468 addresses the following problem in
WebSphere Application Server V4.0.1 for z/OS and OS/390:

(MD12390) While running a bean with synch-to-os-thread, the bean
does a USS hfs access which fails with
java.io.FileNotFoundException. An SVCDump is also taken for
ABENDS04C6, REASON=0000000C. During the process of synch-ing the
identity to the z/OS thread, USS security information is not
being updated. Without the update, the access to hfs abends and
returns a file access exception.
Problem conclusion
APAR PQ56468 provides the following problem resolution:

(MD12390) Support has been provided to resolve the
synch-to-OS-thread problem. During the Synch to thread
processing, a call to BPX1TLS has been added to update USS
with the identity being switched to. This support has a
pre-requisite on USS APAR OW51798/PTF UW84303 which enables
the BPX1TLS call to execute from a WebSphere caller.
________________________________________________________________
The following publication was revised as a result
of APAR PQ56468:
________________________________________________________________
WebSphere Application Server V4.0.1 for z/OS and OS/390
System Management Scripting API
SA22-7839-02
________________________________________________________________
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/
________________________________________________________________
________________________________________________________________
Chapter 9, pg. 230 (changed section)

<?xml version='1.0'?>
<!--=========================================================-->
<!--   File name:  inputchangej2eeserver.xml                 -->
<!--                                                         -->
<!--   Descriptive name:  ...                                -->
<!--                                                         -->
<!--   Proprietary statement:                                -->
<!--                                                         -->
<!--                                                         -->
<!--   Licensed Material - Property of IBM                   -->
<!--   5655-F31 (C) Copyright IBM Corp. 2000, 2001           -->
<!--                                                         -->
<!--   All Rights Reserved.                                  -->
<!--                                                         -->
<!--   U.S. Government users - RESTRICTED RIGHTS - Use,      -->
<!--   Duplication, or Disclosure restricted by GSA-ADP      -->
<!--   schedule contract  with IBM Corp.                     -->
<!--                                                         -->
<!--   Status = H28W400                                      -->
<!--                                                         -->
<!--  Change history:                                        -->
<!--$L0=
OW44455, H28K510, 20000721, PDBL: Created.           -->
<!--$L1=
OW44455, CB4.0, 20001205, PDBL: OLT support, security-->
<!--                                            enhancement  -->
<!--$L2=
OW44455, CB4.0, 20010125, PDBL: kerberos, assertedID -->
<!--                                           support       -->
<!--$P0=MD12564,H28W401,20011204, PDBR: Enable SMF properties-->
<!--                                                         -->
<!--=========================================================-->
<!-- internal DTD -->
<!DOCTYPE inputchangej2eeserver
<!ELEMENT security EMPTY>
<!ATTLIST security
 value CDATA #REQUIRED
>
<!ELEMENT environment EMPTY><!ATTLIST environment
 value CDATA #REQUIRED
 name CDATA #REQUIRED
>
<!ELEMENT inputchangej2eeserver (environment*,security*)>
<!ATTLIST inputchangej2eeserver
  acceptassertedid CDATA #REQUIRED
  allowkerberos CDATA #REQUIRED
  allownonauthenticatedclients CDATA #REQUIRED
  allowserverregiongarbagecollection CDATA #REQUIRED
  allowuseridpasswd CDATA #REQUIRED
  allowssl CDATA #REQUIRED
  allowsslclientcerts CDATA #REQUIRED
  conversationname CDATA #REQUIRED
  dcekeytabfile  CDATA #REQUIRED
  dcequalityofprotection CDATA #REQUIRED
  debuggerallowed CDATA #REQUIRED
  enablerunasidentity CDATA #REQUIRED
  garbagecollectioninterval CDATA #REQUIRED
  identityofthecontrolregion CDATA #REQUIRED
  identityoftheserverregion CDATA #REQUIRED
  isolationpolicy CDATA #REQUIRED
  j2eeserverdescription CDATA #IMPLIED
  j2eeservername CDATA #REQUIRED
  localidentity CDATA #REQUIRED
  logstreamname CDATA #IMPLIED
  olthostname CDATA #IMPLIED
  oltport CDATA #REQUIRED
  procname CDATA #IMPLIED
  productionserver CDATA #REQUIRED
  remoteidentity CDATA #REQUIRED
  replicationpolicy CDATA #REQUIRED
  sendassertedid CDATA #REQUIRED
  serverregionjvmname CDATA #IMPLIED
  serverregionrequiresjvm CDATA #REQUIRED
  serverregionstacksize CDATA #REQUIRED
  smfwrserveractivity CDATA #REQUIRED
  smfwrcontaineractivity CDATA #REQUIRED
  smfwrserverinterval CDATA #REQUIRED
  smfwrcontainerinterval CDATA #REQUIRED
  smfintervallength CDATA #REQUIRED
  sslracfkeyring CDATA #REQUIRED
  sslv2timeout CDATA #REQUIRED
  sslv3timeout CDATA #REQUIRED
  transactionfactory CDATA #REQUIRED
  usedce CDATA #REQUIRED
  useibmconfidential CDATA #REQUIRED
  useridpassticket CDATA #REQUIRED
>
 >

<!--begin of default values-->
<inputchangej2eeserver
  acceptassertedid = ''
  allowkerberos = ''
  allownonauthenticatedclients = ''
  allowserverregiongarbagecollection = ''
  allowuseridpasswd = ''
  allowssl = ''
  allowsslclientcerts = ''
  conversationname = ''
  dcekeytabfile = ''
  dcequalityofprotection = ''
  debuggerallowed = ''
  enablerunasidentity = ''
  garbagecollectioninterval = ''
  identityofthecontrolregion = ''
  identityoftheserverregion = ''
  isolationpolicy = ''
  j2eeserverdescription = ''
  j2eeservername = ''
  localidentity = ''
  logstreamname = ''
  olthostname = ''
  oltport = ''
  procname = ''
  productionserver = ''
  remoteidentity = ''
  replicationpolicy = ''
  sendassertedid = ''
  serverregionjvmname = ''
  serverregionrequiresjvm = ''
  serverregionstacksize = ''
  smfwrserveractivity = ''
  smfwrcontaineractivity = ''
  smfwrserverinterval = ''
  smfwrcontainerinterval = ''
  smfintervallength = ''
  sslracfkeyring = ''
  sslv2timeout = ''
  sslv3timeout = ''
  transactionfactory = ''
  usedce = ''
  useibmconfidential = ''
  useridpassticket = ''
>
</inputchangej2eeserver>
________________________________________________________________
Chapter 9, pg. 233 (added section)

importj2eeserver.xml
<?xml version='1.0'?>
<!--=========================================================-->
<!--   File name:  inputimportj2eeserver.xml                 -->
<!--                                                         -->
<!--   Descriptive name:  ...                                -->
<!--                                                         -->
<!--   Proprietary statement:                                -->
<!--                                                         -->
<!-- Licensed Material - Property of IBM                     -->
<!--                                                         -->
<!-- 5655-F31 (C) Copyright IBM Corp. 2000, 2001             -->
<!-- All Rights Reserved.                                    -->
<!-- U.S. Government users - RESTRICTED RIGHTS - Use,        -->
<!-- Duplication, or Disclosure restricted by GSA-ADP        -->
<!-- schedule contract with IBM Corp.                        -->
<!-- Status = H28W401                                        -->
<!--                                                         -->
<!--  Change history:                                        -->
<!--$L0=MD12514, H28W401, 20011018, PDRK: Created.           -->
<!--                                                         -->
<!--=========================================================-->
<!-- internal DTD -->
<!DOCTYPE inputimportj2eeserver
<!ELEMENT inputimportj2eeserver EMPTY>
<!ATTLIST inputimportj2eeserver
  conversationname CDATA #REQUIRED
  inputdirectory CDATA #REQUIRED
  oldj2eeservername CDATA #REQUIRED
  j2eeservername CDATA #REQUIRED
>
 >

<!--begin of default values-->
<inputimportj2eeserver
  conversationname = ''
  inputdirectory = ''
  oldj2eeservername = ''
  j2eeservername = ''
>
</inputimportj2eeserver>
________________________________________________________________
Chapter 9, pg. 233 (added section)

exportj2eeserver.xml
<?xml version='1.0'?>
<!--=========================================================-->
<!--   File name:  inputexportj2eeserver.xml                 -->
<!--                                                         -->
<!--   Descriptive name:  ...                                -->
<!--                                                         -->
<!--   Proprietary statement:                                -->
<!--                                                         -->
<!-- Licensed Material - Property of IBM                     -->
<!--                                                         -->
<!-- 5655-F31 (C) Copyright IBM Corp. 2000, 2001             -->
<!-- All Rights Reserved.                                    -->
<!-- U.S. Government users - RESTRICTED RIGHTS - Use,        -->
<!-- Duplication, or Disclosure restricted by GSA-ADP        -->
<!-- schedule contract with IBM Corp.                        -->
<!-- Status = H28W401                                        -->
<!--                                                         -->
<!--  Change history:                                        -->
<!--$L0=MD12514, H28W401, 20011018, PDRK: Created.           -->
<!--                                                         -->
<!--=========================================================-->
<!-- internal DTD -->
<!DOCTYPE inputexportj2eeserver
<!ELEMENT inputexportj2eeserver EMPTY>
<!ATTLIST inputexportj2eeserver
  conversationname CDATA #REQUIRED
  outputdirectory CDATA #REQUIRED
  j2eeservername CDATA #REQUIRED
>
 >

<!--begin of default values-->
<inputexportj2eeserver
  conversationname = ''
  outputdirectory = ''
  j2eeservername = ''
>
</inputexportj2eeserver>
________________________________________________________________
The following publication was revised as a result
of APAR PQ56468:
________________________________________________________________
WebSphere Application Server V4.0.1 for z/OS and OS/390
Messages and Diagnosis
GA22-7837-02
________________________________________________________________
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/
________________________________________________________________
________________________________________________________________
Chapter 10, pg. 188 (new message)
BBON3144E Conversation status for conversation conversationname
is not valid for functionname.
Explanation: This error occurs when you try to execute a
function against a conversation that requires a certain
conversation state (like activated, or modifiable), but the
conversation is not in such a state. For example, exportserver
can only be performed on active conversations, while
importserver can only be performed against a conversation in
state modifiable.
User Response: Make sure you are executing the function against
a conversation that is in a proper state.
________________________________________________________________
Chapter 10, pg. 194 (new message)
BBON3215E value is not a valid value for J2EE resource
attribute-name.
Explanation: This error occurs during creation or modification
of a J2EE resource instance. The specified value is not a valid
choice for the resource instance attribute attribute-name.
User Response: Check your script and correct the value for the
resource instance attribute attribute-name. The valid choices
are defined by the template XML for this resource type.
________________________________________________________________
Chapter 12, pg. 319 (new message)
BBOU0759E Credential handling function function-name failed
in USS callable service service-name with Return Value (hex):
%x, Return Code (hex): %x, and Reason Code (hex): %x.
Explanation: USS Return Value reported by Security Manager - The
requested function failed. Use the routine name and USS Return
Value in conjunction with the reported USS Return Code to
determine the cause of the problem. Some USS Return Codes can
have several different associated USS Reason Codes that
further define the problem. Use the USS Return Value in
conjunction with the reported USS Return Code and USS Reason
Code to determine the cause of the problem.
User Response: Find return value, return code, and reason codes
defined in OS/390 USS Callable Services or later documentation.
If this fails to explain the problem, contact your next level of
support or the IBM Support Center.
________________________________________________________________
Chapter 13, pg. 468 (new message)
C9C240E6
Explanation: Caller ID does not have permission to execute
method
User Response: Make sure that the caller ID has permission to
access that particular method.
________________________________________________________________
Temporary fix Comments
APAR information
APAR number PQ56468
Reported component name WASKBASE
Reported component ID 5655A9801
Reported release 401
Status CLOSED PER
PE NoPE
HIPER NoHIPER
Submitted date 2002-01-08
Closed date 2002-01-08
Last modified date 2002-02-02

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 UQ61730    UP02/01/17 P F201

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