PQ96715: FIXES FOR ALL PROBLEMS FOUND BETWEEN CODE FREEZE AND 'GA' DATE

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR includes forward fits from HPIC V3.1 and some fixes
  for HPIC V3.2.
  

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 Forward fits from    *
  *                      HPIC V3R1 and some fixes of HPIC V3R2.  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR includes following APAR fixes from IMS High
  Performance Image Copy for z/OS version 3 release 1:
  
  PQ94218 (enhancements for HPIC VIC option)
  - HPIC does not read real index data sets when specifying
    VIC=Y and HDPC=N.
  - HPIC issues NOTIFY.UIC command for all VIC at one time.
  - VICDSN keyword can be specified on the GROUP statement.
  
  PQ94538
  -HPIC abends U0044 ( ABENDU0044 ) in recovery process of HALDB,
   because HPIC internally behaves as if DBRC=N is specified when
   LOGUSE=N is specified.
  
  PQ95221 (enhancement for HASH check option for DEDB with the
  Concurrent Image Copy (CIC) function.)
  - If the target area of DEDB is used by other application with
    UPDATE authorization during the CIC processing with the DEDB
    HASH check, the generated report of the HASH check may not
    be certified.
  
    >*< NOTE >*< NOTE >*< NOTE >*<
    HASH Checking for FF DB with CIC function is still restricted.
  
  PQ95227
  - HPIC abends U3916 ( ABENDU3916 ) in recovery or create image
    copy function when the input IC data set is not cataloged
    even if the CATDS(Y) option is specified in DBRC.
    Because HPIC tries to allocate input IC data set
    only with the information of DSN registered in RECON.
  
  PQ96271
  -HPIC ignores the following keywords specified in the GLOBAL
   statement when stacking is used:
     DATACLAS
     MGMTCLAS
     STORCLAS
  
  
  This APAR also fixes the following problems:
  
  -HPIC does not pass the unit name for dynamic allocation of
   temporary data set from IPR to HPPC.
  
  -HPIC abends U3916 ( ABEND3916 ) when more than 34 characters
   are specified in the ICHLQ keyword for the data set name of
   Image Copy.
  

Problem conclusion

Temporary fix

Comments

