PH29899: V3.0.1.22 INTERNAL DEFECT FIX

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• v3.0.1.22 internal defect fix
  

Local fix

• n/a
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.All zExpl and IDz users opening PDS       *
  *                    dataset having multiple members           *
  *                 02.All zExpl and IDz users having an TSO     *
  *                    account number value longer than 8 in     *
  *                    new connection and using interactive TSO  *
  *                    gateway.                                  *
  *                 03.All zExpl and IDz users with zExplorer    *
  *                    host possibly running with large message  *
  *                    communication, for example: browsing      *
  *                    with a high number of entries result.     *
  *                 04.All zExpl and IDz users                   *
  *                 05.All zExpl and IDz users with zExplorer    *
  *                    host running DBCS host code page having   *
  *                    shift state encoding.                     *
  *                 06.All zExpl and IDz users with zExplorer    *
  *                    host running with audit option on.        *
  *                 07.All zExpl and IDz users listing a         *
  *                    partition dataset on 31 bit system.       *
  *                 08.z/OS Explorer support                     *
  *                 09.All zExpl and IDz users using SSL         *
  *                    communication.                            *
  *                 10.All z/OS Explorer and IDz users           *
  *                 11.All zExpl and IDz users                   *
  *                 12.All z/os Explorer and IDz users           *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.RSE might cause page access faulty,  *
  *                         OC4-11 when retrieving user data     *
  *                         for dataset member statistic.        *
  *                      02.IBM Developer for z Systems (IDz)    *
  *                         Account number truncated to 8 chars  *
  *                         in inital TSO Logon panel.           *
  *                      03.In IDz 14.1 the STC RSE daemon host  *
  *                         when running might experience the    *
  *                         OutOfMemory error when previously    *
  *                         browsing with high number of         *
  *                         entries result.                      *
  *                      04.Users receive RC=0004 in FEKLOGS     *
  *                      05.In IDz 14.1 the STC RSE daemon host  *
  *                         when running with audit log option   *
  *                         may have an increasing number of     *
  *                         open file descriptors while          *
  *                         running.                             *
  *                      06.In IDz 14.1 the STC RSE daemon host  *
  *                         when running with audit log option   *
  *                         may have an increasing number of     *
  *                         open file descriptors while          *
  *                         running.                             *
  *                      07.In IDz 14.1 Users might not be able  *
  *                         to run an operation related to       *
  *                         directory listing of a partition     *
  *                         dataset with the error and forced    *
  *                         to disconnect.                       *
  *                      08.values for a JMON trace statement    *
  *                         show up with wrong variable names    *
  *                      09.In IDz 14.1.0 Users are not able to  *
  *                         establish a TLS connection using     *
  *                         JCECCARACFKS keystore.               *
  *                      10.Due to Java 6 out of support, we     *
  *                         will now make Java 8 31bit as        *
  *                         default java version                 *
  *                      11.RSE is normally started up with      *
  *                         default _BPX_SHAREAS=YES             *
  *                         environment setting to optimize the  *
  *                         cost in spawning supported           *
  *                         processes by requesting the same     *
  *                         address space as parent. System      *
  *                         with the program /bin/sh, which is   *
  *                         used for ThreadPool creation,        *
  *                         having sticky bit unset would have   *
  *                         the created ThreadPool terminated    *
  *                         by SIGKILL (9) issued by Daemon      *
  *                         shortly after it is created or       *
  *                         after a client connection attempt.   *
  *                      12.FEKLOGS do not concatenate           *
  *                         DSTORE_LOG_DIRECTORY with            *
  *                         userlog/dstorelog/$LOGNAME/ when it  *
  *                         is set to a value other than none    *
  ****************************************************************
  01.The storage access RSE attempts to access for user data
     might be inaccessible.
  02.In the creation of a new connection, RSE retrieval user
     profile information extracts only 8 characters from the
     default value retrieved for the TSO account number.
  03.During the serialization of the xml message in internal
     communication, the server handler is using a StringBuffer
     with a default capacity and expanded per message size as
     needed. The expanded capacity has not been released.
  04.RC0004 is caught when feklogs is checking ISPF gateway
     configuration due to feklogs script typo
  05.For output character set referring to state-dependent
     encoding (i.e f it contains the multibyte characters with
     shift-states like IBM-930), iconv conversion may leave the
     descriptor and output buffer in an expected shift state. In
     such case, the next conversion would be started from the
     state set from previous conversion. The current conversion
     may be messed up.
  06.During the processing of audit file rotation in logging, all
     old audit logs are processed using a file stream by RSE
     daemon. The files descriptor for these streams if not closed
     would be accumulated over the life span of the RSE daemon
     until it is recycled.
  07.During the directory listing of a partition dataset, when an
     abend occurs due to a closing of an invalid dataset DCB
     handle, a recursive chain of the abend may occur.
  08.values for a JMON trace statement show up with wrong
     variable names
  09.zRSE when loading the CECAARACFS keystore is using the input
     stream from the wrong provider, the IBMJCE provider. It
     fails to load the keystore.
  10.Due to Java 6 out of support, we will now make Java 8 31bit
     as default java version
  11.When ThreadPool is created within the same address space as
     that of Daemon, the ThreadPool would be terminated by
     SIGKILL issued by Daemon. _BPX_SHAREAS=YES setting is not in
     effect when the program file used in spawning has the sticky
     bit set. A system with a sticky-bit-on /bin/sh still creates
     the ThreadPool within its own address space. A system with a
     sticky-bit-off /bin/sh would have all ThreadPool created
     within the same address space as Daemon and would experience
     the SIGKILL problem shortly after it is started up.
  12.When -DDSTORE_LOG_DIRECTORY is set, FEKLOGS fails to
     concatenate host server log and user log, as a result
     FEKLOGR will return ** INFO ** <user log path> does not
     exist, <user> has not used the product with return code 8.
     This is due to incorrect intermediate processing in the
     FEKLOGS rex script
  

