A fix is available
APAR status
Closed as new function.
Error description
HPIC V3 Image Copy function supports Virtual Image Copy of Primary Index data set and Secondary Index data set.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy for z/OS * * Version 3 users (FMID=H1J0310) * **************************************************************** * PROBLEM DESCRIPTION: This APAR provides following new * * functions: * * - The Virtual Image Copy options * * - New symbolic parameter &JDAY2 * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** IMS High Performance Image Copy for z/OS V3 provides following functions: - Virtual Image Copy The Virtual Image Copy is the optional function of Image Copy function. When you specified VIC=Y in the ICEIN control statement, HPIC does not create a physical image copy data set but registers dummy IC data set as UIC into DBRC. * HDPC HASH Check option does not support the secondary index data set. - New Symbolic parameter &JDAY2
Problem conclusion
Temporary fix
Comments
FABJDMPN, FABJDPSN, FABJBLKD, FABJDALO, FABJPRT0, and FABUITCT have been modified to Virtual Image Copy function. FABJPARM, FABJSTMD, and FABJTGEN have been modified to support the new keyword VIC= and VICDSN=, and the new parameter HDPC=O. FABJACQG has been modified to support a new symbolic parameters. A new module FABJUIC1 and FABJCMDB have been added for processing the DBRC NOTIFY.UIC command. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 1 User's Guide SC27-187140-00 ( SC18761700 ) should be changed as follows: Add following restriction for Image Copy function is added. 1.5.2 Restrictions on the Image Copy Function | - The same data set group, DBDS, or AREA can not process | in the same job step. | - Shared secondary indexes that points to same data set | can not process in the same job step. Add new optional keywords and options. 2.3.4.1 GLOBAL Statement The GLOBAL statement contains the following keywords: : | - VIC= | - VICDSN= 2.3.4.2 GROUP Statement Optional keywords: : | VIC= | VICDSN= 2.3.4.3 IC/AIC Statement Optional keywords: : | VIC= | VICDSN= 2.3.5.25 HDPC= keywords The HPDC keyword specifies whether the HPIC Image Copy function invokes the pointer check of the HD Pointer Checker utility, or not. This keyword is valid when the executing function is a batch image copy. +--------------------------------------------------------+ | | HDPC=Y|O|N|(Y|O,HISTORY,BITMAP,FSEMAP,MAXFSD) | +--------------------------------------------------------+ where: Y invokes the HDPC HASH pointer check during the execution of the HDPC Image Copy function. If HDPC=Y is specified for the database not applicable to the HD Pointer Checker HASH Check function, an image copy of the database is taken but no pointer checking is processed. | O invokes the HDPC HASH pointer check, but output image | copy is not created and notified as UIC for primary | index data set. If the HDPC=O is specified for other | than primary index data set, Image Copy function | runs the same process of HDPC=Y. N does not invoke the HDPC HASH pointer check during the execution of the HPIC Image Copy function. this is the default. 2.3.5.nn VIC= | VIC= | The VIC keyword specifies whether the HPIC Image Copy | function processes a virtual image copy for the primary | and secondary indexes, or not. | +---------------------------------------------------+ | | VIC=Y|N | | +---------------------------------------------------+ | where: | Y specifies that Image Copy functions does not create | physical image copy data set for the primary and | secondary indexes data set, but registers dummy image | copy data set name into DBRC as UIC. | N specified that Image Copy function creates physical image copy data set for primary and secondary indexes. This is the default. | This keyword can be used in the following control statements: | GLOBAL,GROUP,IC,AIC,CIC,ACIC 2.3.5.nn VICDSN= | VICDSN= | The VICDSN keyword specifies the dummy data set name that | is used for being registered into DBRC as UIC data set name | of the virtual image copy. | +---------------------------------------------------+ | | VICDSN=dummy data set name | | +---------------------------------------------------+ | where: | dummy data set name | specifies dummy data set name that is registered into | DBRC as the data set name for NOTIRY.UIC command of | Virtual Image Copy process. | The dummy data set name must be less than | 45 characters. | This keyword can be used in the following control statements: | GLOBAL Add a new symbolic parameters: 6.3.2.2 Symbolic Parameters | &JDAY2 The last two digits of the Julian date (dd) Following new messages are added: Appendix A.3 Messages | FABJ0173E VIC=Y AND HDPC=O ARE MUTUALLY EXCLUSIVE | Explanation: Both the VIC=Y and the HDPC=O parameter are | specified in a control statement, but they are mutually | exclusive. | System Action: FABJMAIN stops processing with a return code | of 16. | Programmer Response: Remove the unused parameter, and rerun | the job. | FABJ0174I VIRTUAL IMAGE COPY PROCESS IS APPLIED | Explanation: The virtual image copy process is applied for | primary and secondary indexes database. | System Action: None | Programmer Response: None | FABJ0175I HD POINTER CHECKER IS PROCESSED WITHOUT CREATING | OUTPUT IMAGE COPY | Explanation: HDPC HASH CHECK is done without creating output | image copy for primary index database. | System Action: None | Programmer Response: None | FABJ0176I VIRTUAL IMAGE COPY PROCESS IS NOTIFYING DUMMY DATA | SET NAME TO DBRC DBD=& DDN=& | Explanation: Virtual image copy process notifies a dummy | data set name as UIC into DBRC. | System Action: None | Programmer Response: None | FABJ0177E NOTIFY.UIC PROCESS FAILED DBD=$ DDN=$ | Explanation: NOTIFY.UIC process is failed. Dummy data set | name is not registered in DBRC. | System Action: Image Copy function terminates with a return | code of 08. | Programmer Response: Check the DBD and DD name and rerun the | job.
APAR Information
APAR number
PQ84456
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
310
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2004-02-10
Closed date
2004-02-25
Last modified date
2004-03-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UQ85508
Modules/Macros
FABJACQG FABJBLKD FABJCALL FABJCMDB FABJCRC0 FABJCRC1 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJICDD FABJLINK FABJMAIN FABJMDP7 FABJMDP8 FABJMRGE FABJMSGC FABJORCN FABJORC7 FABJORC8 FABJPARM FABJRCHK FABJRCH7 FABJRCH8 FABJRPT0 FABJSTMD FABJTGEN FABJUIC1 FABJXLIM FABUITCT H1J0310J
SC18761700 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R310 PSY UQ85508
UP04/02/27 P F402
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":"310","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 July 2020