PH42388: V3.1.1.32 INTERNAL DEFECT FIX

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• v3.1.1.32 internal defect fix
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: 1. All RSE and RSEAPI users when downloading *
  *                  dataset.                                    *
  *                 2. All RSE users.                            *
  *                 3. Users operate dataset archive on          *
  *                 tape from the GUI.                           *
  *                 4. sysprog                                   *
  *                 5. All RSE users.                            *
  *                 6. Users in a system with improper           *
  *                 passticket configuration required to work    *
  *                 with RSE.                                    *
  *                 7. Users disconnect when still running fast  *
  *                  query for attributes of a large number of   *
  *                  members for a dataset.                      *
  *                 8. z/OS Explorer Client                      *
  *                 9. z/OS sysprogs                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. When z/OS Explorer download dataset  *
  *                      members, especially in high level of    *
  *                      concurrency, RSEAPI raw content         *
  *                      download may encounter this exception   *
  *                      java.lang.NumberFormatException: For    *
  *                      input string: " "                       *
  *                      at java.lang.NumberFormatException.     *
  *                      forInputString(NumberFormatException.   *
  *                      java:76)                                *
  *                      2.Add the missing validation for input  *
  *                      for fgets() call before using it in     *
  *                      some of the RSE core functions.         *
  *                      3. RSE does not support active datasets *
  *                       on tape and is supposed to treat these *
  *                        datasets as offline to disable        *
  *                        further operations on these datasets. *
  *                        It mistakenly includes also archive   *
  *                        datasets on tape.                     *
  *                      4. faulty default port in ivpinit.sh    *
  *                      5. If the *timeout* status of a         *
  *                      ThreadPool is never reset, it will be   *
  *                      automatically removed from Daemon's     *
  *                      selection for ever. A new ThreadPool    *
  *                      eventually will be needed to be spawn   *
  *                      to handle new connection.               *
  *                      6.The RACF rc and rsn codes from        *
  *                      passticket generation are not logged    *
  *                      for further trouble shooting.           *
  *                      7. The long running query may still be  *
  *                      running in the background when the user *
  *                       disconnects, causing the query using   *
  *                       resource that might already been       *
  *                       released by the disconnection.         *
  *                      8. The properties view for the job did  *
  *                      not show system name provided by JMON.  *
  *                      9.zExpl 3.1.1.30 PTF UI74965 requires   *
  *                      zExpl 3.2 / IDz 15.0 client for some    *
  *                      enhancements                            *
  ****************************************************************
  1. Catching the exception parsing an empty string for an
  integer. Reset to -1 as the initialized value for record count.
  2. As from l standard for a software routine, input to some of
  the RSE backend routines, needs to be validated to avoid
  malicious usage from external caller entrance.
  3. RSE mistakenly includes archived dataset on tape instead of
  only active datasets on tape.
  4. faulty default port in z/OS Explorer ivpinit.sh
  5. The *timeout* status of the ThreadPool should be reset when
  one of its connection is logging off as documented to optimize
  RSE performance avoiding unnecessary spawning of a new
  ThreadPool.
  6. The original passticket error leads to a null pointer
  exception in parsing the result as the command is not executed.
   The logging of this exception is not helpful and may cause
   misleading.
  7. The long running thread for the query does not get stop by
  the miner when it finish. The thread when using released
  resource cause the dump.
  8. The properties view for the job should show system name
  provided by JMON instead of DNS name of the system you're
  connected to
  9. IBM Explorer for z/OS 3.1.1.30 PTF UI74965 introduces support
   for JES-related enhancements, but did not mention these
   enhancements can only be used by zExpl 3.2 / IDz 15.0 clients.
  - "display active address spaces" requires client zExpl 3.2.0.16
   / IDz 15.0.2
  - "job requeue" requires client zExpl 3.2.0.17 / IDz 15.0.3
  

Problem conclusion

• 1. Parsing result should be resilient on the obtained result,
  including in error condition. The change improve that
  characteristic of the internal parser.
  2. The validation helps to strengthen zRSE product security
  and behavior, especially in error condition.
  3. In the active dataset on tape detection based on device type,
   check on volsers marked with archived keyword and leave them as
    is, then proceed with the rest as active datasets and treated
    them as offline.
  4. corrected typo
  5. Simply reset the ThreadPool's *timeout* status (by Daemon)
  by the end of the processing of connection log-off from the
  ThreadPool
  6.Adding back the logging of rc, rsn of the original passticket
  error.
  Check on process execution environment before parsing the result
   to avoid the misleading null error logging.
  7. Adding the cancelation callback to the query call, fired off
   by the MVS miner when it finishing. So that it can flag the
   running query thread to stop. Also, register the cancelable
   handle in the callback table, so it could receive the required
    cancelation request following up for the stop action on the
    query of a user from the GUI.
  8. The fix will update the system name in the properties view
  of the running job to show the JMON system name.
  9.updated closing information
  

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:

  UI78267

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
  FEKFT024 FEKFT025 FEKFT026 FEKFT028 FEKFT029 FEKFT030 FEKFT031
  FEKFT032 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 UI78267

     UP21/12/07 P F112

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.