PM34344: THIS APAR PROVIDES HPIC V4.2 ENHANCEMENT FOR VIC FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR provides enhancement for VIC function which bypass IMS
  command process and DB authorization for Index databases of VIC
  target, when Hash Check is not required.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 2 users ( FMID=H1J0420 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides a new keyword        *
  *                      BYPDBAUTH=.                             *
  *                                                              *
  *                      This APAR fixes following problems:     *
  *                                                              *
  *                      1. HP Image Copy preforms UIC           *
  *                         registration for the index database  *
  *                         which is not registered in DBRC.     *
  *                                                              *
  *                      2. HP Image Copy ends with RC=0 even    *
  *                         if UIC registration process fails.   *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR provides a new keyword BYPDBAUTH=. This enhancement is
  for FITS MR0727096831.
  
  The new keyword BYPDBAUTH= is supported in order to bypass a
  request of DBRC database authorization for the index database
  which is not requested physical image copy data set and HASH
  check process at the image copy process. When BYPDBAUTH=Y
  is specified, HP Image Copy skips following processes
  for the index database which is requested VIC=Y and HDPC=N:
    - Database authorization in DBRC
    - Dynamic allocation of index database data set
    - IMS command process even if either TOIAUTO=Y or TOIAUTO_Q=Y
      is specified
  
  This APAR also fixes following problems:
  
  1. HP Image Copy preforms UIC registration for the index
     database which is not registered in DBRC. HP Image
     Copy does not check database registration status in DBRC
     if the database is index and VIC=Y is requested.
     HP Image Copy checks database status in DBRC, and does not
     request unnecessary UIC registration to IMS.
  
  2. HP Image Copy ends with RC=0 even if UIC registration
     process fails.
     This APAR fixes that IMS HP Image Copy terminates with RC=08
     when NOTIFY.UIC command fails.
  

Problem conclusion

Temporary fix

Comments

• Following modules and macros are modified for this APAR:
  
  The following modules and macros have been modified.
   FABJBLKD FABJCMDB FABJDFCA FABJDFCB FABJDFCN FABJDFC2 FABJDFC9
   FABJDGMT FABJDMPA FABJDMPB FABJDMPN FABJDMP2 FABJDMP9 FABJDPSA
   FABJDPSB FABJDPSN FABJDPS2 FABJDPS9 FABJGLRP FABJPARM FABJRPT1
   FABJSTA  FABJSTMD FABJTGEN FABJTOI  FABJUIC1
  
  The following modules have been reassembled.
   FABJACQG FABJAPIM FABJASPM FABJATRC FABJCRC0 FABJCRC1 FABJCRC3
   FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM
   FABJDBC1 FABJDBDA FABJDBDB FABJDBDN FABJDBD2 FABJDBD9 FABJDBF0
   FABJDBLK FABJDBRA FABJDBRB FABJDBRC FABJDBR2 FABJDBR9 FABJDCTL
   FABJDDIM FABJDEMP FABJDMP0 FABJDOPN FABJDPUT FABJDREQ FABJDRQS
   FABJDRSN FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC2
   FABJFCC9 FABJFCDA FABJFCDB FABJFCDN FABJFCD2 FABJFCD9 FABJFDMP
   FABJGDGB FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX2 FABJIDX9
   FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA
   FABJMDPB FABJMDPN FABJMDP2 FABJMDP9 FABJMRGE FABJMSUL FABJNTFC
   FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB
   FABJORCN FABJORC2 FABJORC9 FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB
   FABJRCHK FABJRCH2 FABJRCH9 FABJRDBA FABJRDBB FABJRDB2 FABJRDB9
   FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN FABJRFC2 FABJRFC9
   FABJRPT0 FABJSAS1 FABJSAS2 FABJTERM FABJTOI2 FABJXCR  FABJXHPC
   FABJXLIM
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 2
  User's Guide SC19-2756-00 ( SC19275600 ) should be changed as
  follows:
  
  3.0  Running IMS HP Image Copy
       IMS HP Image Copy JCL statements
         ICEIN control statement keywords
  |        BYPDBAUTH keyword
  
  |    The BYPDBAUTH keyword specifies whether image copy function
  |    is to bypass database authorization in DBRC for index
  |    databases which are requested both VIC=Y and HDPC=N.
  |
  |    Statements that support this keyword
  |      GLOBAL statement
  |
  |    Site default option Supported
  |
  |    Related keyword
  |      DBDALLOC keyword
  |      DBRC keyword
  |      HDPC keyword
  |      TOIAUTO keyword
  |      TOIAUTO_Q keyword
  |      VIC keyword
  |
  |    Format
  |     +-------------------+
  |     | BYPDBAUTH=Y|N     |
  |     +-------------------+
  |    Y Following processes are bypassed
  |      - Database authorization in DBRC
  |      - Dynamic allocation of index database data set
  |      - IMS command process even if either TOIAUTO=Y or
  |        TOIAUTO_Q=Y is specified
  |
  |      DBUPDBAUTH=Y is ignored if either HDPC=Y|O or VIC=N is
  |      specified.
  |
  |    N Image Copy function processes database authorization,
  |      dynamic allocation of DB, and IMS command process.
  |
  |    Default value
  |      BYPDBAUTH=N
  

APAR Information

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

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

  UK66807

Modules/Macros

• FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD
  FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC
  FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB
  FABJDBDN FABJDBD2 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB
  FABJDBRC FABJDBR2 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA
  FABJDFCB FABJDFCN FABJDFC2 FABJDFC9 FABJDGMT FABJDMPA FABJDMPB
  FABJDMPN FABJDMP0 FABJDMP2 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB
  FABJDPSN FABJDPS2 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN
  FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC2 FABJFCC9
  FABJFCDA FABJFCDB FABJFCDN FABJFCD2 FABJFCD9 FABJFDMP FABJGDGB
  FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX2 FABJIDX9
  FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA
  FABJMDPB FABJMDPN FABJMDP2 FABJMDP9 FABJMRGE FABJMSUL FABJNTFC
  FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB
  FABJORCN FABJORC2 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA
  FABJRCHB FABJRCHK FABJRCH2 FABJRCH9 FABJRDBA FABJRDBB FABJRDB2
  FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN FABJRFC2
  FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA  FABJSTMD
  FABJTERM FABJTGEN FABJTOI  FABJTOI2 FABJUIC1 FABJXCR  FABJXHPC
  FABJXLIM
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R420 PSY UK66807

     UP11/04/17 P F104

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.