A fix is available
APAR status
Closed as new function.
Error description
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 4 Release 2 users ( FMID=H1J0420 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR includes following APARs of * * IMS HP Image Copy V4R1: * * * * PM10875 * * This APAR is a follow-on of PK95360, * * ORF ICEIN support. You also need * * PM17075 of IMS Online Reorganization * * Facility and PM14914 of IMS HP Pointer * * Checker to make this APAR code * * effective. * * * * PM15125 * * This APAR provides a new keyword * * SHDW_ERROR=. * * * * PM19163 * * After applying APAR PM10875, HP Image * * Copy under ORF terminates with message * * FABJ3952E ( MSGFABJ3952E ) and ABEND * * U3952 ( ABENDU3952 ), if processing * * PHIDAM database. * * * * This APAR also corrects following * * problems of HP Image Copy: * * - HP Image Copy terminates with ABEND * * S0C4 ( ABEND0C4 ) at FABJMAIN CSECT * * FABJPARM + X'33DE' when the keyword * * USER= is specified in ICEIN DD. * * - HP Image Copy terminates with ABEND * * S0C4 ( ABEND0C4 ) at FABJMAIN CSECT * * FABJMAIN + X'48A6' when the control * * statement error is detected * * in ICEIN DD. * * - HP Image Copy terminates with ABEND * * S0C4 ( ABEND0C4 ) at FABJMAIN CSECT * * FABJPARM + X'2472' when all of the * * following conditions are satisfied: * * - The control statement error is * * detected in GLOBAL statement of * * ICEIN DD * * - The site default table is used * * - HDPC= or DEDBPC= keyword is * * specified in ICEIN DD. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR is a forward fit for PM10875 and PM15125 of HP Image Copy V4R1. PM10875 With this APAR, following changes were made to HP Image Copy when it runs under ORF: - Ignore some HPIC keywords and keyword operands which should not be effective under ORF. The detailed keyword information supported by ORF will be provided in the updates of HPIC V4R2 user guide released separately. - Ignore ICEIN statements which specify the databases that are not related to ORF processing. - Remove the requirement for DBRC=Y|N specification in ICEIN DD depending on the type of the target database. So, ORF user doesn't have to specify DBRC=Y|N in ICEIN DD. - Make IC or AIC statement specification optional. If omitted, image copy is created based on the default setting of HPIC Image Copy, setting of ICEIN GLOBAL statement, and setting of the site default table of HP Image Copy. - Have pointer check capability for the index databases when ORF processes no recoverable index databases. Prior to this APAR, user got FABP4006W message in the condition above because index databases are not pointer checked. Now, they are pointer checked, so that user will not have the message. Please note following items when using HP Image Copy under ORF: - You need to specify ICEIN(ddname) keyword in HRFSYSIN DD of ORF to make ICEIN keyword specification effective. - Some HRFSYSIN keywords can not be specified if you specify ICEIN keywords. If you specify following HRFSYSIN keywords, you need to remove them from HRFSYSIN DD and specify equivalent ICEIN keywords in ICEIN DD. HRFSYSIN keywords unavailable and equivalent ICEIN keywords are: +-----------------+-----------------+ | HRFSYSIN | ICEIN | | Keywords | Keywords | +-----------------+-----------------+ | IC.VIC | VIC | | IC.VICDSN | VICDSN | | PTRCHECK | HDPC | | IC1DSN | DSN | | IC2DSN | DSN2 | | ICNUM | ICOUT | | ICDYN | ICDALLOC | | ICHLQ | ICHLQ, ICHLQ2 | | ICMID | DSN | | ICID | DSN | | ICTRLR | &GDG in DSN | | ICVOLCT | VOLCNT | | IC.COMP | COMP | | IC.COMPRTN | COMPRTN | | ICDDN | ICOUT | +-----------------+-----------------+ - Following ICEIN keywords are effective under ORF. The other keywords are ignored when specified. COMP, COMPRTN, DATACLAS, DATACLAS2, DBBUF, DBD, DDN, DSN, DSN2, EXPDT, EXPDT2, GDGBASE, GDGLIMIT, HDPC, HPIO, ICBUF, ICCAT, ICDALLOC, ICHLQ, ICHLQ2, ICNMRULE, ICOUT, ITKBLOAD, ITKBSRVR, IXKEYCHK, MGMTCLAS, MGMTCLAS2, MSGFREQ, PART, RETPD, RETPD2, SPACE, SPMN, STACK, STACKBASE, STORCLAS, STORCLAS2, TASKCTL, THRESHOLDS, T2CHK, UNIT, UNIT2, USER, VIC, VICDSN, VOLCNT, VOLSER, VOLSER2, WAITALOC, WAITMSG, WAITTIME, and ZIIPMODE For more detail, please refer the updates of HPIC V4R2 user guide that will be available later at the web site of IBM IMS Tools Product publications. +-------------------------------------------------------------+ |APAR PM17075 is required to be applied to IMS Online | |Reorganization Facility for z/OS Version 1 Release 2 | |( FMID=H2A7120 ). | +-------------------------------------------------------------+ +-------------------------------------------------------------+ |APAR PM14914 is required to be applied to IMS High | |Performance Pointer Checker for z/OS Version 3 Release 1 | |( FMID=HPC2310 ). | +-------------------------------------------------------------+ PM15125 This APAR provides a new keyword SHDW_ERROR=. The new keyword SHDW_ERROR= is supported in order to specify whether the Image Copy processing is continued or stopped when the process of creating the shadow data set is failed. PM19163 After applying APAR PM10875, HP Image Copy under ORF terminates with message FABJ3952E ( MSGFABJ3952E ) and ABEND U3952 ( ABENDU3952 ), if processing PHIDAM database. By APAR PM10875, HP Image Copy receives the list of database data sets from ORF and decides the database data sets to be processed by matching that list and the ICEIN control statement if it is specified. In this process, although HP Image Copy can not process the primary index of PHIDAM, HP Image Copy misjudges that it can be processed and continues to process it. Then HP Image Copy terminates with ABEND. This APAR also corrects following problems of HP Image Copy: - HP Image Copy terminates with ABEND S0C4 ( ABEND0C4 ) at FABJMAIN CSECT FABJPARM + X'33DE' when the keyword USER= is specified in ICEIN DD. The cause of the problem is that HP Image Copy references the storage that has not been obtained because HP Image Copy clears the obtained storage using the incorrect length. - HP Image Copy terminates with ABEND S0C4 ( ABEND0C4 ) at FABJMAIN CSECT FABJMAIN + X'48A6' when the control statement error is detected in ICEIN DD. The cause of the problem is that HP Image Copy misjudges that the IMS Tools KB server is active. Then HP Image Copy tries to store HP Image Copy reports and refers the storage that is not accessible. - HP Image Copy terminates with ABEND S0C4 ( ABEND0C4 ) at FABJMAIN CSECT FABJPARM + X'2472' when all of the following conditions are satisfied: - The control statement error is detected in GLOBAL statement of ICEIN DD. - The site default table is used - HDPC= or DEDBPC= keyword is specified in ICEIN DD. When the GLOBAL statement error is occurred in ICEIN DD, a garbage remains on storage. This garbage trigger an endless loop, buffer overrun and a program interruption.
Problem conclusion
Temporary fix
Comments
Following modules and macros are modified for this APAR: The following modules and macros have been modified. FABJBLKD FABJDFCN FABJDMPN FABJDSSB FABJFDMP FABJGLRP FABJLINK FABJMAIN FABJNTFI FABJORFD FABJPARM FABJPRM2 FABJPRM3 FABJSTMD FABJTGEN FABUITCT H1J0420J The following modules have been reassembled. FABJACQG FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBDN FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBRC FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCB FABJDFC9 FABJDMPA FABJDMPB FABJDMP0 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPSN FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC9 FABJFCDA FABJFCDB FABJFCDN FABJFCD9 FABJGDGB FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAS1 FABJMDPA FABJMDPB FABJMDPN FABJMDP9 FABJMRGE FABJMSGP FABJMSUL FABJNTFC FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORCN FABJORC9 FABJRCHA FABJRCHB FABJRCHK FABJRCH9 FABJRDBA FABJRDBB FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJTERM FABJTOI FABJTOI2 FABJUIC1 FABJXCR FABJXHPC FABJXLIM ======================== = DOCUMENTATION CHANGE = ======================== Documentation Change for the new function is available in the Update document of IMS High Performance Image Copy for z/OS Version 4 Release 2 User's Guide SC19-2756-00 ( SC19275600 ) on http://www.ibm.com/software/data/db2imstools/library.html. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 4 Release 2 User's Guide SC19-2756-00 ( SC19275600 ) should be changed as follows: 3.0 Running IMS HP Image Copy IMS HP Image Copy JCL statements ICEIN control statement keywords | SHDW_ERROR keyword |SHDW_ERROR keyword | | The SHDW_ERROR keyword specifies whether the Image Copy | processing is continued or stopped when the process of | creating the shadow data set is failed. | |Format: | ____________________________________________________ | | | | | SHDW_ERROR=CONT|STOP | | |____________________________________________________| | | where | | CONT | specifies that the Image Copy processing is continued when | the process of creating the shadow data set is failed. CONT | is the default. | | STOP | specifies that the Image Copy processing is stopped when | the process of creating the shadow data set is failed. | | This keyword is effective when FASTIC=(opt,FDUMP) is specified | only. | | This keyword can be used in the following control statements: | -GLOBAL | | This keyword can be defined in the site default table. | 6.0 Troubleshooting Messages and codes Messages | FABJ4213E THE PROCESS OF CREATING SHADOW DATA SET IS FAILED. | NO IC DATA SET IS CREATED. | | Explanation: The shadow data set create process failed. HPIC | terminates without creating an image copy from the shadow data | set. | System action: IMS HP Image Copy stops processing. | Programmer Response: Contact IBM Software Support, and provide | the RC and RSN found in the message | FABJ4219I HPIC RECEIVED RC=4 FROM DFSMSDSS API. HPIC CONTINUES | PROCESSING. | | Explanation: HPIC received RC=4 from DFSMSdss API and | confirmed physical copy completed. | System action: IMS HP Image Copy continues processing. | Programmer response: Check DFSMSdss message and RC. Correct | the job and rerun the job if you need.
APAR Information
APAR number
PM18830
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
420
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2010-07-21
Closed date
2010-08-10
Last modified date
2010-09-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK59566
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBDN FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBRC FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCB FABJDFCN FABJDFC9 FABJDMPA FABJDMPB FABJDMPN FABJDMP0 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPSN FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJDSSB FABJFCAI FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC9 FABJFCDA FABJFCDB FABJFCDN FABJFCD9 FABJFDMP FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPA FABJMDPB FABJMDPN FABJMDP9 FABJMRGE FABJMSGP FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORCN FABJORC9 FABJORFD FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCHK FABJRCH9 FABJRDBA FABJRDBB FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJSTMD FABJTERM FABJTGEN FABJTOI FABJTOI2 FABJUIC1 FABJXCR FABJXHPC FABJXLIM FABUITCT H1J0420J
| SC19275600 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R420 PSY UK59566
UP10/08/11 P F008
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":"4.2.0","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020