PK06517: DSPURX00, WHICH IS CALLED INTERNALLY IN HPIC, FAILS WHEN RECON LOSS NOTIFICATION IS ACTIVE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Database Recovery Control Utility (DSPURX00), which is called
  internally in HPIC, fails when the RECXON Loss Notification is
  active. This occurs when DSPURX00 requests registration for the
  SCI even though the HPIC job has already been registered to the
  SCI.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of IMS High Performance Image      *
  *                 Copy for z/OS Version 3 Release 2            *
  *                 (FMID=H1J0320).                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR fixes following problems of   *
  *                      High Performance Image Copy V3.2.       *
  *                      1. NOTIFY.UIC for VIC function          *
  *                         failes with message FABJ0177E        *
  *                         ( MSGFABJ0177E ) when using IMS Loss *
  *                         Notification.                        *
  *                      2. STOPTIME and USID are not set in     *
  *                         Image Copy Creation Report (ICERPRT) *
  *                         when using IMS Loss Notification.    *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Following problems of HPIC V3.2 is fixed by this APAR.
  1. NOTIFY.UIC for VIC function failes with message FABJ0177E
     ( MSGFABJ0177E ) when using IMS Loss Notification.
     Because DBRC NOTIFY.UIC command is failed due to SCI
     registration fail.
  2. STOPTIME and USID are not set in Image Copy Creation Report
     (ICERPRT) when using IMS Loss Notification.
     Because DBRC LIST.HISTORY command for getting DBRC IC record
     information is failed due to SCI registration fail
  
  The cause of both problem is that HPIC calls DSPURXRT to get
  under DFSRRC00 ULU region that is scheduled for batch image copy
  process. And DFSPURXRT tried to register SCI in ULU region,
  but SCI has already registerd by ULU region. So DFSPURXRT fails
  with following messages:
   DSP1135A  SCI REGISTRATION FAILED, IMSPLEX NAME=nnnnn,
   DSP1135A  RC=01000004, RSN=00001000, JOB=yyyyyyyy
   DSP0245I  JOB TERMINATED DUE TO UNAVAILABLE RECON DATA SETS
  
  SCI registration is required each TCB of IMS process, so HPIC
  changes to call DFSPURXRT as diffrent task TCB.
  

Problem conclusion

• A new module FABJATRC that calls DSPURXRT for DBRC command is
  provided. HPIC attaches the module that calls DSPURXRT in
  different task TCB from IMS ULU region TCB.
  
  FABJDMPN has been modified following things:
  - To attach and detach the new module FABJATRC.
  - To change the timing of reporting build logic for the create
    Image Copy Data Set report.
  
  FABJDMP7, FABJDMP8, and FABJDMP9 have been reassembled.
  
  FABJCRC0 has been modified to attach and detach the new module.
  
  FABJRPT0 has been modified to pass new parameters for the new
  module to FABJDBCM.
  
  FABJDBCM has been modified to pass new parameters for the new
  module to FABJDBC1.
  
  FABJDBC1 has been modified to post a new task for issuing
  DBRC command.
  
  FABJUIC1 has been modified to post a new task for issuing
  DBRC command.
  
  ========================
  = 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:
  
  --------------------------------------------------------------
  A.0 Appendix A.  Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ3937W is added.
  
  | FABJ3937W DBRC LIST COMMAND FAIL. SOME FIELDS OF CREATE IMAGE
  | COPY REPORT MAY NOT BE SET.
  
  | Explanation:
  | HPIC creates the image copy data sets successfully but fails
  | report some fields of create image copy data sets.
  
  
  | System Action:
  | Program FABJMAIN continues processing without reporting some
  | fields of the create image copy data set.
  | The return code of the process is 04.
  
  | Programmer Response:
  | Check some fields not reported in the ICERPRT and ensure
  | that fields with using the IMS LIST.RECON command.
  

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:

  UK04146

Modules/Macros

• FABJATRC FABJCRC0 FABJDBCM FABJDBC1 FABJDMPN
  FABJDMP7 FABJDMP8 FABJDMP9 FABJLINK FABJMSGC FABJRPT0 FABJUIC1
  H1J0320J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R320 PSY UK04146

     UP05/06/07 P F506

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.