A fix is available
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 number
PQ99709
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
310
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-01-19
Closed date
2005-02-07
Last modified date
2005-03-01
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
SC18761700 |
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89E","label":"IMS HP Image Copy"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"310"}]
Document Information
Modified date:
14 December 2020