Problem conclusion

• 01.RSE's existing mechanism to detect the existing of user data
     region is improper. Adding checking length of the user data
     before attempting to retrieving user data.
  02.The maximum allowed is 39 characters. Have the extraction
     move 39 characters by the expected maximum allowed.
  03.When sending a new message, besides clearing out the contend
     of the buffer space, the server handler should also shrink
     the capacity (to default size) when it is over the default
     capacity.
  04.Fixed the script issue.
  05.After an iconv() conversion, as recommended, reset to the
     initial state for the iconv descriptor and the output buffer
     by calling an iconv() call with a NULL input (or point to a
     NULL).
  06.RSE daemon when processing audit log rotation, it misses to
     close the file stream opened to access the old audit logs.
     The fix is to close the file stream properly when the
     processing is done.
  07.The condition handler of the partition dataset directory
     listing routine attempts to close the dataset DCB handle
     when it was flagged as opened. In some error listing
     condition, when the DCB handle was not set properly, calling
     close function on it may cause the abend, leading to a
     repeated condition handler routine invocation. Resetting the
     dataset open flag when closing the DCB preventing the
     recursive behavior when the DCB is invalid. This fix does
     not resolve the original issue of the cause for an invalid
     DCB handle.
  08.trace statement updated to properly align values with
     variable names
  09.The input streams from two providers have the same class
     name. The type class now is determined during run time based
     on the provider configured for Java security.
  10.Modified the java_home values to make Java 8 31bit as
     default java version as default
  11.It is a requirement that a ThreadPool must be created in an
     address space different from Daemon; otherwise, it would be
     terminated shortly after created. Furthermore, dataset lock
     owner information tracking based on ThreadPool address space
     id (ASID) unique indexing scheme. Daemon now creates
     ThreadPool with A _BPX_SHAREAS=NO in environment argument
     for in spawning call to have the ThreadPool created within
     its own address space regardless /bin/sh sticky bit setting.
  12.Fixed the feklogs script bug as well as modifying ExistsUSS
     Access syscall rc code check from R_OK to F_OK
  

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:

  UI71781

Modules/Macros

