PH08218: IBM EXPLORER FOR Z/OS (ZEXPL) ABEND0C4 MAY OCCUR IF HOSTCP IS NOT PICKED UP ON CONNECTION

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IBM Explorer for z/OS - zExpl v3.1.15
  
  When you attempt to open an MVS file if the hostcp for the
  MVS Properties is not set then an abend 0C4 may occur in
  FFSJNI.
  
  
  The RSECOMM.log will have an entry like this:
  INFO:MVSFileSystemMiner:handleCommand - C_GET_MEMBER_ATTRIBUTE
  for TEST.JCL
  ERROR: MVSFileSystemMiner:
             com.ibm.ftt.rse.mvs.server.miners.FFSException:
  2048 0 196 4 81 CEE3204S The system detected a protection
                        exception (System Completion Code=0C4).
  com.ibm.ftt.rse.mvs.server.miners.FFSJNI.closeConverter
                                                 (Native Method)
  com.ibm.ftt.rse.mvs.server.filesystem.impl.FFSServerImpl.
                          closeConverter(FFSServerImpl.java:324)
  com.ibm.ftt.rse.mvs.server.miners.EncodingCache.init
                                         (EncodingCache.java:91)
  com.ibm.ftt.rse.mvs.server.miners.MappingArg.setHostCp
                                            (MappingArg.java:158)
  com.ibm.ftt.rse.mvs.server.miners.MappingArg.<init>
                                             (MappingArg.java:80)
  com.ibm.ftt.rse.mvs.server.miners.MappingArg.<init>
                                             (MappingArg.java:63)
  com.ibm.ftt.rse.mvs.server.miners.MVSFileSystemMiner.
           handleGetMemberAttribute(MVSFileSystemMiner.java:5304)
  com.ibm.ftt.rse.mvs.server.miners.MVSFileSystemMiner.
           handleGetMemberAttribute(MVSFileSystemMiner.java:5289)
  com.ibm.ftt.rse.mvs.server.miners.MVSFileSystemMiner.
               internalHandleCommand(MVSFileSystemMiner.java:925)
  com.ibm.ftt.rse.mvs.server.miners.MVSFileSystemMiner.
                       handleCommand(MVSFileSystemMiner.java:700)
  org.eclipse.dstore.core.miners.Miner.command(Miner.java:336)
  org.eclipse.dstore.core.miners.Miner.handle(Miner.java:244)
  org.eclipse.dstore.core.model.Handler.run(Handler.java:135)
  MVSFileSystemMiner: FFS error: severity=8, msgNo=2048, opcode=0,
                                                 rc=196, reason=4,
  message=CEE3204S The system detected a protection exception
         (System Completion Code=0C4)., results=
  

Local fix

• Be sure that the Host Code page is set for
  MVS files.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.All zExpl and IDz users                   *
  *                 02.Users who query MVS filesystem where the  *
  *                    query encounters certain error condition  *
  *                 03.zExpl users using Host Configuration      *
  *                    Utility Guide                             *
  *                 04.Those who view host user logs             *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.A memory protection exception 0C4    *
  *                         ABEND happens.                       *
  *                      02.The MVS miner when retrieving the    *
  *                         datasets, for example as in          *
  *                         browsing the filesystem, may         *
  *                         encounter error and the program is   *
  *                         terminated with multiple CEE dumps   *
  *                         with OC4 abend.                      *
  *                      03.Utility Guide instructs the user to  *
  *                         go to /usr/lpp/IBM/zexpl/bin to run  *
  *                         IVP, which can result in failure     *
  *                      04.Excess tracing                       *
  ****************************************************************
  01.When a user attempts opening an MVS file, if for some reason
     the hostcp mapping for the member is absent, then an abend
     0C4 may occur in FFSJNI.
  02.When the program exits, in the cleanup routine by its
     condition handler, the attempt to free an invalid internal
     data structure (dyn_t) may cause repeated CEE dumps with OC4
     abend.
  03.Utility Guide instructs the user to go to
     /usr/lpp/IBM/zexpl/bin to run IVP, which can result in
     failure. Host Configuration guide has the correct steps.
  04.Excess tracing
  

Problem conclusion

• 01.In the unlikely event that a hostcp mapping is absent, it
     gets set to the default encoding for the host.
  02.It's an logic code error and happens only in certain error
     uncommon condition. A flag to mark the valid status of the
     internal data structure is introduced for a proper free
     condition check.
  03.The IVP panel is updated so it can run directly from the
     panel, avoiding the faulty instructions
  04.This reduces some of the trace messaesg
  

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:

  UI61722

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 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 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 UI62925

     UP19/05/22 P F905

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.