PK25484: HPIC HASH CHECK DOES NOT ISSUE THE ERROR EVEN IF IT GETS THE EMPTY DS1LSTAR BLOCK.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HPIC hash check does not issue the error even if it gets the
  empty DS1LSTAR block. It should issue the error in that case.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC Image Copy function generates an   *
  *                      image copy from damaged OSAM data set   *
  *                      which is not usable for IMS any longer. *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  HPIC Image Copy function generates an image copy from damaged
  OSAM data set which is not usable for IMS any longer.
  Because HPIC does not consider the DS1LSTAR field in the DSCB of
  an OSAM data set, and can not find that the OSAM data set is
  damaged.
  For imformation about a DS1LSTAR field for OSAM data set,
  refer to IMS V8 Admin Guide : DB ( SC27-1283 ) Appendix 1.3
  (Appendix C) : 'Using OSAM as the Access Method'.
  
  HPIC has modified as follows:
  - HPIC Image Copy function checks the DS1LSTAR field in the DSCB
    of OSAM data set to distinguish whether the empty data set is
    damaged or not.
  - HPIC Image Copy function does not generate an image copy
    if 1st data set of DSG is empty OSAM data set. Because it is
    not suitable for IMS database data set.
  - HPIC Image Copy function does not support the empty data set
    for FASTIC=(,COPY) process.
  

Problem conclusion

• FABJDOPN has been modified to check DS1LSTAR field in the DSCB.
  
  FABJDFCN has been modified to call FABJDOPN and check DS1LSTAR
  field.
  
  FABJDPSN and FABJFCDN have been modified to handle legitimately
  empty data set and damaged data set correctly.
  
  FABUITCT has been modified to add new flag for empty check.
  
  The following modules have been reassembled:
  FABJAPIM, FABJCMDB, FABJCRC3, FABJDCTL, FABJDEMP, FABJDFC7,
  FABJDFC8, FABJDFC9, FABJDMP7, FABJDMP8, FABJDMP9, FABJDPS7,
  FABJDPS8, FABJDPS9, FABJDPUT, FABJDREQ, FABJDRQS, FABJFCCM,
  FABJFCC7, FABJFCC8, FABJFCC9, FABJFCD7, FABJFCD8, FABJFCD9,
  FABJINT1, FABJINT2, FABJINT3, FABJIPRC, FABJMAIN, FABJMAS1,
  FABJNTFC, FABJNTFI, FABJSAS2, FABJSTA,  FABJTERM, FABJTOI,
  FABJUIC1, FABJXCR,  FABJXHPC
  
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409 ( SC189409 ) should be changed as
  follows:
  
  Chapter 12.0 Advanced Copy Services Support
    12.7 Restrictions
      12.7.3 FASTIC=COPY, Only
  
    Add following sentences.
   | Input database data set must not be empty. It is not
   | supported.
  
  
  Chapter A Appendix A. Return Codes, Abend Codes, and Messages
    A.3 Messages
  
    Add following section.
    - A.3.x FABJ0193E
   | FABJ0193E    EMPTY DATABASE DATA SET IS NOT SUPPORTED IN
   | FASTIC=(,COPY) PROCESS.
   | Explanation:Input database data set is empty. It is not
   | supported in FASTIC=(,COPY) process.
   | System action:HPIC processing ends a job with RC=8.
   | Programmer response:Check the input database data set and
   | rerun the job.
  

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:

  UK16688

Modules/Macros

• FABJAPIM FABJCMDB FABJCRC3 FABJDCTL FABJDEMP
  FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPN FABJDMP7 FABJDMP8
  FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT
  FABJDREQ FABJDRQS FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9
  FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJINT1 FABJINT2 FABJINT3
  FABJIPRC FABJMAIN FABJMAS1 FABJNTFC FABJNTFI FABJSAS2 FABJSTA
  FABJTERM FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABUITCT
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK16688

     UP06/07/29 P F607

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.