PQ84456: HPIC V3 SUPPORTS VIRTUAL IMAGE COPY OF PRIMARY INDEX AND SECONDARY INDEX

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• HPIC V3 Image Copy function supports Virtual Image Copy of
  Primary Index data set and Secondary Index data set.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 3 users (FMID=H1J0310)               *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR provides following new        *
  *                      functions:                              *
  *                      - The Virtual Image Copy options        *
  *                      - New symbolic parameter &JDAY2         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  IMS High Performance Image Copy for z/OS V3 provides following
  functions:
  - Virtual Image Copy
    The Virtual Image Copy is the optional function of Image
    Copy function. When you specified VIC=Y in the ICEIN control
    statement, HPIC does not create a physical image copy data
    set but registers dummy IC data set as UIC into DBRC.
    * HDPC HASH Check option does not support the secondary
     index data set.
  
  - New Symbolic parameter &JDAY2
  

Problem conclusion

Temporary fix

Comments

• FABJDMPN, FABJDPSN, FABJBLKD, FABJDALO, FABJPRT0, and FABUITCT
  have been modified to Virtual Image Copy function.
  
  FABJPARM, FABJSTMD, and FABJTGEN have been modified to support
  the new keyword VIC= and VICDSN=, and the new parameter HDPC=O.
  
  FABJACQG has been modified to support a new symbolic parameters.
  
  A new module FABJUIC1 and FABJCMDB have been added for
  processing the DBRC NOTIFY.UIC command.
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 3 Release 1
  User's Guide SC27-187140-00 ( SC18761700 ) should be changed
  as follows:
  
  Add following restriction for Image Copy function is added.
  1.5.2 Restrictions on the Image Copy Function
  | - The same data set group,  DBDS, or AREA can not process
  |   in the same job step.
  | - Shared secondary indexes that points to same data set
  |   can not process in the same job step.
  
  Add new optional keywords and options.
  2.3.4.1 GLOBAL Statement
    The GLOBAL statement contains the following keywords:
       :
  |  - VIC=
  |  - VICDSN=
  
  2.3.4.2 GROUP Statement
    Optional keywords:
       :
  | VIC=
  | VICDSN=
  
  2.3.4.3 IC/AIC Statement
    Optional keywords:
       :
  | VIC=
  | VICDSN=
  
  2.3.5.25 HDPC= keywords
    The HPDC keyword specifies whether the HPIC Image Copy
    function invokes the pointer check of the HD Pointer Checker
    utility, or not. This keyword is valid when the executing
    function is a batch image copy.
    +--------------------------------------------------------+
  | | HDPC=Y|O|N|(Y|O,HISTORY,BITMAP,FSEMAP,MAXFSD)          |
    +--------------------------------------------------------+
    where:
    Y  invokes the HDPC HASH pointer check during the execution
       of the HDPC Image Copy function.
  
       If HDPC=Y is specified for the database not applicable to
       the HD Pointer Checker HASH Check function, an image copy
       of the database is taken but no pointer checking is
       processed.
  | O  invokes the HDPC HASH pointer check, but output image
  |    copy is not created and notified as UIC for primary
  |    index data set. If the HDPC=O is specified for other
  |    than primary index data set, Image Copy function
  |    runs the same process of HDPC=Y.
  
    N  does not invoke the HDPC HASH pointer check during
       the execution of the HPIC Image Copy function. this
       is the default.
  
  2.3.5.nn VIC=
  | VIC=
  | The VIC keyword specifies whether the HPIC Image Copy
  | function processes a virtual image copy for the primary
  | and secondary indexes, or not.
  
  | +---------------------------------------------------+
  | |     VIC=Y|N                                       |
  | +---------------------------------------------------+
  
  | where:
  | Y  specifies that Image Copy functions does not create
  |    physical image copy data set for the primary and
  |    secondary indexes data set, but registers dummy image
  |    copy data set name into DBRC as UIC.
  
  | N  specified that Image Copy function creates physical image
       copy data set for primary and secondary indexes.
       This is the default.
  
  | This keyword can be used in the following control statements:
  |    GLOBAL,GROUP,IC,AIC,CIC,ACIC
  
  2.3.5.nn VICDSN=
  | 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 NOTIRY.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
  
  Add a new symbolic parameters:
  6.3.2.2 Symbolic Parameters
  |  &JDAY2   The last two digits of the Julian date (dd)
  
  Following new messages are added:
  Appendix A.3 Messages
  | FABJ0173E  VIC=Y AND HDPC=O ARE MUTUALLY EXCLUSIVE
  
  | Explanation: Both the VIC=Y and the HDPC=O parameter are
  | specified in a control statement, but they are mutually
  | exclusive.
  
  | System Action: FABJMAIN stops processing with a return code
  | of 16.
  
  | Programmer Response: Remove the unused parameter, and rerun
  | the job.
  
  | FABJ0174I  VIRTUAL IMAGE COPY PROCESS IS APPLIED
  
  | Explanation: The virtual image copy process is applied for
  | primary and secondary indexes database.
  
  | System Action: None
  
  | Programmer Response: None
  
  | FABJ0175I  HD POINTER CHECKER IS PROCESSED WITHOUT CREATING
  |            OUTPUT IMAGE COPY
  
  | Explanation: HDPC HASH CHECK is done without creating output
  | image copy for primary index database.
  
  | System Action: None
  
  | Programmer Response: None
  
  | FABJ0176I  VIRTUAL IMAGE COPY PROCESS IS NOTIFYING DUMMY DATA
  |            SET NAME TO DBRC DBD=&        DDN=&
  
  | Explanation: Virtual image copy process notifies a dummy
  | data set name as UIC into DBRC.
  
  | System Action: None
  
  | Programmer Response: None
  
  | FABJ0177E  NOTIFY.UIC PROCESS FAILED DBD=$        DDN=$
  
  | Explanation: NOTIFY.UIC process is failed. Dummy data set
  | name is not registered in DBRC.
  
  | System Action: Image Copy function terminates with a return
  | code of 08.
  
  | Programmer Response: Check the DBD and DD name and rerun the
  | job.
  

APAR Information

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

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

  UQ85508

Modules/Macros

• FABJACQG FABJBLKD FABJCALL FABJCMDB FABJCRC0
  FABJCRC1 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDBCM FABJDBC1
  FABJDBDN FABJDBD7 FABJDBD8 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7
  FABJDBR8 FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDOPN FABJDPSN
  FABJDPS7 FABJDPS8 FABJICDD FABJLINK FABJMAIN FABJMDP7 FABJMDP8
  FABJMRGE FABJMSGC FABJORCN FABJORC7 FABJORC8 FABJPARM FABJRCHK
  FABJRCH7 FABJRCH8 FABJRPT0 FABJSTMD FABJTGEN FABJUIC1 FABJXLIM
  FABUITCT H1J0310J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R310 PSY UQ85508

     UP04/02/27 P F402

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.