PH69561: IN EXPLORER FOR Z/OS 3.4.3, PRIVATE_COMMON_PROPERTIES DIRECTORY IS CREATED EVEN WHEN THE FEATURE IS NOT ENABLED

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In Explorer for z/OS 3.4.3, when a user logs in after a host
  upgrade, a directory, private_common_properties, is created
  under the z/OS Explorer user's OMVS home directory, even if the
  feature is not enabled in rse.env.
  
  If the RSE_COMMON_PROPERTIES environment variable is not set,
  the service is not enabled, and the default private common
  properties folder should not be created.
  
  If RSE_COMMON_PROPERTIES_PRIVATE_RELATIVE is not set, the
  default private common properties folder will default to
  /<user_home>/private_common_properties.
  
  See https://www.ibm.com/docs/en/explorer-for-zos/3.4.0?topic=bc
  -rseenv-rse-configuration-file for an explanation of these
  settings:
  RSE_COMMON_PROPERTIES
  RSE provides a Common Properties service. This mechanism allows
  authenticated users and tools to store and retrieve generic data
  
  among the team members in a flexible, shareable manner. ...
  
  To enable this service, set the RSE_COMMON_PROPERTIES
  environment variable to a path of a folder accessible by the
  intended users:
  RSE_COMMON_PROPERTIES=<path>
  This service is designed to be used like a "bulletin board" for
  basic information sharing purposes. For example, it can be used
  for sharing various service ports and installation directories.
  Common Properties resources should be considered non-restrictive
  
  and mutable by authenticated users. As such, this service is
  amenable to informal data sharing but should not be treated as a
  
  formal database substitute.
  
  RSE_COMMON_PROPERTIES_PRIVATE_RELATIVE
  To enable the private Common Properties service, set this
  variable to a UNIX directory relative to a given user home
  directory. The private Common Properties for a user are stored
  in /<user home>/RSE_COMMON_PROPERTIES_PRIVATE_RELATIVE.
  

Local fix

• Remove the directory or change the owner from the z/OS Explorer
  started task user id and change permissions to RWX so users can
  create a directory under their HOME directory.
  The HOME field must refer to a home directory allocated for the
  z/OS Explorer user with READ, WRITE and EXECUTE access, but it
  should not be owned by the z/OS Explorer started task user id.
  https://www.ibm.com/docs/en/explorer-for-zos/3.4.0?topic=consid
  erations-user-id
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 1. All Users                                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. In Explorer for z/OS 3.4.3, when a   *
  *                      user logs in after a host upgrade, a    *
  *                      directory, private_common_properties,   *
  *                      is created under the z/OS Explorer      *
  *                      user's OMVS home directory, even if     *
  *                      the feature is not enabled in rse.env.  *
  ****************************************************************
  1. A directory, private_common_properties is created under the
  z/OS Explorer user's OMVS home directory, even if the feature
  is not enabled.
  

Problem conclusion

• 1. Add a check for the RSE_COMMON_PROPERTIES environment
  variable to verify whether the service is enabled. If the
  service is not enabled, do not create the private common
  properties.
  

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:

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 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 FEKFPKCS
  FEKFPLUG FEKFPTC  FEKFRIVP FEKFRMSG FEKFRSES FEKFRSRV FEKFSCMD
  FEKFSEND FEKFSSL  FEKFSTUP FEKFT000 FEKFT002 FEKFT003 FEKFT004
  FEKFT005 FEKFT006 FEKFT007 FEKFT008 FEKFT009 FEKFT010 FEKFTEAM
  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  FEKPKCS1 FEKRACF  FEKRSED
  FEKSAPF  FEKSAPPL FEKSBPX  FEKSCLAS FEKSCLOG FEKSCMD  FEKSCPYM
  FEKSCPYU FEKSDSN  FEKSENV  FEKSETUP FEKSISPF FEKSJCFG FEKSJCMD
  FEKSJMON FEKSJWT  FEKSJWTU 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

• R340 PSY UO06789

     UP26/02/20 P F602

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.