IBM Support

PI34304: RDZ V8517 INTERNAL DEFECTS AND ENHANCEMENTS - RSE

Subscribe

You can track all active APARs for this component.

APAR status

  • Closed as program error.

Error description

  • RDZ V8517 INTERNAL DEFECTS AND ENHANCEMENTS - RSE
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 01.All RDz users                             *
    *                 02.All RDz users                             *
    *                 03.All RDz users                             *
    *                 04.All RDz users                             *
    *                 05.All RDz users                             *
    *                 06.RDz systems programmer                    *
    *                 07.RDz systems programmer                    *
    *                 08.All RDz users                             *
    *                 09.All RDz users                             *
    *                 10.All RDz users                             *
    *                 11.All RDz users                             *
    *                 12.z/OS system programmer                    *
    *                 13.RDz administrators                        *
    *                 14.All RDz users                             *
    *                 15.All RDz users                             *
    *                 16.All RDz users                             *
    *                 17.All RDz users                             *
    *                 18.All RDz users                             *
    *                 19.All RDz users                             *
    ****************************************************************
    * PROBLEM DESCRIPTION: 01.RDz should not allow a user to edit  *
    *                         an alias PDS member when real PDS    *
    *                         member is open in ISPF editor        *
    *                      02.In Rational Developer for System z   *
    *                         v9.1.1, creating host data sets      *
    *                         fail when using codepage IBM-1141    *
    *                         and "" (paragraph) in the data set   *
    *                         name                                 *
    *                      03.RDz receives an abend 213-30 when    *
    *                         saving a member of a PDS.            *
    *                      04.RDz TSO shell incorrectly            *
    *                         translates "<" and ">"         *
    *                         strings to "<" and ">".              *
    *                      05.RDz server should have better        *
    *                         serviceability by showing friendly   *
    *                         cipher names and should synchronize  *
    *                         enabled ciphers.                     *
    *                      06.rsed.envvars variable                *
    *                         _RSE_HOST_CODEPAGE of Rational       *
    *                         Developer for System z is used only  *
    *                         by Java for internal processes, not  *
    *                         for accessing customer data, and     *
    *                         should not be changed. Therefore,    *
    *                         the variable is moved to the         *
    *                         do-not-touch section of              *
    *                         rsed.envvars.                        *
    *                      07.Simplify management of encrypted     *
    *                         communication in RDz.                *
    *                      08.TLSv1.0 is always enabled even if    *
    *                         it is disabled in rsed.envvars       *
    *                      09.SSL protocols and enabled ciper      *
    *                         suites information are not passed    *
    *                         to dstore.                           *
    *                      10.RDz server disables the ssl          *
    *                         protocols whose environment          *
    *                         variable is not defined in           *
    *                         rsed.envvars.                        *
    *                      11.NPE occurs in rse server when the    *
    *                         communication with a client is not   *
    *                         stable.                              *
    *                      12.RDz does not support Java 8.0        *
    *                      13.MvsConsole.wto(String,int,int) that  *
    *                         RDz server calls does not look at    *
    *                         file.encoding value and it causes    *
    *                         outputting nothing on the operator   *
    *                         command D P,D when running on        *
    *                         java8.                               *
    *                      14.Rational Developer for System z      *
    *                         (RDz) server may not start due to    *
    *                         0C4 abend in getSSLProperties()      *
    *                      15.RDz server abend 0C1 in function     *
    *                         putFile                              *
    *                      16.In Rational Developer for System z   *
    *                         - RDz - v9.1.1.2, the daemon         *
    *                         process may end with user abend      *
    *                         code U4039 because of heap damage.   *
    *                         Heap damage can be seen in RSE       *
    *                         joblog or syslog with messages       *
    *                         like:                                *
    *                         CEE0374C CONDITION=CEE0802C          *
    *                         TOKEN=00040322 61C3C5C5 461AEE00     *
    *                         WHILE RUNNING PROGRAM tfree WHICH    *
    *                         STARTS AT 4668F1E8                   *
    *                         Additional Keywords: ABENDU4039      *
    *                      17.Abend code information is not sent   *
    *                         to client when uploading >16kB       *
    *                         file.                                *
    *                      18.RDz server should support FIPS       *
    *                         140-2 mode in encrypted connections  *
    *                      19.When saving a data set member for    *
    *                         which the user has no write access,  *
    *                         RDz does not issue any messages      *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    01.When an alias PDS member is started to edit, RDz calls ENQ
       and RESERVE operation with the resource name based on the
       alias name. It causes to allow a user to edit the PDS member
       that is already opened by ISPF editor. ISPF editor uses the
       resource name based on the real name and RDz should work in
       the same manner. RDz server is updated to calculate the
       resource name for ENQ operation from a real PDS name not an
       alias PDS name. RDz client is updated to correct the
       resource name for RESERVE operation from a real PDS name not
       an alias PDS name.
    02.The paragrah character was handled as invalid, since the RDz
       server used the data set name for server commands correctly
       without code conversion when the code page was changed.
    03.When a previous upload request is pending and client sends
       another upload request, abend 213-30 may occur. After the
       abend occurs, it is sometimes required to restart the RDz
       server to free the allocated resources.
    04.RDz TSO shell incorrectly translates "&lt;" and "&gt;"
       strings to "<" and ">".
    05.RDz server should have better serviceability by showing
       friendly cipher names and should synchronize enabled
       ciphers.
    06.rsed.envvars variable _RSE_HOST_CODEPAGE of Rational
       Developer for System z is used only by Java for internal
       processes, not for accessing customer data, and should not
       be changed. Therefore, the variable is moved to the
       do-not-touch section of rsed.envvars.
    07.Simplify management of encrypted communication in Rational
       Developer for System z. rsed.envvars now has samples for
       System SSL variables GSK_PROTOCOL_* and GSK_V3_CIPHER_SPECS.
       _RSE_JAVAOPTS variable DSTORE_SSL_ALGORITHM in rsed.envvars
       is removed, as protocol selection is now managed via the
       GSK_PROTOCOL_* variables.
    08.TLSv1.0 is always enabled even if it is disabled in
       rsed.envvars
    09.SSL protocols and enabled ciper suites information are not
       passed to dstore.
    10.RDz server disables the ssl protocols whose environment
       variable (GSK_PROTOCOL_XXXVNN) is not defined in
       rsed.envvars.
    11.NPE occurs in rse server when a request message is not fully
       received due to communication problems. 181 ERROR RseDaemon:
       java.lang.NullPointerException 182
       java.lang.NullPointerException 183 at
       java.util.StringTokenizer.<init>(StringTokenizer.java:88)
       184 at
       java.util.StringTokenizer.<init>(StringTokenizer.java:66)
       185 at
       com.ibm.etools.zos.server.RseDaemon.main(RseDaemon.java:453)
    12.Rational Developer for System z does not support Java 8.0,
       and startup fails if you do try to use it. The problem lies
       in a faulty code-page interpretation by Java 8.0. The
       solution is to use _RSE_HOST_CODEPAGE=cp1047 instead of
       IBM-1047.
    13.RDz sever calls MvsConsole.wto(String,int,int) to output the
       result of the operator commands to the console. This method
       does not look at file.encoding value and it causes
       outputting nothing on the operator command D P,D when
       running on java8.
    14.Rational Developer for System z (RDz) server may not start
       due to 0C4 abend. If feklogs is collected, it will show the
       following information: CEE3204S The system detected a
       protection exception (System Completion Code=0C4) at
       com.ibm.etools.zos.server.CoreJNI.getSSLProperties(Native
       Method)
    15.When MVSFileSystemMiner.internalFinish() is called while
       disconnect, MVSByteStreamHandler.finish() is called and the
       unclosed uploading data should be flushed to the file by
       another thread and MVSByteStreamHandler.finish() does not
       wait for the completion of the flush operation. If
       FFSServerImpl.term() is called and the resources for the
       session are freed, the flush operation does not work
       correctly and we should see C1 abend.
    16.RDz server calls select() of USS API to check multiple
       inputs by a single thread. RDz server should prepare enough
       length of heap memory to direct select() api which file
       descriptor numbers should be checked by setting
       corresponding memory bits on. The heap memory length depends
       on the maximum value of the file descriptor numbers to be
       checked. When the maximum file descriptor number is 2048,
       RDz server does not allocate enough heap area and writing
       the bit for the file descriptor number 2048 causes the
       memory corruption. When the maximum number is less than or
       greater than 2048, the problem does not occur. RDz server
       code is updated to allocate enough memory even when the
       maximum number is 2048.
    17.When a file with more than 16kB is being uploaded and it
       ends with an abend by some reason, server does not send the
       abend code information in the error response message to
       client. Client shows the incorrect message , "Operation
       failed: file input output error" even if it has a different
       special message for the abend code D37-4 and E37-4.
    18.RDz server should support FIPS 140-2 mode in encrypted
       connections
    19.Server code is updated to send ABEND information to the
       client while opening a member.
    

