PK10314: THIS APAR INCLUDES FORWARD-FITS FROM HPIC V3R1.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR includes fixes for HPIC V3R1 APARs:
  - PK04525
  - PK08572
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 3 Release 2 users ( FMID=H1J0320 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR includes following APARs of   *
  *                      HPIC V3R1:                              *
  *                      - PK04525                               *
  *                      - PK08572                               *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes following APAR fixes from HPIC V3R1:
  
  PK04525 fixes following problems:
  - HPIC V3R2 abends U3916 ( ABENDU3916 ) in recovery function
    when the CATDS(Y) option is defined in the DBRC and HPIC
    tries to dynamically allocate the CA data set or the LOG data
    set or the IC data set and any of them have already been
    allocated by another job.
    Because HPIC tries to allocate them with DISP=OLD.
  
  - HPIC V3R2 abends U3916 ( ABENDU3916 ) in recovery function
    when the CA data set and the LOG data set are not cataloged
    even if the CATDS(Y) option is defined in DBRC.
    Because HPIC tries to allocate these data sets only with the
    information of DSN registered in DBRC.
  
  - HPIC V3R2 abends U3916 ( ABENDU3916 ) in recovery function
    when multiple LOG data sets are used and the value of the
    LOGUNIT keyword specified in the ICEIN is applied.
    Because HPIC does not use the value of the LOGUNIT keyword
    except for the first LOG data set.
  
  PK08572
  - HPIC V3R2 Recovery function fails with RC=16 when the CATDS
    option is used in DBRC and a CA data set is dynamically
    allocated and any of the LOG data sets are not used.
    Because HPIC dynamically allocates a data set for DFSULOG
    using DSN of the CA data set.
  

Problem conclusion

• FABJDALC has been modified following items.
  -To use DISP=SHR parameter for dynamic allocation of a CA data
   set, a LOG data set, and an IC data set when the CATDS(Y)
   option is defined in DBRC.
  -To try to dynamically allocate the CA and LOG data sets using
   UNIT and VOLSER information registered in DBRC after failing to
   allocate these data sets relying on the catalog even if the
   CATDS(Y) option defined in DBRC.
  -To initialize Text Units each time HPIC dynamically allocates a
   CA data set or a LOG data set when the CATDS option is used in
   DBRC.
  
  FABJDBRC has been modified to use the UNIT information of the
  first LOG data set as that of all the LOG data sets when
  multiple LOG data sets are used for recovery and the value of
  the LOGUNIT keyword specified in the ICEIN is applied.
  
  FABJDBR7, FABJDBR8, and FABJDBR9 have been reassembled.
  
  
  ========================
  = 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:
  
  2.3.5.4  CAUNIT=
  
     The CAUNIT keyword specifies the name of the unit where the
     input change accumulation log data set resides.
      _______________________________________________________
     |                                                       |
     |       CAUNIT=unitname                                 |
     |_______________________________________________________|
  
    where:
     unitname
         is the unit name of the log data set for dynamic
         allocation.
  
         The following table shows how the HPIC Database Recovery
         function handles the unit parameter for dynamic
         allocation.
  
  |     _________________________________________________________
  |    |         |    DBRC Status is CATDS       | DBRC Status Is|
  |    |         |_______________________________| NOCATDS       |
  |    |         | input CA is   | input CA is   |               |
  |    |         | cataloged     | not cataloged |               |
  |    |_________|_______________|_______________|_______________|
  |    |CAUNIT=  |Ignore CAUNIT= |Use CAUNIT=    | Use CAUNIT=   |
  |    | unitname|Use catalog    |               |               |
  |    |         |information    |               |               |
  |    |         |               |               |               |
  |    |_________|_______________|_______________|_______________|
  |    |Omit     |Use Catalog    |Use unit name  | Use unit name |
  |    | CAUNIT= |information    |in CA record   | in CA record  |
  |    |         |               |in DBRC        | in DBRC       |
  |    |_________|_______________|_______________|_______________|
  
     This keyword can be used in the following control statements:
  
         GLOBAL, RCV
  
  
  2.3.5.36 ICUNIT=
  
     The ICUNIT keyword specifies the unit name where the image
     copy data set resides.
      _______________________________________________________
     |                                                       |
     |       ICUNIT=unitname                                 |
     |_______________________________________________________|
  
    where:
     unitname
         is the unit name of the input image copy data set
         for dynamic allocation.
  
         The following table shows how the HPIC Database Recovery
         function and the Create Image Copy function handle the
         unit parameter for dynamic allocation.
  
  |     _______________________________________________________
  |    |         |    DBRC Status is CATDS     | DBRC Status Is|
  |    |         |_____________________________| NOCATDS       |
  |    |         | input IC is  | input IC is  |               |
  |    |         | cataloged    | not cataloged|               |
  |    |_________|______________|______________|_______________|
  |    |ICUNIT=  |Ignore ICUNIT=| Use ICUNIT=  | Use ICUNIT=   |
  |    | unitname|Use catalog   |              |               |
  |    |         |information   |              |               |
  |    |         |              |              |               |
  |    |_________|______________|______________|_______________|
  |    |Omit     |Use Catalog   |Use unit name | Use unit name |
  |    | ICUNIT= |information   |in IC record  | in IC record  |
  |    |         |              |in DBRC       | in DBRC       |
  |    |_________|______________|______________|_______________|
  
     This keyword can be used in the following control statements:
  
  |      GLOBAL, CRC, RCV
  
  
  2.3.5.38 LOGUNIT=
  
     The LOGUNIT keyword specifies the name of the unit where the
     input log data set resides.
      _______________________________________________________
     |                                                       |
     |       LOGUNIT=unitname                                |
     |_______________________________________________________|
  
    where:
     unitname
         is the unit name of the log data set for dynamic
         allocation.
  
         The following table shows how the HPIC Database Recovery
         function handles the unit parameter for dynamic
         allocation.
  
  |     _________________________________________________________
  |    |         |    DBRC Status is CATDS       | DBRC Status Is|
  |    |         |_______________________________| NOCATDS       |
  |    |         | input LOG is  | input LOG is  |               |
  |    |         | cataloged     | not cataloged |               |
  |    |_________|_______________|_______________|_______________|
  |    |LOGUNIT= |Ignore LOGUNIT=|Use LOGUNIT=   | Use LOGUNIT=  |
  |    | unitname|Use catalog    |               |               |
  |    |         |information    |               |               |
  |    |         |               |               |               |
  |    |_________|_______________|_______________|_______________|
  |    |Omit     |Use Catalog    |Use unit name  | Use unit name |
  |    | LOGUNIT=|information    |in LOG record  | in LOG record |
  |    |         |               |in DBRC        | in DBRC       |
  |    |_________|_______________|_______________|_______________|
  
     This keyword can be used in the following control statements:
  
         GLOBAL, RCV
  

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:

  UK06303

Modules/Macros

• FABJDALC FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R320 PSY UK06303

     UP05/08/19 P F508

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.