PQ99709: IMS DBRC INTERFACE MODULE FAILS WITH ABEND378 IN HPIC V3

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• IMS DBRC interface module fails with ABEND378 RC14 in HPIC V3.
  The cause of ABEND is that HPIC call several IMS DBRCinterface
   from different TCB.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for      *
  *                 z/OS Version 3 Release 1 users               *
  *                 (FMID=H1J0310)                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: The IMS DBRC interface module abends    *
  *                      S378-14 ( ABENDS378 ) in the HPIC V 3   *
  *                      Image Copy                              *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  The IMS DBRC interface module abends S378 ( ABENDS378 ) RSN14
  in HPIC V3. The cause of abend is that the HPIC calls several
  the IMS DBRC interface from different TCBs.
  

Problem conclusion

• Image Copy function of HPIC V3 uses new subtask from where DBRC
  interface is always called. Consequence of that DBRC interface
  is called one paticular TCB in HPIC V3 Image Copy function.
  
  By applying this maintenance, the number of max tasks for image
  copy process is changed to 254 from 255. Consequence of that
  max value of TASKCTL= is changed to 254 from 255, too.
  
  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 load and attach the new module FABJBRL7, FABJBRL8, or
    FABJBRL9 and request for calling DBRC interface.
  - To issue the message FABJ3906E (MSGFABJ3906E) and terminate
    with an abend code of 3934 if HPIC fail to attach FABJBRLS7,
    FABJBRLS8, or FABJBRLS9 task.
  - To remove DBRC interface call
  
  FABJDPSN and FABJMDPN have been modified to request FABJBRL7,
  FABJBRL8, or FABJBRL9 for call DBRC interface call instead of
  direct calling DBRC interface.
  
  FASBJDMP7, FABJDMP8, FABJDMP9, FASBJDPS7, FABJDPS8, FABJDPS9,
  FASBJMDP7, FABJMDP8, and FABJMDP9 have been reassembled.
  
  FABJICDD, FABJPARM, and FABJTGEN have been modified to change
  max value of TASKCTL and GRPLIM to 254 from 255.
  
  Documentation Changes:
  The documentation is modified as follows:
   =====================================================
      IMS High Performance Image Copy for z/OS, V3R1,
      User's Guide SC18-7617-00 ( SC18761700 ).
   =====================================================
  
  --------------------------------------------------------------
  2.0 Operating Instructions
   2.3 Input
    2.3.5 ICEIN Keywords
     2.3.5.55 TASKCTL=
    The TASKCTL keyword specifies the maximum number of IC subtask
    in parallel.
    +-----------------------------------------------------------+
    | TASKCTL=nnn                                               |
    +-----------------------------------------------------------+
  
    where:
     nnn
       is the maximum number of IC subtasks in parallel.
  |    The valid value of nnn is 0-254.When the specified
  |    value is '0', it is same meaning of TASKCTL=254.
       When the specified DBDS is HALDB and database is flagged
       as ONLINE REORG CAPABLE in DBRC, HPIC automatically
       determines ACTIVE DBDS and uses a active DBDS ddname as
       input.
  
  --------------------------------------------------------------
  2.0 Operating Instructions
   2.3 Input
    2.3.5 ICEIN Keywords
     2.3.5.23 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-254.When the specified
  |    value is '0', it is same meaning of GRPLIM=254.
  
    +-----------------------------------------------------------+
    | 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.
  

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:

  UK00353

Modules/Macros

•    FABJBRLS FABJBRL7 FABJBRL8 FABJBRL9 FABJDMPN
  FABJDMP7 FABJDMP8 FABJDMP9 FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9
  FABJICDD FABJLINK FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJPARM
  FABJTGEN FABUCHG  H1J0310J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R310 PSY UK00353

     UP05/02/10 P F502

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.