PK15594: THIS IS A FORWARD FIT FROM HPIC V3R2.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR fixes some DBRC interface troubles.
  

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 V3R1 and V3R2:                     *
  *                      - V3R1:                                 *
  *                        - PK99709                             *
  *                        - PK04295                             *
  *                      - V3R2:                                 *
  *                        - PK06517                             *
  *                                                              *
  *                      This APAR also includes some fixes of   *
  *                      HPIC V4R1.                              *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR includes following APAR fixes from HPIC V3R1 and HPIC
  V3R2:
  
  PQ99709 and PK04295 (HPIC V3R1)
  - The IMS DBRC interface module abends S378 ( ABEND378 ) RSN14.
    The cause of the abend is that the HPIC calls several the IMS
    DBRC interface from different TCBs.
  
    When the IMS DBRC interface module of HPIC abends S378
    ( ABEND378 ) ,the DBRC sign-off process for the DB fails in
    the error handling routine of HPIC. Then the SUBSYS record is
    not deleted by HPIC job, and it remains at DBRC RECON.
  
    When the IMS DBRC interface module of HPIC fails in the
    subtask process, the error handling routine of IMS can not be
    called. So HPIC can not identify the correct error reason of
    the subtask of HPIC, and terminates with ABEND U3933
    ( ABENDU3933 ).
  
  PK06517 (HPIC V3R2)
  - 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.
  - 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 DSPURXRT tried to register SCI in ULU
    region, but SCI has already registered by ULU region. So
    DSPURXRT 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 DSPURXRT as different task TCB.
  
  The following problems are fixed by this APAR:
  - HPIC Image Copy function terminates with RC=8 and issues
    FABJ4602E ( MSGFABJ4602E ), when TOIAUTO=Y is requested and
    IMS Loss Notification is enabled. Because SCI registration
    is failed in DBRC LIST.DB command or DSPAPI macro.
  - HPIC Image Copy function terminates with ABEND U0642
    ( ABENDU0642 ) and issues DFS642I ( MSGDFS642I ), when
    IMSPLEX keyword is specified in the ICEIN. Because HPIC sets
    the IMSplex name into incorrect position of parameter of
    DFSRRC00 program.
  

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.
  
  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.
  
  A new module FABJBRL7, FABJBRL8, and FABJBRL9 for DBRC
  interface module are provided.
  
  A new macro FABJBRLS has been build.
  
  FABJDMPN has been modified following things:
  - To attach and detach the new module FABJATRC and FABJTOI.
  - To change the timing of reporting build logic for the create
    Image Copy Data Set report.
  - To call the modules FABJBRL7, FABJBRL8, and FABJBRL9 from the
    maintask of HPIC when the HPIC module (FABJDPS7, FABJDPS8,
    FABJDPS9, FABJMDP7, FABJMDP8, FABJMDP9, FABJDFC7, FABJDFC8,
    FABJDFC9, FABJFCC7, FABJFCC8, FABJFCC9, FABJFCD7, FABJFCD8 or
    FABJFCD9) requests for the DBRC interface
  - To add an ECB for DBRC interface module
  - To remove DBRC interface call
  
  FABJDPSN, FABJMDPN, FABJDFCN, FABJFCCN and FABJFCDN have been
  modified to request FABJBRL7, FABJBRL8, or FABJBRL9 for call
  DBRC interface call instead of direct calling DBRC interface.
  
  FABJDPSN has been modified to call the modules FABJBRL7,
  FABJBRL8, and FABJBRL9 under UCF.
  
  FABJTOI has been to modified to receive the attach parameter
  from FABJDMPN.
  
  FABJDSSB and FABJINT2 have been modified to change the parameter
  list of DMPXPARM that the same as FABJDMPN definition.
  
  FABJICDD, FABJPARM, and FABJTGEN have been modified to change
  max value of TASKCTL and GRPLIM to 253 from 255.
  
  FABJMAIN has been to modified to set the correct position of
  parameter for DFSRRC00 ULU region.
  
  FABJMSGC has been to modified to add the new message.
  
  The following modules have been reassembled.
    FABJDFC7  FABJDFC8  FABJDFC9  FABJDMP7  FABJDMP8  FABJDMP9
    FABJDPS7  FABJDPS8  FABJDPS9  FABJFCAI  FABJFCCM  FABJFCC7
    FABJFCC8  FABJFCC9  FABJFCD7  FABJFCD8  FABJFCD9  FABJMDP7
    FABJMDP8  FABJMDP9  FABJRFCN  FABJRFC7  FABJRFC8  FABJRFC9
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  IMS High Performance Image Copy for z/OS Version 4 Release 1
  User's Guide: Document Number: SC18-9409-00 ( SC18940900 )
  should be changed as follows:
  
  2.0 Operating Instructions
   2.3 Input
    2.3.5 ICEIN Keywords
     2.3.5.25 GRPLIM=
       The GRPLIM keyword specifies the maximum number of tasks
       to be processed in parallel within a GROUP. If the number
       of data sets that are registered in CAGRP or DBDSGRP of
       DBRC is more than the value in the GRPLIM keyword,
       HPIC processes the number of subtasks specified in GRPLIM,
       and the subtasks that exceed this number are kept waiting
       until one of the data set processes has terminated.
  |    The valid value of nnn is 0-253. When the specified
  |    value is '0', it is same meaning of GRPLIM=253.
  
    +-----------------------------------------------------------+
    | GRPLIM=nnn                                                |
    +-----------------------------------------------------------+
  
  A.0 Appendix A.  Return Codes, Abend Codes, and Messages
   A.3 Messages
  
  The message FABJ3934E is added.
  | FABJ3934E MAINTASK FAILED TO ATTACH SUBTASK mmmmmmmm
  |
  | Explanation:
  | An attempt by ATTACH to attach the subtask mmmmmmmm failed.
  |
  | System Action:
  | The image copy function terminates with an abend code of 3934.
  |
  | Programmer Response:
  | Correct any obvious errors, and rerun the job.
  | If the problem remains, call IBM for support.
  
  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:

  UK09471

Modules/Macros

• FABJATRC FABJBRLS FABJBRL7 FABJBRL8 FABJBRL9
  FABJCP4S FABJCRC0 FABJDBCM FABJDBC1 FABJDFCN FABJDFC7 FABJDFC8
  FABJDFC9 FABJDMPN FABJDMP7 FABJDMP8 FABJDMP9 FABJDPSN FABJDPS7
  FABJDPS8 FABJDPS9 FABJDSSB FABJFCAI FABJFCCM FABJFCCN FABJFCC7
  FABJFCC8 FABJFCC9 FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJICDD
  FABJINT2 FABJLINK FABJMAIN FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9
  FABJMSGC FABJPARM FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0
  FABJTGEN FABJTOI  FABJUIC1 H1J0410J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK09471

     UP05/11/30 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.