PH10896: ALIAS DATASET WITH SYMBOLIC NAME IS NOT AVAILABLE IN ZEXPLORER

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• In IBM Explorer for z/OS - zExplorer - v3.1.1.12, an alias
  dataset using symbolic name is not available on the Remote
  System Explorer.
  
  For example:
  
  ALIAS --------- MYHLQ.DB2.SDSNLOAD
      IN-CAT --- CPDLB1.CATALOG
      HISTORY
        RELEASE----------------2    CREATION--------0000.000
      ENCRYPTIONDATA
        DATA SET ENCRYPTION-----(NO)
      ASSOCIATIONS
        SYMBOLIC-MYHLQ.DB2.SDSNLOAD.&SYSNAME
        RESOLVED-MYHLQ.DB2.SDSNLOAD.SYSA
  
  Will not be displayed on the Remote System Explorer.
  
  
  Problem impacts IBM Developer for z Systems (IDz) user build
  with Rational Team Concert as well.
  IDz checks if a dataset exists before adding it to the SYSLIB of
  the generated JCL.
  

Local fix

• There are some workarounds that may help in this situation:
  
  - either add a dot "." at the end of the symbolic variable
  MYHLQ.DB2.SDSNLOAD.&SYSNAME.
  
  - or do not use the same prefix for the alias and the target
  dataset.
  Use for example:
  MYHLQ.ALIAS.DB2.SDSNLOAD
  to target MYHLQ.DB2.SDSNLOAD.&SYSNAME.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: 01.Users who query alias or symbolic         *
  *                    dataset name.                             *
  *                 02.All z/OS Explorer and IDz users           *
  ****************************************************************
  * PROBLEM DESCRIPTION: 01.Dataset alias name may be resolved   *
  *                         incorrectly to the original dataset  *
  *                         name. In such cases, they are not    *
  *                         included in the query result.        *
  *                      02.LISTDSI has additional result        *
  *                         fields but not get picked up in our  *
  *                         stub script                          *
  ****************************************************************
  01.Dataset alias name as a prefix of the real dataset name
     maybe missed in the name resolution during dataset query
     processing. Dataset alias name with a symbolic variable
     reference (without the optional end period) in the last
     qualifier would be missed in the symbol name resolution.
     This affects query with wild char.
  02.LISTDSI has additional result fields but not get picked up
     in our stub script
  

Problem conclusion

• 01.The two use cases of pattern in alias name were missed in
     the implementation coverage and testing. Alias name as a
     prefix of the real dataset name should be supported. The end
     period of the symbol variable reference in the last
     qualifier should be treated as optional.
  02.Updated the script to parse additional results from LISTDSI
  

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:

  UI62925

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 FEKFT016 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.