Problem conclusion

  • 01.RDz server is updated to calculate the resource name for ENQ
       operation from a real PDS name not an alias PDS name. RDz
       client is updated to correct the resource name for RESERVE
       operation from a real PDS name not an alias PDS name.
    02.The server was fixed to use the converted data set names
       when the code page was changed.
    03.The server code is fixed to force the previous pending
       uploading request closed when the next upload request comes,
       and to free all the allocated resources when client
       disconnects.
    04.RDz client is updated to escape '&' and ';' characters,
       before the input string is encoded in xml data and is sent
       to server. RDz server is updated to unescape '&' and ';'
       characters, after the received xml data is decoded. Only if
       both client and server can handle them, they are actually
       escaped.
    05.RDz server is updated to show friendly cipher names and to
       synchronize enabled ciphers.
    06.rsed.envvars variable _RSE_HOST_CODEPAGE of Rational
       Developer for System z is used only by Java for internal
       processes, not for accessing customer data, and should not
       be changed. Therefore, the variable is moved to the
       do-not-touch section of rsed.envvars.
    07.Simplify management of encrypted communication in Rational
       Developer for System z. rsed.envvars now has samples for
       System SSL variables GSK_PROTOCOL_* and GSK_V3_CIPHER_SPECS.
       _RSE_JAVAOPTS variable DSTORE_SSL_ALGORITHM in rsed.envvars
       is removed, as protocol selection is now managed via the
       GSK_PROTOCOL_* variables.
    08.The hard coded code to enable TLS v1.0 is removed. All
       information will come from rsed.envvars.
    09.Thread pool process calls setEnabledProtocols(),
       setDisabledProtocolPatterns() and setEnabledCipherSuites()
       to synchronize the protocols and cipher suites more
       precisely.
    10.The ssl protocol, that are used in the established
       connection of in the first rse daemon process, is passed to
       the thread pool process to direct java security system to
       enable.
    11.RDz server code is updated not to raise NPE even if a
       request message is not fully received.
    12.sample rsed.envvars is updated to use
       _RSE_HOST_CODEPAGE=cp1047 instead of IBM-1047.
    13.RDz server code is updated to call
       MvsConsole.wto(WtoMessage,String) where RDz server can
       specify System.getProperty("file.encoding") as the second
       argument.
    14.There is a code error in getSSLProperties() to read a
       configuration file and the error causes the abend in some
       specifc system condition. getSSLProperties() function is
       removed not to read the file in the native code, and java
       code will pass the required information by a new JNI
       function, setSSLProperties().
    15.RDz server code has been updated to wait for the completion
       of the file flush operation before releasing the resources
       in the disconnect operation.
    16.RDz server code is updated to allocate enough memory even
       when the maximum value of the file descriptors is 2048.
    17.RDz server code has been updated to send the abend code
       information to client.
    18.RDz server is updated to support FIPS 140-2 mode
    19.Server code is updated to send ABEND information to the
       client while opening a member.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PI34304

  • Reported component name

    RD/Z HOST

  • Reported component ID

    5724T0723

  • Reported release

    850

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2015-02-06

  • Closed date

    2016-09-16

  • Last modified date

    2016-09-30

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

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

Modules/Macros

  • FEK#LVL# FEKFCIPH FEKFCORE FEKFCOR6 FEKFDST0
    FEKFENVR FEKFMAIN FEKFMAI6 FEKFMINE FEKFRIVP FEKFSTUP FEKFT006
    FEKFZOS  FEKRSEDE
    

Fix information

  • Fixed component name

    RD/Z HOST

  • Fixed component ID

    5724T0723

Applicable component levels

  • R850 PSY UI40857

       UP16/09/30 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.



Document information

More support for: Rational Developer for System z

Software version: 8.5

Reference #: PI34304

Modified date: 30 September 2016