IBM Support

PH32053: IBM DEVELOPER FOR Z SYSTEMS (IDZ) MENU MANGER FAILED WITH RC=20.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • IBM Developer for z Systems - IDz - v14.2.1
    Menu Manger failed with RC=20 when input some parameters value.
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: 1. Server running early version of java 11   *
    *                 2. The server got affected.                  *
    *                 3. fekfdivp tool                             *
    *                 4. All RSE users using TSO interactive       *
    *                 gateway and keepAlive option off, invoking   *
    *                 TSO interactive command.                     *
    ****************************************************************
    * PROBLEM DESCRIPTION: 1. The pipe count of the ThreadPool     *
    *                      keeps increasing when running under     *
    *                      the early version of Java 11.           *
    *                      When the pipe count (account for the    *
    *                      total fd cound of the process)          *
    *                      reaches the process limit, the          *
    *                      operation would fail.                   *
    *                      The issue does not exist in Java 8.     *
    *                      Its Process pipe is automatically       *
    *                      closed when the Process is done.        *
    *                      Another issue that with a heavy load    *
    *                      ThreadPool especially during user       *
    *                      logging off, concurrent access issue    *
    *                      in cleaning up the existing command     *
    *                      miner threads could stop the cleanup    *
    *                      abruptly and may cause left over        *
    *                      resource.                               *
    *                      2. Minimum supported ZOS level for      *
    *                      Java 1.8 is 2.2                         *
    *                      3. New printf call was flagged as       *
    *                      having possibility of buffer overflow.  *
    *                      4. With TSO interactive gateway, when   *
    *                      issuing an TSO interactive command      *
    *                      and entering input, users may           *
    *                      experience a failure with TSO gateway   *
    *                      RC 20.                                  *
    ****************************************************************
    1. There is a change in Process instance creation and
    termination in Java 11. The stdout-in-err pipes of a created
    Process must be closed explicitly or through a stream wrapper;
    otherwise, it will cause a leak. Destroying the process also
    helps.
    RSED ThreadPool leaks Process pipes through the usage of Java
    API  ProcessBuilder and Runtime exec API to create Process
    used in its operation.
    2. Native code for JMON, ZOS, and MVS servers should be
    compiled with OS target ZOSV2R2
    3. printf was known to have a buffer overflow with %s argument.
    4. When keepAlive option off, there might be a out of sync to
    keep the invoking TSO interactive command and the input
    entering step in the same TSO session, leading to the RC 20
    error.
    

Problem conclusion

  • 1. - Due to the change in Java behavior around the Process
    pipe management in Java 11, RSED leaks Process pipe during its
    lifetime causing failure in its operation.
    Issue has been reported to Java team and awaiting for
    resolution in Java JDK.
    A work-around as to explicitly close a Process' pipe when done
    was introduced.
    - The common holder of a connection's command miner threads
    should be synchronized during cleanup or adding operation.
    2. Update build script with compile OS target set to ZOSV2R2
    3. The scan result is actually a noise as printf was used with
    argument constructed internally having bounded message.
    But introduce the alternative of sprintf and puts anyway,
    avoiding marking it as noise.
    4. To adjust the timing of the keepAliveThread's pinging
    execution for an interactive command in waiting input mode.
    Recalculate the wait (sleep) time for the pinging so that it
    could happen on time to keep the session valid w.r.t RSE CEA
    TSO processor and gateway client session timeout.
    It is to synchronize and keep alive the session to be used for
    both command issuing and input entering step when the RSE host
    is not running with the CEATSO keep alive option.
    

Temporary fix

Comments

APAR Information

  • APAR number

    PH32053

  • Reported component name

    DEV FOR Z/OS

  • Reported component ID

    5724T0700

  • Reported release

    320

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2020-11-24

  • Closed date

    2023-01-19

  • Last modified date

    2023-02-01

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

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

    UI90162

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 FEKFDBG  FEKFDBG6 FEKFDBGM FEKFDIR  FEKFDIR6 FEKFDIVP
    FEKFDST0 FEKFDST1 FEKFDST2 FEKFENVF FEKFENVI FEKFENVP FEKFENVR
    FEKFENVS FEKFEPL  FEKFERRF FEKFGDGE FEKFICUL FEKFISPF FEKFIVP0
    FEKFIVPA FEKFIVPD FEKFIVPI FEKFIVPJ FEKFIVPT FEKFJESM FEKFJESU
    FEKFJLIC FEKFJSON FEKFJVM  FEKFLATR FEKFLDSI FEKFLDSL FEKFLEOP
    FEKFLOGS FEKFLPTH FEKFMAI6 FEKFMAIN FEKFMINE FEKFMNTL FEKFNTCE
    FEKFOMVS FEKFPATT FEKFPLUG 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 FEKFTIVP FEKFTSO  FEKFUTIL
    FEKFVERS FEKFXITA FEKFXITL FEKFZOS  FEKHCONF FEKHCUST FEKHDEB
    FEKHDESC FEKHFLOW FEKHGEN  FEKHISPF FEKHIVP  FEKHIVPD FEKHJESJ
    FEKHMAIN FEKHMIGO FEKHOPTE FEKHOPTN FEKHPRIM FEKHRSE1 FEKHRSEO
    FEKHSTRT FEKHTAB1 FEKHTAB2 FEKINIT  FEKKEYS  FEKLOCKA 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   HUHFCOR6 HUHFCORE
    

Fix information

  • Fixed component name

    EXP FOR Z/OS HO

  • Fixed component ID

    5655EXP23

Applicable component levels

  • R320 PSY UI90162

       UP23/01/28 P F301

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.

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSBDYH","label":"IBM Explorer for z\/OS"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"320","Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Document Information

Modified date:
01 February 2023