A fix is available
APAR status
Closed as program error.
Error description
This APAR provides preventive fixes for APAR of IMS V7, V8 and V9, and includes forward fits from HPIC V3.2.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 3 Release 2 users ( FMID=H1J0320 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR includes following things: * * - forward fits APAR from ICE V2 and * * HPIC V3R1. * * - ICE V2 * * PQ81261, PQ88918, PQ99627 * * - HPIC V3R1 * * PQ97675, PQ97677, PQ99709, PK04295 * * - corresponding APAR of following IMS * * APARs. * * - IMS V8 * * PQ81021, PQ85642, PQ85797 * * - IMS V9 * * PQ83361, PQ84499, PQ86161, PQ86686, * * PQ90761, PQ90797, PQ94366, PQ96957 * * - some fixes of HPIC V3R2. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR includes following APAR fixes from ICE V2 and HPIC V3R1: PQ81261 (ICE V2) -HPIC Image Copy function that is invoked by FABJMAIN terminates with ABEND U3815 ( ABENDU3815 ) when the I/O error is detected in a RECON data set even other spare RECON data sets are normal. The function is invoked by IMS as is JCL, GET I/O error for spare RECON data set is detected, but image copy ignore it and process normally. PQ88918 (ICE V2) -The Image Copy function of IMS High Performance Image Copy Version 3 Release 2 for z/OS uses invalid Image Copy data set information for stacking data set, then the messages IEC145I ( S413-1C ) and IGF0193A are issued. Because the HPIC internal control block are not protected and it is damaged by IMS modules. By this APAR, HPIC uses different subpool number from IMS for GETMAIN area for protecting internal control block. PQ99627 (ICE V2) -The DEADLOCK may occur on DBRC RECON data sets when an HPIC job of image copy with Multi-Step HASH pointer checking with other IMS utilities' JOB. Because HPIC and HPPC reserve the DBRC RECON data sets by the resource name 'DSPURI01' without request ENQ by the resource name 'DSPURI02'. When HPIC and HPPC find a VSAM OPEN failure for one DBRC RECON data set and abends U3752 ( ABENDU3752 ), IMS BATCH CLEANUP Routine is scheduled and try to ENQ the DBRC RECON data sets by the resource name of 'DSPURI02' for recovery and close the DBRC RECON data sets. But the other IMS utility job already ENQ the DBRC RECON data sets by the resource name of 'DSPURI02' and wait for reserve the resource name of 'DSPURI01'. HPIC and HPPC still reserve the DBRC RECON data sets by the resource name of 'DSPURI01' and wait for ENQ the resource name for 'DSPURI02', then the DEADLOCK may occur. Single-step HASH check process is not necessary for this APAR fix because Single-Step HASH check does not access DBRC RECON data sets. PQ97675 (HPIC V3R1) -This maintenance corresponds to APAR PQ96899 IBM IMS FP Basic Tools Version 1 Release 2 for z/OS. This maintenance changes the internal interface of the HASH check for DEDB. This maintenance is required APAR of APAR PQ96899 IBM IMS FP Basic Tools V1R2 for z/OS. PQ97677 (HPIC V3R1) -This APAR provides following enhancements for HPIC stack option: -Different ddname of secondary IC to the same ddname of primary IC can be used in the Image Copy function. -The specification order of ddname can be changed in the Create Image Copy function. -This APAR fixes following problem: -In the Create Image Copy function, and the Recovery function, HPIC abends S013 ( ABEND013 ) when the record format of input image copy data set is LBI. PQ99709 (HPIC V3R1) -The IMS DBRC interface module abends S378 ( ABEND378 ) RSN14 in HPIC V3R2. The cause of abend is that the HPIC calls several the IMS DBRC interface from different TCBs. PK04295 (HPIC V3R1) -The IMS DBRC interface module of HPIC V3R2 abends S378 ( ABEND378 ) RSN14. The cause of the abend is that both of the maintask of IMS and the subtask of HPIC call the IMS DBRC interface. 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 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 ). This APAR also includes following IMS APARs: PQ81021 (IMS V8) - When EQE encountered for MADS or EEQE encountered for single ADS, Image Copy Utility 2 completed successfully in error. This problem was due to FUNC15 ( CHECK ADS FOR EQE ) only excised the code to close all the ACBs. Routine FUNC15_A did not get call to check the INPUT ADS FOR EQES. PQ85642 (IMS V8) and PQ86161 (IMS V9) - Abend S0C1 occurred during the DBRC EOJ (end of job) call because the variable RCWBCHAN contained zero. PQ85797 (IMS V8) and PQ86686 (IMS V9) - Due to a trap code in module DBFUMDP0's UMDPERR2 routine, CIC for AREA with EQE encounters ABEND S0C1. PQ83361 (IMS V9) - Message MSGDSP1077I may be issued as a WTO rather than being written to SYSPRINT when attempting to image copy an A-J data set when the M-V data sets are active. PQ84499 (IMS V9) - The Abend S0C4 was caused by incorrect addressing mode. This resulted in DFSDOAC0 having an incorrect PST address when calling DFSCBTS to find the DDIR. PQ90761 (IMS V9) - In IMS V9, partition data sets that are OLR capable are dynamically allocated. As a result, the user cannot always correctly specify in the Image Copy JCL the active data set because the user does not know whether the active data set is the A-J or M-V partition. The Image Copy utility dynamically allocates the active data set with DISP=OLD by default to ensure a clean copy. However, the user would like to have the option of specifying DISP=SHR for data sets that are dynamically allocated by the Image Copy utility. PQ90797 (IMS V9) - Message DFS306A DBD xxxxxxxx DOES NOT CONTAIN DDNAME yyyyyyy is missing when the DEDB recovery job failed. PQ94366 (IMS V9) - The DCBE was added in V9. When DFSUDMP0 rounds the blocksize for an LRECL coded in the JCL it only stores it in the DCBBLKSI field of the DCB. It should also store it in the DCBEBLKSI of the DCBE. PQ96957 (IMS V9) - After PQ90761, if the user does not specify disposition of the data set, DFSUDMP0 utility dynamically allocates the data set with DISP=OLD. This APAR also fixes the following problems: - When an I/O error occurs in either of primary or secondary image copy process, HPIC dose not register the information to the DBRC although DBRC=Y is specified. - When the ABEND SD37 ( ABENDD37 ) occurs in the CLOSE macro for output image copy data set, HPIC continues processing and attempt to free output image copy buffer by using FREEPOOL macro, and HPIC abends SA0A ( ABENDA0A ) in the process of the macro. When the same problem occurs in the image copy process under IMS Parallel Reorganization for z/OS Version 3 Release 1, HPIC terminates with the ABEND S30A ( ABEND30A ) in place of the ABEND SA0A ( ABENDA0A ).
Problem conclusion
FABUARCN has been modified following things: - to ENQ the resource name of 'DSPURI02' before reserve the resource name of 'DSPURI01' for RECONs. - to avoid a VSAM OPEN error for the spare RECON if the two other RECONs are available. - to return the valid IMS release level of 'COPY1' DBRC RECON data set. - to avoid a NO RECORD error for spare RECON if the two other RECONs are available. - to continue the process of ENQ and RESERVE ,even if a OBTAIN failure is occurred. - to avoid a GET I/O error for space RECON if the two other RECONs are available. FABJCRC1, FABJRDB9 have been modified to bypass the logic that issues BUILDRCD macro for LBI format data set of the input image copy data set. FABJRDB9 has been modified following things: - to use the second program base register. - to include following IMS fixes: - PQ84499 - PQ90797 FABJDMPN has been modified following things: - to check the level of IMS FP Basic tools. - To call the modules FABJBRL7, FABJBRL8, and FABJBRL9 from the maintask of HPIC when the HPIC module (FABJDPS7, FABJDPS8, FABJDPS9, FABJMDP7, FABJMDP8, or FABJMDP9) requests for the DBRC interface. - To remove DBRC interface call. - To add an ECB for DBRC interface module. - to include the IMS fix PQ85642 (about FABJDMP8). - to include following IMS fixes (about FABJDMP9): - PQ86161 - PQ90761 - PQ96957 FABJDPSN has been modified following things: - the interface for DEDB HASH check of IMS FP Basic tools. - to request FABJBRL7, FABJBRL8, or FABJBRL9 for call DBRC interface call instead of direct calling DBRC interface. - to call the modules FABJBRL7, FABJBRL8, or FABJBRL9 under UCF. - to include the IMS fix PQ83361 (about FABJDPS9). - to add an information about the image copy data sets to the DBRC. When an I/O error occurs during copy execution for two output image copies with DBRC=Y, the HPIC continues to completion on the other copy. FABJMDPN have been modified following things: - to request FABJBRL7, FABJBRL8, or FABJBRL9 for call DBRC interface call instead of direct calling DBRC interface. - to include following IMS fixes (about FABJMDP8): - PQ85797 - PQ81021 - to include the IMS fix PQ86686 (about FABJMDP9). FABJDOPN has been modified to include the IMS fix PQ94366. FABJICDD, FABJPARM, and FABJTGEN have been modified to change max value of GRPLIM to 254 from 255. FABJICDD has been modified to remove the logic that checks the ddname of secondary IC, and specification order of ddname for the stack output data set. The module FABJMSGC has been modified to collect the message text of FABJ3932E ( MSGFABJ3932E ). The following modules have been modified to use specific SUBPOOL No that is not used by IMS in GETMAIN and FREEMAIN, that is for protecting HPIC control block: - FABJDBDN MAC - FABJDBRC MAC - FABJMAIN MOD - FABJPARM MOD - FABJDPUT MOD - FABJINT1 MOD - FABJIPRC MOD - FABJPRM2 MOD FABJINT2 has been modified to change the parameter list of DMPXPARM that the same as FABJDMPN definition. FABJDPSN, FABJDPUT have been modified to add the bypass logic of FREEMAIN macro to be freed output image copy buffer. A new macro FABJBRLS has been build. A new module FABJBRL7, FABJBRL8, and FABJBRL9 for DBRC interface module are provided. Image Copy function of HPIC V3R2 uses new module (FABJBRL7, FABJBRL8, and FABJBRL9) from where DBRC interface is always called. Consequence of that DBRC interface is called one particular TCB in HPIC 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 GRPLIM= is changed to 254 from 255, too. The following modules have been reassembled. FABJARC0 FABJCMDB FABJDBD7 FABJDBD8 FABJDBD9 FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDMP7 FABJDMP8 FABJDMP9 FABJDPS7 FABJDPS8 FABJDPS9 FABJDCTL FABJDREQ FABJDRQS FABJMAS1 FABJMDP7 FABJMDP8 FABJMDP9 FABJNTFC FABJSAS2 FABJTERM FABJUIC1 Documentation Changes: The documentation is modified as follows: ===================================================== IMS High Performance Image Copy for z/OS, V3R2, User's Guide SC18-7617-01 ( SC18761701 ). ===================================================== 2.0 Operating Instructions 2.3 Input 2.3.5 ICEIN Keywords 2.3.5.24 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. +-----------------------------------------------------------+ | GRPLIM=nnn | +-----------------------------------------------------------+ where: nnn is the left-justified maximum number of tasks in the GROUP. | The valid value is a decimal number from 0 through 254. | GRPLIM=0 has the same meaning of GRPLIM=254. The default value is 0.
Temporary fix
Comments
APAR Information
APAR number
PK04224
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
320
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2005-04-14
Closed date
2005-05-27
Last modified date
2005-06-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK03910
Modules/Macros
FABJARC0 FABJBRLS FABJBRL7 FABJBRL8 FABJBRL9 FABJCMDB FABJCRC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDMPN FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJICDD FABJINT1 FABJINT2 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMSGC FABJNTFC FABJPARM FABJPRM2 FABJRDB9 FABJSAS2 FABJTERM FABJTGEN FABJUIC1 FABUARCN FABUITCT H1J0320J
| SC18761701 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R320 PSY UK03910
UP05/06/01 P F505
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.
[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Platform":[{"code":"PF054","label":"z Systems"}],"Version":"320","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020