PK14382: THIS IS A FORWARD-FIT APAR FROM HPIC V3R2. THIS APAR ACCUMULATES HPIC TROUBLE UNDER THE IPR PRODUCT.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This is a forward fit APAR from HPIC V3.2. This APAR accumulates
  the following APARs that are related to the IPR product:
     PK03433
     PK09763
     PK11854
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR includes following APARs of   *
  *                      HPIC V3R2:                              *
  *                      - PK03433                               *
  *                      - PK09763                               *
  *                      - PK11854                               *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR includes following APAR fixes from IMS High
  Performance Image Copy for z/OS version 3 release 2:
  
  PK03433 fixes following problem:
  - The HPIC Image Copy function issues MSGFABJ0999E ( FABJ0999E )
    and stops processing when a secondary index database is empty
    processed by ICTYPE=A and INDEXBLD=Y of IPR Version 3
    Release 1.
    Because the Index Builder does not call the HPIC if the
    processed secondary index database is empty. So the HPIC
    can not create the output image copy data sets for the empty
    secondary index database.
  
  PK09763 fixes following problems:
  - When Type-A Image Copy processing is selected by the IPR and
    Index Builder cannot build secondary index DB due to an error,
    HPIC treats the DB as an empty DB and fails to open the DB
    data set.
  
  - HPIC Image Copy function terminates with ABEND S0C4
    ( ABEND0C4 ) when neither ICOUT= nor STACK= is specified in
    some of IC/AIC/CIC/ACIC statements. Because HPIC does not
    check the specification of ICOUT= or STACK= keyword in every
    IC/AIC/CIC/ACIC statements.
  
  PK11854 fixes following problem:
  - The HPIC Image Copy function terminates with ABEND S238
    ( ABEND238 ) in the ENQ process of secondary image copy
    data set for the secondary index DB, when type-A image copy
    process with VIC=Y or HDPC=O under IMS Parallel Reorganization
    for z/OS Version 3 Release 1 with INDEXBLD=YES is requested.
    Because HPIC requests ENQ by an incorrect length of the
    resource name.
  
  +--------------------------------------------------------------+
  |APAR PK03181 is required to be applied to IMS High Performance|
  |Pointer Checker for z/OS Version 2 Release 1 ( FMID=HPC2210 ).|
  +--------------------------------------------------------------+
  

Problem conclusion

• A new module FABJDEMP is provided that creates the image copy
  data sets of the empty secondary index database.
  
  FABJTERM has been modified as follows:
  - To load the new module FABJDEMP when the HPIC finds the empty
    secondary index database with ICTYPE=A and INDEXBLD=Y under
    IPR V3R1.
  - To bypass the process of the empty secondary indices and issue
    FABJ0185E message, when IB process fails.
  
  FABJBLKD has been modified to add following new fields for
  generating the messages by FABJTERM.
   - DBVRFYRC, DBVRFYFB, DBERTYP5
     If the HPIC fails to open the empty secondary index database,
     the DFS2802A, DFS3729I, and DFS301A messages are generated
     using them.
  
  FABJMAS1 has been modified not to turn on the flags that
  indicate error status for an empty secondary index database.
  
  FABJDOPN has been modified to move the process of generating
  error messages to FABJTERM.
  
  FABJIPRC has been modified as follows:
  - To receive the status of IB process from the IPR Driver.
  - To bypass the logic that issues ENQ/DEQ macro for output image
    copy data set of the secondary index DB, when VIC=Y or HDPC=O
    is specified.
  
  FABJPARM has been modified as follows:
  - To check all the IC/AIC/CIC/ACIC statements that either ICOUT=
    or STACK= is specified.
  - To check whether the selection of ICOUT= or STACK= keyword in
    GROUP statement is same as the previous statement.
  
  FABJINT2 has been modified to bypass the logic that issues
  ENQ/DEQ macro for output image copy data set of the secondary
  index DB, when VIC=Y or HDPC=O is specified.
  
  The following modules have been reassembled.
    FABJACQG, FABJCMDB, FABJCRC0, FABJCRC1, FABJCTCV, FABJCZCV,
    FABJDALC, FABJDALO, FABJDBCM, FABJDBC1, FABJDBD7, FABJDBD8,
    FABJDBD9, FABJDBF0, FABJDBLK, FABJDBR7, FABJDBR8, FABJDBR9,
    FABJDCTL, FABJDMP0, FABJDMP7, FABJDMP8, FABJDMP9, FABJDPS7,
    FABJDPS8, FABJDPS9, FABJDPUT, FABJDREQ, FABJDRQS, FABJICDD,
    FABJINT1, FABJMAIN, FABJMDP7, FABJMDP8, FABJMDP9, FABJMRGE,
    FABJNTFC, FABJORC7, FABJORC8, FABJORC9, FABJPRM2, FABJRCH7,
    FABJRCH8, FABJRCH9, FABJRDB7, FABJRDB8, FABJRDB9, FABJRPT0,
    FABJSAS2, FABJTGEN, FABJUIC1, FABJXLIM
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide SC18-9409-00 ( SC18940900 ) should be changed as
  follows:
  
  Appendix A.3 Messages
  
  ....+....1....+....2....+....3....+....4....+....5....+....6...>
  | FABJ0185E  THE DBDS IS NOT PROCEEDED DUE TO INDEX BUILDER
  |            ERROR
  |
  | Explanation: The HPIC process for the secondary index database
  | is not proceeded due to the error of Index Builder.
  |
  | System Action: HPIC continues processing and returns control
  | to the IPR Driver with return code 8, and the reason code
  | 00030010.
  |
  | Programmer Response: Check the error reason of Index Builder
  | process. If you wish, correct the error and re-run the job.
  

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

APAR Information

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

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

  UK08883

Modules/Macros

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

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK08883

     UP05/11/11 P F511 Ž

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.