PI09591: RDZ INTERNAL DEFECTS/ENHANCEMENTS (V9011)

9.0.1.1: UI14892 PTF for Rational Developer for System z Host Options
Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• RDz internal defects/enhancements (v9011)
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.All RDz users                             *
  *                 02.System z Data Editor of RDz users         *
  *                 03.All users of the Rational Developer for   *
  *                    System z Integrated Debugger              *
  *                 04.RDz host admin                            *
  *                 05.sysprog configuring RDz with Config       *
  *                    Utility                                   *
  *                 06.sysprog installing RDz                    *
  *                 07.RDz users who use integrated PICL         *
  *                    debugger.                                 *
  *                 08.RDz users who use integrated PICL         *
  *                    debugger.                                 *
  *                 09.All RDz users                             *
  *                 10. RDz users of the integrated PICL         *
  *                    debugger                                  *
  *                 11.All users of the Rational Developer for   *
  *                    System z Integrated Debugger              *
  *                 12.All RDz users                             *
  *                 13.RDz users who access the Endevor          *
  *                    repository using the IBM supplied RDz     *
  *                    Endevor RAM and make use of the Enhanced  *
  *                    Edit capabilities.                        *
  *                 14.RDz Users                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.The RESERVE may not be released in   *
  *                         the DELETE/RENAME processing when    *
  *                         some error happens during its        *
  *                         process.                             *
  *                      02.Rational Developer for System z      *
  *                         Data Editor feature 'Find and        *
  *                         Replace All' will fail with large    *
  *                         datasets                             *
  *                      03.Incorrect results when stepping      *
  *                         COBOL applications under the         *
  *                         Integrated Debugger                  *
  *                      04.v901 rsecomm.propeties does not      *
  *                         have a sample USER directive         *
  *                      05.copy of sample mambers fails with    *
  *                         Config Utility                       *
  *                      06.underestimated v901 PTF UI13093      *
  *                         size increase                        *
  *                      07.Debug miner not usable when zPCM is  *
  *                         down                                 *
  *                      08.Debug miner not usable when debug    *
  *                         manager is down                      *
  *                      09.Unable to rename a data set to a     *
  *                         data set with z/OS 2.1 system.       *
  *                      10.The debugger doesn't start when a    *
  *                         user tries to initiate a CICS debug  *
  *                         session                              *
  *                      11.S0C4 abend in Debug Manager          *
  *                      12.RDz client cannot log on to the      *
  *                         remote system when using             *
  *                         keep.all.logs=false &                *
  *                         keep.last.log=true breaks logon.     *
  *                      13.RDz CARMA Endevor Enhanced Edit of   *
  *                         production element copies all        *
  *                         versions to new/entry environment.   *
  *                         This problem is because the RDz      *
  *                         CARMA Endevor RAM is using the       *
  *                         "Move with history" option when      *
  *                         invoking the CA Endevor Transfer     *
  *                         Element API.                         *
  *                      14.On some occasions users can be       *
  *                         disconnected a few minutes after a   *
  *                         connect.                             *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  01.The RESERVE may not be released in the DELETE/RENAME
     processing when some error happens during its process.
  02.When the RDz server and client saved a large data set,
     updated records were sent to the server and then the server
     merged the updates and the data set content. But the server
     failed to merge the content when the updated data size was
     large.
  03.For some COBOL applications, debug stepping controls such
     as 'step into', 'step over' and 'step return' may stop at
     unexpected locations or may allow the application to run to
     completion.
  04.v901 introduces the USER directive to rsecomm.properties and
     documents it, but the sample rsecomm.properties file does
     not have a sample for the directive.
  05.The Config Utility step to copy sample members fails due to
     a member name mismatch. SFEKSAMP(DBGMGR) should be
     SFEKSAMP(AQEJCL) in FEK.SFEKSKEL(FEKCOPY).
  06.v90 sample SMP/E jobs underestimated the z/OS UNIX size
     growth caused by (optional) v901 PTF UI13093, and the sample
     zFS and DLIB allactions don't leave much room for growth
     after the PTF is applied. Note that the v901 media has
     updated SMP/E sample jobs.
  07.The debug miner currently terminates if zPCM is down.
  08.The debug miner goes down when debug manager returns 0 byte
     response.
  09.In TSO of z/OS 2.1, TSO Cleanup command is executed after
     the completion of the rename command, but MVS miner is not
     coded to accept the results of the Cleanup command.
  10.The debugger doesn't start because the message the
     connection manager sends to the DebugMiner for a CICS debug
     session is larger than the DebugMiner is expecting and that
     causes an exception.
  11.S0C4 in Debug Manager at getNewUserControlEntry
  12.The area is not large enough to store the log file name and
     damages some storage used by JVM.
  13.The RDz Endevor RAM is specifying "Y" in the "Move with
     history" option when invoking the CA Endevor Transfer
     Element API. This causes all versions to also be transfered
     to the target stage.
  14.Under certain conditions, the RSE keepAlive mechanism can
     fail during it's handshake such that a short read-timeout
     causes a disconnect.
  

Problem conclusion

• 01.Now, the RESERVE is released even if some error happens in
     the DELETE/RENAME process.
  02.The RDz server and client were fixed to merge large updated
     records and the original data set properly.
  03.Debugger stepping algorithms have been updated to better
     handle nested procedures, perform blocks, paragraphs and
     program calls
  04.sample USER directive is added to
     /usr/lpp/rdz/samples/rsecomm.properties
  05.SFEKSKEL(FEKCOPY) is corrected.
  06.sample SMP/E jobs are updated
  07.The debug miner will periodically attempt connecting with
     zPCM after a failed attempt.
  08.The debug miner will periodically attempt connecting with
     debug manager after debug manager returns 0 byte response.
  09.Now, MVS miner is changed to accept the results of the
     Cleanup command.
  10.To fix the problem, the byte array used to receive messages
     from the connection manager has been made much larger, to
     accomodate the larger messages.
  11.corrected uninitialized mutex
  12.Now, the area is allocated in enough size to store the log
     file name.
  13.The RDz Endevor RAM needs to specify "N" for the "Move with
     history" option of the CA Endevor Transfer Element API.
  14.In order to avoid having a short read-timeout after a failed
     keepAlive handshake, the so timeout value gets reset. In
     addition, keepAlive on the server will accept a keepAlive
     request from the client as a tacit confirmation to it's own
     keepAlive request, ensuring the handshake does not fail.
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

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

Modules/Macros

• AQECIC32 AQECIC41 AQECIC51 AQECTL   AQEMVS31
  AQEZPCM  CEEEVDBG CEEEV006 CRARNDVR FEKCOPY  FEKFCOMM FEKFDBGM
  FEKFDST0 FEKFENVR FEKFMAIN FEKFMAI6 FEKFMINE FEKSEQAL FEK3ALOC
  FEK4MNT
  

Fix information

• Fixed component name

  RD/Z HOST

• Fixed component ID

  5724T0723

Applicable component levels

• R900 PSY UI14892

     UP14/02/18 I 1000

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.