• FABJINT2, FABJDMPN and  FABUITCT have been modified to pass the
  unit name for dynamic allocation of temporary data set from IPR
  to HPPC.
  
  FABJDPSN has been modified to eliminate reading records from
  database data set(s) when specifying VIC=Y and HDPC=N.
  
  FABJDMPN, FABJUIC1 and FABJCMDB have been modified to issue
  NOTIFY.UIC command for all VIC at one time.
  
  FABJACQG, FABJDALO, FABJSTMD, FABJPARM, and FABJBLKD have been
  modified to be able to specify the VICDSN keyword on the GROUP
  statement.
  
  FABJMAIN has been modified to use DBRC when DBRC=Y and LOGUSE=N
  are specified.
  
  FABJRDB7, FABJRDB8, and FABJRDB9 have been modified to bypass
  the logic that registers the recovery runtime to RECON when
  LOGUSE=N is specified.
  
  FABJDALC has been modified to try to allocate the input IC data
  set using UNIT and VOLSER information registered in RECON after
  failing to allocate it relying on the catalog if the CATDS(Y)
  option specified in DBRC.
  
  FABJDPSN, FABJRCHK, and FABJBLKD have been modified to enable to
  invoke the DEDB HASH check under running the CIC function.
  
  FABJACQG has been modified to avoid allocation failure of output
  IC data set even if more than 34 characters are specified in the
  ICHLQ keyword.
  
  The following modules have been reassembled.
    FABJCRC0  FABJDBD7  FABJDBR8  FABJDPS7  FABJMDP8  FABJRCHK
    FABJCRC1  FABJDBD8  FABJDBR9  FABJDPS8  FABJMDP9  FABJRCH7
    FABJCTCV  FABJDBD9  FABJDMP0  FABJDPS9  FABJMRGE  FABJRCH8
    FABJCZCV  FABJDBF0  FABJDMP7  FABJICDD  FABJORCN  FABJRCH9
    FABJDALC  FABJDBLK  FABJDMP8  FABJMAIN  FABJORC7  FABJRPT0
    FABJDBCM  FABJDBRC  FABJDMP9  FABJMDPN  FABJORC8  FABJTGEN
    FABJDBC1  FABJDBR7  FABJDOPN  FABJMDP7  FABJORC9  FABJXLIM
    FABJDBDN  FABJCMDB  FABJDCTL  FABJDPUT  FABJDREQ  FABJDRQS
    FABJMAS1  FABJNTFC  FABJSAS2  FABJTERM  FABJUIC1
  
  
  ========================
  = 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.4.4 CIC/ACIC Statement
  
  |Note: You cannot perform a pointer check for a full function
  |       data base in the Concurrent Image Copy process.
       :
     Optional keywords:
       :
        DDN=
  |     DEDBPC=
        EXPDT=
  
  
  2.3.5.15 DEDBPC=
  
    The DEDBPC keyword specifies whether the HPIC Image Copy
    function invokes the HASH check option of the DEDB Pointer
    Checker utility, or not. This keyword is valid when the
  | executing function is a batch image copy or a Concurrent image
  | copy
  
  
    +-----------------------------------------------------------+
    | DEDBPC=Y|N                                                |
    +-----------------------------------------------------------+
    where:
    Y        invokes the DEDB HASH pointer check during
             execution of the HPIC Image Copy function.
  
    N        does not invoke the DEDB HASH pointer check during
             the execution of the HPIC Image Copy function. this
             is the default.
  
  | Note:
  | If the target area of DEDB is used by other application
  | with UPDATE authorization during the CIC processing with the
  | DEDB HASH check, the generated report of the HASH check may
  | not be certified.
  
    This keyword can be used in the following control statements:
  |    GLOBAL, GROUP, IC, AIC, CIC, ACIC
  
  
  2.3.5.33 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.52 VICDSN=
  
    The VICDSN keyword specifies the dummy data set name that
    is used for being registered into DBRC as UIC data set name
    of the virtual image copy.
  
    +---------------------------------------------------+
    |     VICDSN=dummy data set name                    |
    +---------------------------------------------------+
  
    where:
    dummy data set name
       specifies dummy data set name that is registered into
  |    DBRC as the data set name for NOTIFY.UIC command of
       Virtual Image Copy process.
  
       The dummy data set name must be less than
       45 characters.
  
    This keyword can be used in the following control statements:
  |    GLOBAL, GROUP
  
  6.2.4 Dynamic Allocation for the Stacked Data Set
  
  | When the stacking is used and DD card for stacked data set is
  | not presented in running JCL, the Image Copy function
    dynamically allocates the stacked data set by using the
    allocation information specified by the ICEIN control
    statements.
    The following keywords are effective for each stacked image
    copy data set only when they are specified in the GLOBAL
    statement. If they are specified in any other statement except
    the GLOBAL statement, they are ignored.
  

APAR Information

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

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

  UQ95047

Modules/Macros

• FABJACQG FABJBLKD FABJCMDB FABJCRC0 FABJCRC1
  FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDBCM FABJDBC1 FABJDBDN
  FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7
  FABJDBR8 FABJDBR9 FABJDCTL FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8
  FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT
  FABJDREQ FABJDRQS FABJGVT  FABJGVT0 FABJICDD FABJINT1 FABJINT2
  FABJIPRC FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9
  FABJMRGE FABJNTFC FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM
  FABJPRM2 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8
  FABJRDB9 FABJRPT0 FABJSAS2 FABJSTMD FABJTERM FABJTGEN FABJUIC1
  FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R320 PSY UQ95047

     UP04/12/07 P F412

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.