PH22909: ZEXPLORER DEAMON DOES NOT RELEASE SOME FILE SOCKETS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In IBM Developer for Systems Z  (IDz) v14.1 or Explorer for z/OS
  3.1.1.x, some file sockets are not released.
  
  For example if the audit log is enabled in rse.env with
  audit.cycle=1.
  
  IBM macro BPXEKDA will report an increasing number of files
  overtime:
  S0044054 00000080 +JOB = RSED PID = 3079 FILE = 517 FILE LIM =
  800 PROCESS = 13 PROCESS LIM = 150
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.All zExpl and IDz users with zExplorer    *
  *                    host running with audit option on.        *
  *                 02.z/OS Explorer support                     *
  *                 03.All zExpl and IDz users                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.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.                             *
  *                      02.Faulty error return code when SSL    *
  *                         is not enabled                       *
  *                      03.The customer won't see this but an   *
  *                         internal exception is logged         *
  ****************************************************************
  01.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.
  02.When enable_ssl=false is specified in ssl.properties,
     FEKLOGS ends with RC8 and message
  
     ** ERROR ** server_keystore_type has an invalid value
  03.An internal exception can occur when querying the encoding
     of a USS file
  

Problem conclusion

• 01.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.
  02.FEKLOGS updated to do correct test
  03.Added a guard against a potential null pointer.
  

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:

  UI69399

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
  FEKATTR  FEKDSI   FEKEESX0 FEKFASIZ FEKFATT1 FEKFBLD  FEKFCIPH
  FEKFCLIE FEKFCMOD FEKFCMPR FEKFCMSG FEKFCOMM FEKFCOPY FEKFCOR6
  FEKFCORE FEKFDBBF FEKFDBBP FEKFDBG  FEKFDBG6 FEKFDBGM FEKFDIR
  FEKFDIR6 FEKFDIVP FEKFDST0 FEKFDST1 FEKFDST2 FEKFENVF FEKFENVI
  FEKFENVP FEKFENVR FEKFENVS FEKFEPL  FEKFICUL FEKFISPF FEKFIVP0
  FEKFIVPA FEKFIVPD FEKFIVPI FEKFIVPJ FEKFIVPT FEKFJESM FEKFJESU
  FEKFJVM  FEKFLATR FEKFLDSI FEKFLDSL FEKFLEOP FEKFLOGS FEKFLPTH
  FEKFMAI6 FEKFMAIN FEKFMINE FEKFMINS FEKFMNTL 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
  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

• R310 PSY UI69399

     UP20/05/16 P F005

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.