PK23424: THIS APAR PROVIDES NEW FUNCTION FOR HPIC

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides "New Function" for HPIC V3R2.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 3 Release 2 users ( FMID=H1J0320 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC V3R2 provides fixes that           *
  *                      correspond to following DRF APARs:      *
  *                                                              *
  *                      - APAR of DRF ICR (Incremental Image    *
  *                      Copy function)                          *
  *                         DRF V3 R1 : PK21934                  *
  *                         IMS V8    : PK20149                  *
  *                         IMS V9    : PK25750                  *
  *                                                              *
  *                      - APAR of DRF supports Stacked Image    *
  *                      Copy                                    *
  *                         DRF V3 R1 : PK25674                  *
  *                                                              *
  *                      This APAR also fixes HPIC problems.     *
  *                                                              *
  *                      - HPIC stack process generates an       *
  *                      invalid data set name, when ICHLQ=      *
  *                      keyword is specified in ICEIN           *
  *                      GROUP/IC/AIC/CIC/ACIC/CRC statement.    *
  *                                                              *
  *                      - Image copy function under DRF         *
  *                      terminates with ABEND S0C4 ( ABEND0C4 ) *
  *                      , when an error occurs in DRF process.  *
  *                                                              *
  *                      - FABJ0100E message text is printed     *
  *                      improperly, when ICEIN control          *
  *                      statement error occurrs in Image Copy   *
  *                      function under DRF.                     *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPIC V3R2 provides fixes that correspond to following DRF APARs:
  
  - APAR of DRF ICR (Incremental Image Copy function)
     DRF V3 R1 : PK21934
     IMS V8    : PK20149
     IMS V9    : PK25750
  
  - APAR of DRF supports Stacked Image Copy
     DRF V3 R1 : PK25674
  
  This APAR also fixes HPIC problems.
  
  - HPIC stack process generates an invalid data set name, when
  ICHLQ= keyword is specified in ICEIN GROUP/IC/AIC/CIC/ACIC/CRC
  statement.
  
  - Image copy function under DRF terminates with
  ABEND S0C4 ( ABEND0C4 ) in FABJDEMP, when DRF calls API function
  improperly as a result of an error.
  
  - FABJ0100E message text is printed improperly, when ICEIN
  control statement error occurrs in Image Copy function
  under DRF.
  

Problem conclusion

Temporary fix

Comments

• FABJAPI and FABJAPIP have been modified to support new API
  parameter for Incremental Image Copy of DRF.
  
  FABJDRQS has been modified to receive stoptime from API and set
  to HPIC control block.
  
  FABJMAS1 has been modified to receive stoptime from data space
  and copy back to HPIC control block.
  
  FABJNTFI has been modified to create parameter block for DBRC
  command.
  
  FABJNTFS has been modified to build DBRC NOTIFY command of CIC
  and issue notify call.
  
  FABJAPIM has been reassembled for FABJAPI.
  
  FABJDALO has been modified to allocate a output data set for
  stacking.
  
  FABJINT3 has been modified to determine a DD name for stack data
  set.
  
  FABJSAS1 has been modified to unallocate stack data set.
  
  FABJACQG has been modified to generate a valid data set name
  when ICHLQ= keyword specified in stack process.
  
  FABJPRM3 have been modified to print a correct message text of
  FABJ0100E.
  
  FABJTERM has been modified not to call FABJDEMP in DRF process.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 3 Release 2
  User's Guide SC18-7617-01 ( SC18761701 ) should be changed as
  follows:
  
  A.0Appendix A.  Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ0192E is added.
  
  | FABJ0192E IMAGE COPY FOR DBD=XXXXXXXX DDN=XXXXXXXX IS NOT
  | PROCESSED.
  |
  | Explanation: HPIC Image Copy do not process because DRF
  | processing error.
  |
  | System Action: HPIC Image Copy continues processing.
  |
  | Programmer Response: NONE.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK16049

Modules/Macros

• FABJACQG FABJAPI  FABJAPIM FABJAPIP FABJDALO
  FABJDRQS FABJINT3 FABJMAS1 FABJNTFI FABJNTFS FABJPRM3 FABJSAS1
  FABJTERM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R320 PSY UK16049

     UP06/07/08 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.