A fix is available
APAR status
Closed as new function.
Error description
Provide following items: - New WTO messages when the DB is unauthorized and DB can be used from the application - CIC process with FASTIC=(opt,DUMP) supports VIC - VIC option which ingnores HASH check request even if HDPC=Y - Fix report sentence in GLOBAL OPTION REPORT
Local fix
N/A
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 4 Release 1 users ( FMID=H1J0410 ) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides following items: * * 1. New WTO messages when the DB is * * unauthorized and DB can be used * * from application * * 2. New parameter for VIC= * * keyword which ignores HASH check * * request ( HDPC=Y ). * * 3. Fix for the report title in Global * * Options report. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides following items: 1. New WTO messages, FABJ4262I ( MSGFABJ4262I ), FABJ4263I ( MSGFABJ4263I ) and FABJ4264W ( MSGFABJ4264W ) is added to notify users and automation programs that databases have become available from HPIC process. See detail on DOCUMENT CHANGE below. 2. When VIC=Y and HDPC=Y is specified for CIC process with FASTIC=(opt,DUMP), FABJ4243E ( MSGFABJ4243E ) is shown for the index database because HPIC accesses the index database for HASH check, even though some users do not want Hash check for the index database processed as VIC. To solve this problem, for users who do not require Hash check for the index database, second operands of VIC= keyword, ONPC and OFFPC, are added to disable/enable HDPC=Y specification for the index database. 3. In GLOBAL Options report, the column title "ACTIVE SETTING FOR THIS STEP" is ambiguous, so changed as "ACTIVE GLOBAL SETTING FOR THIS STEP".
Problem conclusion
Temporary fix
Comments
FABJBLKD, FABJGLRP, FABJPARM, FABJPRM2, FABJMRGE, FABJSTMD and FABJTGEN have been modified to support the second operand of VIC= keyword. FABJBRLS, FABJDFCN, FABJFCCN, FABJFCDN, FABJMDPN, FABJDSSB and FABJFCBK have been modified to issue the new WTO messages. FABJMAIN and FABJINT1 have been modified to handle as HDPC=N for the index database that is specified as VIC=(Y,OFFPC), even if HDPC=Y is specified. FABJGLRP has been modified to change the title of GLOBAL Options report. The following modules have been reassembled. FABJACQG FABJAPIM FABJASPM FABJATRC FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBDA FABJDBDB FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDBRA FABJDBRB FABJDCTL FABJDDIM FABJDEMP FABJDFC7 FABJDFC8 FABJDFC9 FABJDFCA FABJDFCB FABJDMP0 FABJDMPN FABJDMP7 FABJDMP8 FABJDMP9 FABJDMPA FABJDMPB FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPSA FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCM FABJFCC7 FABJFCC8 FABJFCC9 FABJFCCA FABJFCCB FABJFCD7 FABJFCD8 FABJFCD9 FABJFCDA FABJFCDB FABJGDGB FABJICDD FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJIDXA FABJIDXB FABJINT2 FABJINT3 FABJIPRC FABJMAS1 FABJMDP7 FABJMDP8 FABJMDP9 FABJMDPA FABJMDPB FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJORCA FABJORCB FABJPRM3 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRCHA FABJRCHB FABJRDB7 FABJRDB8 FABJRDB9 FABJRDBA FABJRDBB FABJRETC FABJRETM FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRFCA FABJRFCB FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJTERM FABJTOI FABJUIC1 FABJXCR FABJXHPC FABJXLIM ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 4 Release 1 User's Guide SC18-9409-02 ( SC18940902 ) should be changed as follows: 2.0 What is HP Image Copy? 2.13.4 Image Copy processing notification FABJ4260I COPY PROCESSING COMPLETE FOR DB/AREA P1E 0000 OF 0003 DATASETS FAILED | +FABJ4262I END OF UNAUTHORIZATION PROCESS FOR DBD=P1E FABJ4261I COPIED DB/AREA P1E DDN P1E1 DSN MDOOLEY.HPIC.P1E1 FABJ4261I COPIED DB/AREA P1E DDN P1E2 DSN MDOOLEY.HPIC.P1E2 FABJ4261I COPIED DB/AREA P1E DDN P1E3 DSN MDOOLEY.HPIC.P1E3 | FABJ4263I ALL DATABASES WERE RELEASED FROM HPIC PROCESS | 2.13.6.2 Concurrent copy | In using concurrent copy ( FASTIC=DUMP ) , concurrent image copy processing, that is CIC or ACIC processing, for a VSAM KSDS requires that the data set be SMS-managed and BWO(TYPEIMS) be specified on the AMS DEFINE or ALTER for the data set. This ensures that IMS HP Image Copy can detect CI or CA splits which cause the output image copy to be unusable. | This regulation will not be applied when VIC=Y is specified | and the HASH check is disabled. Please see detail on the | explanation for VIC= keyword. 3.0 Operating instructions 3.4.3.84 VIC= The VIC keyword specifies whether the Image Copy function processes a virtual image copy for the primary and secondary | indexes. And also this specifies whether HASH check is | executed or not for the index database when processing a | virtual image copy. | +---------------------------------------------------------+ | |VIC=Y|N|(Y|N,ONPC|OFFPC) | | +---------------------------------------------------------+ where: Y specifies that the Image Copy function does not create a physical image copy data set for the primary and secondary indexes data set, but registers a dummy image copy data set | name into DBRC as UIC. VIC=Y and HDPC=O are mutually | exclusive. N specifies that the Image Copy function creates a physical image copy data set for primary and secondary indexes. This is the default. | ONPC specifies that HASH check is executed depending on HDPC= | specification. This is the default. | OFFPC specifies that HASH check is not executed for the index | database regardless of HDPC= specification. | Notes: | . The second operand, ONPC or OFFPC, is effective only when Y | is specified in the first operand. If the second operand is | specified in the GLOBAL statement or the site default, and | is not specified in the GROUP/IC/AIC/CIC/ACIC statement, the | value of the second operand is passed on from the GLOBAL | statement or the site default. | . In the case of CIC with FASTIC=(,DUMP), BWO(TYPEIMS) is | required for the index database. If BWO(TYPEIMS) is not | specified, VIC=Y works only if the HASH check is disabled by | HDPC=N or VIC=(Y,OFFPC). Otherwise the process ends with | error, RC=08. 3.6.8 GLOBAL Options report IMS HIGH PERFORMANCE IMAGE COPY "ACTIVE GLOBAL OPTION REPORT" PAGE: 1 ... | KEYWORD DEFAULT ACTIVE GLOBAL SETTING FOR THIS STEP | ----------- -------- ----------------------------------- ... IMS HIGH PERFORMANCE IMAGE COPY "ACTIVE GLOBAL OPTION REPORT" PAGE: 2 ... | KEYWORD DEFAULT ACTIVE GLOBAL SETTING FOR THIS STEP | ----------- -------- ----------------------------------- IMS HIGH PERFORMANCE IMAGE COPY "ACTIVE GLOBAL OPTION REPORT" PAGE: 3 ... | KEYWORD DEFAULT ACTIVE GLOBAL SETTING FOR THIS STEP | ----------- -------- ----------------------------------- ... VIC NO NO | ONPC ONPC 11.0 Working with other IMS tools 11.1 IMS Database Recovery Facility Delete following lines from Table 22. +--------------------------------------------------------+ | VIC | YES | Y or N | N | Specifies whether ... | +--------------------------------------------------------+ | VICDSN | NO | dsname | None | Specifies the name ... | +--------------------------------------------------------+ 11.2 IMS Parallel Reorganization | +--------------------------------------------------------+ | | VIC | YES | YES | Y or N | N | VIC specifies ... | | | | | | or (Y,ONPC) | | | | | | | | or (Y,OFFPC) | | | | | | | | or (N,ONPC) | | | | | | | | or (N,OFFPC) | | | | +--------------------------------------------------------+ 12.0 Reference: Return codes, abend codes, and messages 12.3 Messages 12.3.77 FABJ0180I Explanation: IMS HP Image Copy creates an image copy data set for the KSDS index DB. But it might not be able to use the recovery process as the input image copy data set. If you use | it, the index database cannot be recovered correctly. This | message is not shown when VIC=Y is specified. | 12.3.xxx FABJ4262I | FABJ4262I END OF UNAUTHORIZATION PROCESS FOR | DBD | PART | AREA =name | Explanation: DBD/PART/AREA has become unauthorized from IMS HP | Image Copy. This message only appears in FASTIC=(,DUMP) or | FASTIC=(,COPY) processing and is shown in the console at the | end of logical copy process for each DBD/PART/AREA that is | registered to DBRC. After this message, other programs can be | started for the DBD/PART/AREA. | System Action: Image copy processing continues | Programmer Response: It is safe to restart the | specified database. | 12.3.xxx FABJ4263I | FABJ4263I ALL DATABASES WERE RELEASED FROM HPIC PROCESS | Explanation: All databases for image copy process were | released from IMS HP Image Copy and have become available for | other programs. This message only appears in FASTIC=(,DUMP) or | FASTIC=(,COPY) processing and is shown in the console when the | logical copy process or other unauthorization process for all | databases is finished. For example, if HPIC failed at the | logical copy process and succeeded at the physical copy | process, this message can be issued at the end of physical | copy process. After this message, other programs can be | started for all databases. If some errors are found in image | copy processing, FABJ4264W is shown instead of this message. | Please note that this message does not guarantee the success | of the image copy process. | System Action: Image copy processing continues | Programmer Response: It is safe to restart the | all target databases. | 12.3.xxx FABJ4264W ALL DATABASES WERE RELEASED FROM HPIC | PROCESS, BUT SOME PROCESSES WERE FAILED | Explanation: This message is shown instead of FABJ4263I when | some errors are found in image copy processing. | System Action: Image copy processing continues | Programmer Response: Investigate the error happened prior to | this message. And, if needed, correct the error and rerun the | job.
APAR Information
APAR number
PK80766
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
410
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2009-02-17
Closed date
2009-03-10
Last modified date
2009-04-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK44750
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD FABJBRLA FABJBRLB FABJBRLS FABJBRL7 FABJBRL8 FABJBRL9 FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDB FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRB FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCB FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPB FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSB FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJDSSB FABJFCAI FABJFCBK FABJFCCA FABJFCCB FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCDB FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXB FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA FABJMDPB FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSUL FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCB FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHB FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA FABJRDBB FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCB FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJSTMD FABJTERM FABJTGEN FABJTOI FABJUIC1 FABJXCR FABJXHPC FABJXLIM
| SC18940902 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R410 PSY UK44750
UP09/03/12 P F903
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.1.0","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020