PM04416: HPIC V4.1 TERMINATES WITH ABEND S0C4 WHEN RUNNING IMS COMPATIBLEJCL WITH MULTIPLE STEPS HASH CHECK.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• HPIC V4.1 terminates with ABEND 0C4 when HPIC is run by IMS
  compatible JCL with multiple steps HASH check.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a fix for following  *
  *                      problems of HP Image Copy.              *
  *                      1. ABEND S0C4 ( ABEND0C4 ) at FABJDMP9  *
  *                         occurs when HP Image Copy is run     *
  *                         under IMS compatible JCL with        *
  *                         Multiple steps HASH check.           *
  *                      2. DEDB Pointer Checker issues          *
  *                         unnecessary report header reports    *
  *                         for every area when HP Image Copy    *
  *                         runs under IMS Fast Path Basic       *
  *                         Tools.                               *
  *                      3. ABEND S0C4 ( ABEND0C4 ) at FABJDPSB  *
  *                         occurs when HP Image Copy uses       *
  *                         DFSMSdss DUMP command and fails to   *
  *                         open an empty DEDB.                  *
  *                      4. ABEND U0999 ( ABENDU0999 ) at        *
  *                         FABJMAIN occurs when HP Image Copy   *
  *                         processes only DEDB with DBALL=Y and *
  *                         HP pointer checker library is        *
  *                         specified in STEPLIB.                *
  *                      5. ABEND U3916 ( ABENDU3916 ) at        *
  *                         FABJDPS7 occurs when HP Image Copy   *
  *                         encounters an unrecoverable I/O      *
  *                         error in an image copy data set for  *
  *                         DEDB with HPIO=Y.                    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a fix for following problems of HP Image
  Copy.
  1. ABEND S0C4 ( ABEND0C4 ) at FABJDMP9 occurs when HP Image Copy
     is run under IMS compatible JCL with Multiple steps HASH
     check.
  2. DEDB Pointer Checker issues unnecessary report header reports
     for every area when HP Image Copy runs under IMS Fast Path
     Basic Tools.
  3. ABEND S0C4 ( ABEND0C4 ) at FABJDPSB occurs when HP Image Copy
     uses DFSMSdss DUMP command and fails to open an empty DEDB.
  4. ABEND U0999 ( ABENDU0999 ) at FABJMAIN occurs when HP Image
     Copy processes only DEDB with DBALL=Y and HP pointer checker
     library is specified in STEPLIB.
  5. ABEND U3916 ( ABENDU3916 ) at FABJDPS7 occurs when HP Image
     Copy encounters an unrecoverable I/O error in an image copy
     data set for DEDB with HPIO=Y.
  
  The causes of the problems are as follows:
  1. HP Image Copy wrongly judges that the process is FASTIC
     because it uses nonexistent internal block under IMS
     compatible JCL. It is possible problem by storage condition.
  
  2. HP Image Copy function that is invoked by IMS Fast Path
     Basic Tools has problems on following DD for the DEDB Pointer
     Checker.
     - MSGOUT DD
     - REPORTS DD
  
     If these DD are defined as the sequential data set
     (DSORG=PS), Hash check result reports only one area.
     If these DD are defined as the partitioned data set
     (DSORG=PO),  the JOB terminates with ABEND S213-30 ( ABEND213
     RSN30 ).
     If these DD are defined as the SYSOUT, unnecessary report
     header reports for every area.
  
     The cause of this problem is that DEDB Pointer Checker is
     called for initialization many times by HP Image Copy.
  
  3. HP Image Copy does not clear the address of the freemained
     work area.
  
  4. HP Image Copy creates a parameter list with no entries for HP
     Pointer Checker in the DBALL check routine. HP Pointer
     Checker judges it as a bad parameter list and returns error
     return code to HP Image Copy.
  
  5. HP Image Copy unallocates an open ADS without closing.
  

Problem conclusion

• FABJDMPN has been modified as follows:
  - Bypass FASTIC process under IMS compatible JCL.
  - Call the DEDB Pointer Checker with FUNC=INIT only once.
  
  FABJDBAL has been modified to return to FABJMAIN with RC=8 when
  it creates a parameter list with no entries for HP Pointer
  Checker.
  
  FABJMAIN has been modified as follows:
  - Change DBALL=Y to DBALL=N and bypass DBALL check routine when
    FABJDBAL returns with RC=8.
  - Change ABEND U0999 ( ABENDU0999 ) to ABEND U3999 ( ABENDU3999
    ) because ABEND U0999 is test ABEND code.
  
  FABJDFCN has been modified not to call FABJMDPN when the address
  of the freemained work area is cleared.
  
  FABJMDPN has been modified to clear the address of the
  freemained work area.
  
  FABJDPSN has been modified to unallocate an open ADS after
  closing.
  
  The following modules have been reassembled.
   FABJDFCA FABJDFCB FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPB
   FABJDMP7 FABJDMP8 FABJDMP9 FABJDPSA FABJDPSB FABJDPS7 FABJDPS8
   FABJDPS9 FABJMDPA FABJMDPB FABJMDP7 FABJMDP8 FABJMDP9
  

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:

  UK53654

Modules/Macros

• FABJDBAL FABJDFCA FABJDFCB FABJDFCN FABJDFC7
  FABJDFC8 FABJDFC9 FABJDMPA FABJDMPB FABJDMPN FABJDMP7 FABJDMP8
  FABJDMP9 FABJDPSA FABJDPSB FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9
  FABJMAIN FABJMDPA FABJMDPB FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK53654

     UP10/01/26 P F001

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.