A fix is available
APAR status
Closed as new function.
Error description
This APAR provides 2nd IC capability for the Fast Recovery IC format of Advanced Image Copy function. You can choose the format of the 2nd IC from one of following format: - Fast Recovery IC format - Compressed IC format - IMS AsIs IC format
Local fix
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 * * - Capabilities of the secondary image * * copy for the Fast Recovery image * * copy format of Advanced Image Copy * * function. * * - A new optional keyword IXKEYCHK=. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides - Capabilities of the secondary image copy for the Fast Recovery image copy format of Advanced Image Copy function. - A new optional keyword IXKEYCHK= which is supported in order to specify whether Index key HASH check is performed or not in the single-step HASH check. This APAR also includes fixes for following problems: - When the TIMESTMP=LASTICALL and a input IC data set is SMSOFFLC with IMS V10, Recovery function terminates with message FABJ3818E and ABEND U3818 ( ABENDU3818 ). - When VIC=Y and VICDSN= is specified in Create Image Copy function, HPIC uses the value of VICDSN= as the data set name for output IC data set. - If the CRCTYPE=P is specified in the Create Image Copy function and an output data set has been already cataloged, HPIC terminates with ABEND S0C1 ( ABEND0C1 ). - CIC of HPIC IC function does not set timestamp in the IC header record if the input DB is HALDB which is generated IMS V7. - If the input IC created FASTIC=(,DUMP) and data set is compressed by IDRC, HPIC terminates with RC=08 and message DFS2804A ( MSGDFS2804A ). - After applying APAR PK53858, - HPIC Image Copy function terminate with ABEND S0C4 ( ABEND0C4 ) at FOICMAP0 + X'1DD4', when TOIAUTO=Y specified in the ICEIN control statement using the Advanced Copy Services. - HPIC Image Copy function fails /START DB command with message FABJ4607E ( MSGFABJ4607E ), when TOIAUTO=(Y,,DBD) specified in the ICEIN control statement using the Advanced Copy Services. +--------------------------------------------------------------+ |The IXKEYCHK= keyword is effective when you apply APAR | |PK57593 to IMS High Performance Pointer Checker for z/OS | |Version 2 Release 2 ( FMID=HPC2220 ). | +--------------------------------------------------------------+
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 4 Release 1 User's Guide SC18-9409 ( SC189409 ) should be changed as follows: 3 Operating instructions 3.4.2.1 GLOBAL statements The GLOBAL statement contains the following keywords: | . IXKEYCHK= | . OFFLDSTACK= | . OFFLDTYPE= 3.4.2.2 GROUP statements The GROUP statement contains the following keywords: | . OFFLDSTACK= | . OFFLDTYPE= 3.4.2.3 IC/AIC statements The IC/AIC statement contains the following keywords: | . OFFLDSTACK= | . OFFLDTYPE= 3.4.2.4 CIC/ACIC statements The CIC/ACIC statement contains the following keywords: | . OFFLDSTACK= | . OFFLDTYPE= 3.4.3 Option parameters 3.4.3.7 CRCTYPE= where: L specifies that a logical copy of an input data set. The logical copy can create the data set whose compression routine is different from that of the input data set. | If the input data set is the Fast Recovery image copy | format, the logical copy changes a format to Standard HPIC | Format image copy. | When format changes from the Fast Recovery image copy to | Standard HPIC Format image copy, CRCTYPE=L and DBRC=Y are | required and image copy data set is registered into DBRC. 3.4.3.33 GRPLIM= +-----------------------------------------------------------+ | | GRPLIM=nnn|(nnn,mmm)|(,mmm) | +-----------------------------------------------------------+ where: nnn : | mmm is the left-justified maximum number of tasks in the GROUP | for the Offload Copy process. The valid value of mmm is | 0-64. When the specified value is 0 , it means | GRPLIM=(,64). The default value is 0. 3.4.3.46 ICOUT= The ICOUT keyword specifies the DD name of the output image copy data set. For the Image Copy function: +-----------------------------------------------------------+ | | ICOUT=ddname1|(ddname1,ddname2)|(ddname1,*)|(*,ddname2)| | | | *|(*,*)|(ddname1,%STACK)|(*,%STACK) | +-----------------------------------------------------------+ | Note: The %STACK parameter is effective when the following | keywords are specified together. | . FASTIC=(,COPY) | . OFFLDTYPE=S | . OFFLDSTACK=* or OFFLDSTACK=ddname | 3.4.3.xx IXKEYCHK= | The IXKEYCHK keyword specifies whether the HPIC Image Copy | function invokes the Index key HASH check of the HP Pointer | Checker utility. This keyword is valid when HDPC=Y is | specified. | +-----------------------------------------------------------+ | | IXKEYCHK=Y|N | | +-----------------------------------------------------------+ | where: | Y specifies that Index key HASH check of HD Pointer Checker | utility is performed. | N specifies that Index key HASH check of HD Pointer Checker | utility is not performed. This is the default. | | The keyword is supported in the single-step HASH check. | | This keyword can be used in the following control statements: | GLOBAL | | This keyword can be defined in the site default table. | 3.4.3.xx OFFLDSTACK= | The OFFLDSTACK keyword specifies the ddname of the output | stacks created as secondary image copy of FASTIC=(,COPY) using | the Advanced Copy Services feature. | +-----------------------------------------------------------+ | | OFFLDSTACK=ddname|* | | +-----------------------------------------------------------+ | where: | ddname is the DD name of the secondary output image copy. | * is the DD name of the secondary output image copy, | which is determined internally. This is the default. | | Note: The OFFLDSTACK keyword is effective when the following | keywords are specified together. | . FASTIC=(,COPY) | . OFFLDTYPE=S | . ICOUT= that specified %STACK on 2nd parameter | | This keyword can be used in the following control statements: | GLOBAL, GROUP, IC, CIC, AIC, ACIC | | This keyword can be defined in the site default table. | 3.4.3.xx OFFLDTYPE= | The OFFLDTYPE keyword specifies the type of image copy data | set created as secondary image copy of FASTIC=(,COPY) using | the Advanced Copy Services feature. | +-----------------------------------------------------------+ | | OFFLDTYPE=N|S|F | | +-----------------------------------------------------------+ | where: | N specifies that the secondary image copy data set does not | create. This is the default. | S specifies that the secondary image copy data set is created | as Standard HPIC Format image copy. | F specifies that the secondary image copy data set is created | as Fast Recovery image copy. | | Note: The OFFLDTYPE keyword is effective when the following | keywords are specified together. | . FASTIC=(,COPY) | . ICOUT= that specified 2nd parameter | | This keyword can be used in the following control statements: | GLOBAL, GROUP, IC, CIC, AIC, ACIC | | This keyword can be defined in the site default table. 3.4.3.68 TASKCTL= +-----------------------------------------------------------+ | | TASKCTL=nnn|(nnn,mmm)|(,mmm) | +-----------------------------------------------------------+ where: nnn : | mmm is the maximum number of Offload Copy subtasks that can | run in parallel. The valid value of mmm is from 0 to 64. | When the specified value is 0, it means TASKCTL=(,64). 3.4.3.72 TOIAUTO= +-----------------------------------------------------------+ | | TOIAUTO=Y|N|O|(Y|O,EVERY|LAST|NO,DBR|DBD,FIRST|SECOND) | +-----------------------------------------------------------+ where: : DBD : | FIRST indicates that the database is to be started after | primary image copy process ended. This is the default. | SECOND indicates that the database is to be started after | secondary image copy process ended. | | Note: The FIRST and SECOND parameter is effective when the | following keywords are specified together. | . FASTIC=(,COPY) | . OFFLDTYPE=S or OFFLDTYPE=F | . ICOUT= that specified 2nd parameter 4 Site Default Generation utility 4.2.2 Input The keywords for the Site Default Generation utility are as follows: . ITKBSRVR= | . IXKEYCHK= . LOGUSE= : . NOTIFY= | . OFFLDSTACK= | . OFFLDTYPE= . RESTART= A.0 Appendix A. Return codes, abend codes, and messages A.3 Messages The following messages are added. | FABJ0199E nnnnnnnn AND nnnnnnnn ARE MUTUALLY EXCLUSIVE | Explanation: Both the parameters are specified in a control | statement, but they are mutually exclusive. | System Action: HPIC stops processing with a return code of 16. | Programmer Response: Remove the unused parameter, and rerun | the job. | FABJ0301E FORMAT OF IMAGE COPY DATA SET IS NOT SUPPORTED FOR | HPIC RECOVERY FUNCTION USING THE IMS-COMPATIBLE JCL | Explanation: The format of the input IC data for Recovery | function in the IMS-COMPATIBLE JCL is identified the standard | or compressed Image Copy format, but the data set is | registered as the Fast Recovery image copy format. | System Action: The recovery process fails. | Programmer Response: Rerun the Recovery function by FABJMAIN | JCL, or correct IC type flag in DBRC to the appropriate type. | FABJ4218I CHANGE.IC SUCCESSFUL | Explanation: The CHANGE.IC command for the specified database | was successful. | System Action: The FASTIC offload copy is registered as the | secondary image copy in the RECON data set. | Programmer Response: None. | FABJ4251I OFFLOAD COPY BEGIN FOR DBD dbdname DDN/AREA ddname | DSN data set name | Explanation: FASTIC offload copy processing is beginning for | the specified database data set. | System Action: Processing of the FASTIC offload copy | continues. | Programmer Response: None. | FABJ4252I OFFLOAD COPY COMPLETE FOR DBD dbdname DDN/AREA | ddname DSN data set name | Explanation: During FASTIC offload copy processing, Fast | Recovery image copy was copied for the specified database | data set. The format of the FASTIC offload copy is whether | standard image copy format or Fast Recovery image copy format. | System Action: Processing of the image copy continues. | Programmer Response: None. | FABJ4253E OFFLOAD COPY FAILED FOR DBD dbdname DDN/AREA ddname | DSN data set name | Explanation: FASTIC offload copy processing has failed for the | specified database data set. | System Action: The image copy process fails. | Programmer Response: Correct the error, and rerun the job. | FABJ4254E CHANGE.IC FAILED | Explanation: The CHANGE.IC command for the specified database | has failed. | System Action: The image copy process fails. | Programmer Response: Correct the error, and rerun the job. The following messages are modified. | FABJ4217I NOTIFY.IC SUCCESSFUL FOR DBD dbdname DDN/AREA ddname | FABJ4233I PHYSICAL COPY COMPLETE FOR DBD dbdname DDN/AREA | ddname DSN data set name | FABJ4235I FASTREP COPY COMPLETE FOR DBD dbdname DDN/AREA | ddname DSN data set name | FABJ4237I LOGICAL COPY COMPLETE FOR DBD dbdname DDN/AREA | ddname DSN data set name | FABJ4239I PHYSICAL COPY BEGIN FOR DBD dbdname DDN/AREA ddname | DSN data set name
APAR Information
APAR number
PK57985
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
2007-12-11
Closed date
2007-12-27
Last modified date
2008-01-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK32646
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD FABJCMDB FABJCP4S FABJCP40 FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBAL FABJDBCM FABJDBC1 FABJDBDA FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRA FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCA FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPA FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSA FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCBK FABJFCCA FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPA FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGC FABJMSGP FABJMSGS FABJNTFC FABJNTFI FABJNTFS FABJOFDD FABJOFL0 FABJOFL1 FABJORCA FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHA FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDBA FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCA FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0 FABJRPT1 FABJSAS1 FABJSAS2 FABJSTA FABJSTMD FABJTERM FABJTGEN FABJTMTD FABJTOI FABJUIC1 FABJXCR FABJXHPC FABJXLIM FABUITCT H1J0410J
| SC18940900 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R410 PSY UK32646
UP07/12/29 P F712
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