• FEJENF70 FEJJCNFG FEJJJCL  FEJJMON  FEJTSO   FEK1SMPE FEK2RCVE
  FEK3ALOC FEK4ZFS  FEK5MKD  FEK6DDEF FEK7APLY FEK8ACPT FEK@CERR
  FEK@CONE FEK@CONF FEK@CUST FEK@DEB  FEK@DESC FEK@FLOW FEK@GEN
  FEK@GENW FEK@ISPF FEK@IVP  FEK@IVPD FEK@IVPW FEK@JCN1 FEK@JCNE
  FEK@JESJ FEK@MAIN FEK@MIGO FEK@OPTE FEK@OPTG FEK@OPTN FEK@PRIM
  FEK@RSE1 FEK@RSEO FEK@STRT FEK@TAB1 FEK@TAB2 FEK@TAB3 FEK@WRK1
  FEK@WRK2 FEK@WRK3 FEK@WRK4 FEK@WRK5 FEKAPPCC FEKAPPCL FEKAPPCX
  FEKDSI   FEKEESX0 FEKFASIZ FEKFBLD  FEKFCIPH FEKFCLIE FEKFCMOD
  FEKFCMPR FEKFCMSG FEKFCOMM FEKFCOPY FEKFCOR6 FEKFCORE FEKFDBGM
  FEKFDIR  FEKFDIR6 FEKFDIVP FEKFDST0 FEKFDST1 FEKFDST2 FEKFENVF
  FEKFENVI FEKFENVP FEKFENVR FEKFENVS FEKFEPL  FEKFICUL FEKFISPF
  FEKFIVP0 FEKFIVPA FEKFIVPD FEKFIVPI FEKFIVPJ FEKFIVPT FEKFJESM
  FEKFJESU FEKFJVM  FEKFLDSI FEKFLDSL FEKFLEOP FEKFLOGS FEKFLPTH
  FEKFMAI6 FEKFMAIN FEKFMINE FEKFMINS FEKFNTCE FEKFOMVS FEKFPATT
  FEKFPRDS FEKFPTC  FEKFRIVP FEKFRMSG FEKFRSES FEKFRSRV FEKFSCMD
  FEKFSEND FEKFSSL  FEKFSTUP FEKFT000 FEKFT001 FEKFT002 FEKFT003
  FEKFT004 FEKFT005 FEKFT006 FEKFT007 FEKFT008 FEKFT009 FEKFT010
  FEKFT011 FEKFT012 FEKFT013 FEKFT014 FEKFT015 FEKFT016 FEKFT017
  FEKFT018 FEKFT019 FEKFT020 FEKFT021 FEKFT022 FEKFT023 FEKFT024
  FEKFT025 FEKFTIVP FEKFTRKS FEKFTSO  FEKFUTIL FEKFVERS FEKFXITA
  FEKFXITL FEKFZME  FEKFZMF  FEKFZOS  FEKHCONF FEKHCUST FEKHDEB
  FEKHDESC FEKHFLOW FEKHGEN  FEKHISPF FEKHIVP  FEKHIVPD FEKHJESJ
  FEKHMAIN FEKHMIGO FEKHOPTE FEKHOPTN FEKHPRIM FEKHRSE1 FEKHRSEO
  FEKHSTRT FEKHTAB1 FEKHTAB2 FEKINIT  FEKKEYS  FEKLOGR  FEKLOGS
  FEKM00   FEKM01   FEKM02   FEKMKDIR FEKMOUNT FEKMSGC  FEKMSGS
  FEKRACF  FEKRSED  FEKSAPF  FEKSAPPL FEKSBPX  FEKSCLAS FEKSCLOG
  FEKSCMD  FEKSCPYM FEKSCPYU FEKSDSN  FEKSENV  FEKSETUP FEKSISPF
  FEKSJCFG FEKSJCMD FEKSJMON FEKSLPA  FEKSPROG FEKSPTKT FEKSRSED
  FEKSSERV FEKSSTC  FEKSSU   FEKSUSER FEKXCFGE FEKXCFGI FEKXCFGM
  FEKXCFGT FEKXMAIN FEKXML
  

Fix information

• Fixed component name

  EXP FOR Z/OS HO

• Fixed component ID

  5655EXP23

Applicable component levels

• R300 PSY UI71781

     UP20/11/02 P F010

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.