A fix is available
APAR status
Closed as new function.
Error description
This APAR provides some new function of HPIC Image Copy function and Create Image Copy function.
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: * * 1. Enhancement of the NOTIFY IC of the * * Create Image Copy function. * * 2. Ease of the restrictions on the * * NOTIFY=Y of the Create Image Copy * * function ONLY when the input image * * copy data set is NOT dynamically * * allocated. * * 3. The new keyword TOITIME=. * * * * This APAR also includes fixes for * * following problems: * * 1. HPIC Create Image Copy function * * terminates with ABEND S0C1 * * ( ABEND0C1 ) when all of the * * following conditions are satisfied: * * - The input image copy was compressed * * by IDRC. * * - CRCTYPE=L is specified in the ICEIN * * control statement. * * 2. HPIC Image Copy function terminates * * with RC=08 and message FABJ4605E * * ( MSGFABJ4605E ) when all of the * * following conditions are satisfied: * * - TOIAUTO=Y or TOIAUTO=O is specified * * in the ICEIN control statement. * * - HPIC image copy process is performed * * to the database which is authorized * * by IMS of XRF environment. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides: 1. Enhancement of the NOTIFY IC of the Create Image Copy function. When the type of the input image copy data set is disagree with the DBRC record, HPIC changes the type of the DBRC record into the correct one. 2. Ease of the restrictions on the NOTIFY=Y of the Create Image Copy function ONLY when the input image copy data set is NOT dynamically allocated. The eased restrictions are as follows. - Even if the input image copy data set is specified in JCL, the keyword NOTIFY=Y is not ignored. - Only when the type of the input image copy data set is the BATCH image copy, HPIC issues NOTIFY.IC command to registers the input image copy data set as the primary image copy data set and registers the primary output data set as the secondary image copy data set to RECON. The condition is that the input image copy is not registered in RECON. - Even if both the primary and the secondary image copy data sets are flagged as an error in RECON, the keyword NOTIFY=Y is not ignored. - Even if the only primary image copy data set is registered in RECON and flagged as an error in RECON, the keyword NOTIFY=Y is not ignored. 3. The new keyword TOITIME=. By using this keyword, user can specify the response timeout value of the IMS Tools Online System Interface. Also, this keyword is used to specify the interval time of issuing /DIS AREA command. This APAR also includes fixes for following problems: 1. HPIC Create Image Copy function terminates with ABEND S0C1 ( ABEND0C1 ) when all of the following conditions are satisfied: - The input image copy was compressed by IDRC. - CRCTYPE=L is specified in the ICEIN control statement. 2. HPIC Image Copy function terminates with RC=08 and message FABJ4605E ( MSGFABJ4605E ) when all of the following conditions are satisfied: - TOIAUTO=Y or TOIAUTO=O is specified in the ICEIN control statement. - HPIC image copy process is performed to the database which is authorized by IMS of XRF environment. The cause of this problem is mishandling of SSID of DBRC SSYS record. HPIC uses SSID to check whether a TOSI server is active in an IMS subsystem which authorizes a DB. HPIC does not consider that SSID is set by RSENAME if an IMS subsystem resides in XRF environment. Therefore HPIC misjudges that TOSI server is not active in the IMS subsystem. HPIC should issue /DIS HSB command to the IMS subsystem to get RSENAME and check whether TOSI server is active or not correctly.
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: | 1.1.3.2 NOTIFY.IC/CHANGE.IC for Missing IC Record | The Create Image Copy function issues the NOTIFY.IC or | CHANGE.IC command for an output image copy data set in either | of three conditions: | - If only the primary image copy data set is registered in | RECON as an available IC record, the Create Image Copy | function issues NOTIFY.IC or CHANGE.IC for the first output | data set and registers it to RECON as the secondary image | copy data set. | - If either the primary image copy data set or the secondary | image copy data set is flagged as an error in a RECON data | set, the Create Image Copy function issues NOTIFY.IC or | CHANGE.IC record for the first output data set and registers | it to RECON instead of the erroneous IC record. | - If the type of the input image copy data set is disagree | with the DBRC record, the Create Image Copy function issues | DELETE.IC and NOTIFY.IC commands for both the input image | copy data set and the primary output image copy data set. | By these commands, the primary output image copy data set is | registered to RECON and the type of the image copy data set | is changed into the correct type consistent with the input | image copy data set and the registered record in RECON. | These commands are available ONLY for the BATCH image copy | and the CONCURRENT image copy. | You can request this function by using the following keyword | parameter: NOTIFY=Y (see "NOTIFY=" in topic 2.3.5.44) 3 Operating instructions 3.4.2.1 GLOBAL statements The GLOBAL statement contains the following keywords: . TOIAUTO= | . TOITIME= . TOIXCFGR= 3.4.3 Option parameters Table 6. ICEIN keywords +-----------+-----------+-+------------------------+---------+ | |Parameters |S| | | | +-+-+-+-+-+-+i| | | | |G|G|A|A|C|R|t| | | | Keyword |L|R|I|C|R|C|e| Meaning | Related | | |O|O|C|I|C|V| | | keyword | | |B|U|/|C| | |d| | | | |A|P|I|/| | |e| | | | |L| |C|C| | |f| | | | | | | |I| | |a| | | | | | | |C| | |u| | | | | | | | | | |l| | | | | | | | | | |t| | | +-----------+-+-+-+-+-+-+-+------------------------+---------+ : : : : | +-----------+-+-+-+-+-+-+-+------------------------+---------+ | |TOITIME= |O| | | | | |O|Specifies the time value|TOIAUTO= | | | | | | | | | | |that is used to retrieve| | | | | | | | | | | |the response from the | | | | | | | | | | | |IMS Tools Online System | | | | | | | | | | | |Interface. | | | +-----------+-+-+-+-+-+-+-+------------------------+---------+ | 3.4.3.XX TOITIME= | The TOITIME keyword specifies the time value that is used to | retrieve the response from the IMS Tools Online System | Interface. | | +---------------------------------------------------------+ | | TOITIME=mmmm|(mmmm,nnnn)|(,nnnn) | | +---------------------------------------------------------+ | | where: | mmmm specifies, in seconds, the maximum allowable time until | HPIC detects the stop of database. The valid value is 1 | through 9999. The default value is 180. | | nnnn specifies, in milliseconds, the time interval for /DIS | AREA that is used to check whether the DEDB area has been | stopped or not. The valid value is 1 through 9999. The default | value is 100 that means 0.1 seconds. | | Note: The specified time for the 1st operand must be equal or | longer than that of the 2nd operand. For example, if you | specify TOITIME=(1,nnnn), you can specify 1 through 1000 to | the 2nd operand. | | This keyword can be used in the following control statements: | GLOBAL | | This keyword can be defined in the site default table. 4 Site Default Generation utility 4.2.2 Input The keywords for the Site Default Generation utility are as follows: . TOIAUTO= | . TOITIME= . TOIXCFGR= 10.2 NOTIFY IC | The Create Image Copy function issues the NOTIFY.IC or | CHANGE.IC command for the primary output data set when both | NOTIFY=Y and DBRC=Y are specified in the ICEIN control | statement. | The Create Image Copy function issues the NOTIFY.IC or | CHANGE.IC command. This command registers the primary output | image copy data set to RECON in one of the following | conditions: | - When the only primary image copy data set is registered in | RECON as an available IC record, the Create Image Copy | function issues CHANGE.IC for the primary output data set | and registers it to RECON as the secondary image copy data | set. | - When either the primary image copy data set or the secondary | image copy data set is flagged as an error in the RECON data | set, the Create Image Copy function issues CHANGE.IC for the | primary output data set and registers it to RECON rather | than to the error IC record. | - When the image copy data set that has the same runtime and | the same type of the input image copy data set is not | registered in RECON, the Create Image Copy function issues | NOTIFY.IC command for the input and the primary output image | copy data set to register the input image copy data set as | the primary image copy data set and register the primary | output data set as the secondary image copy data set to | RECON. | This NOTIFY IC is available ONLY for the BATCH image copy. |Note: When both the primary and the image copy data sets are | normally registered in RECON, the CHANGE.IC command is | not issued. : 10.2.1 Restrictions | In one of the following conditions, the HPIC Create Image Copy | function ignores NOTIFY=Y: | - When both the primary and the secondary image copy data sets | are registered normally in RECON. | - When neither the primary nor the secondary image copy data | set is registered in RECON and the type of the input image | copy data set is one of the following: | - Concurrent image copy | - Fast Recovery image copy | - IC2 image copy | - Online image copy | - When both the primary and the secondary image copy data sets | are flagged as an error in RECON and the input image copy | data set is not specified in JCL. A.0 Appendix A. Return codes, abend codes, and messages A.3 Messages The following messages are added. | FABJ0204I INPUT IMAGE COPY IS NOTIFIED AS PRIMARY IMAGE COPY, | AND CREATE IMAGE COPY IS NOTIFIED AS SECONDARY IMAGE COPY | Explanation: The Create Image Copy function issues the | NOTIFY.IC command. This command registers the input image copy | data set to RECON as a primary image copy data set and | registers the primary output image copy data set to RECON as a | secondary image copy data set. | System Action: None. | Programmer Response: None. | FABJ0205I THE IMAGE COPY STATUS IN THE RECON IS CHANGED TO IC | NEEDED | Explanation: The Create Image Copy function issues the | CHANGE.DBDS command. This command is issued after the | NOTIFY.IC command and prevents the image copy status of the | DBDS from changing into IC RECOMMENDED. | System Action: None. | Programmer Response: None. | FABJ0206W NOTIFY IC PROCESS IS BYPASSED BECAUSE OF MISMATCHES | BETWEEN INPUT IMAGE COPY AND DBRC | Explanation: The Create Image Copy function bypasses NOTIFY IC | process for one of the following reasons. | - The image copy record is already registered in DBRC but the | image copy type is disagree with the input image copy data | set. | - The image copy record is already registered in DBRC but the | runtime is disagree with the input image copy data set. | - The image copy record is not registered in DBRC but the | input image copy type is not BATCH. | System Action: None. | Programmer Response: None. | FABJ0207I THE TYPE OF IMAGE COPY IS CHANGED xxxxxxxx INTO | yyyyyyyy | Explanation: The Create Image Copy function issues the | DELETE.IC and the NOTIFY.IC commands. These commands changes | the image copy type of the existing image copy record in DBRC | from xxxxxxxx to yyyyyyyy. | System Action: None. | Programmer Response: None. | FABJ4614E DBD/AREA=cccccccc HAS NOT STOPPED WITHIN A TIME | LIMIT. IMAGE COPY FOR THIS DBD/AREA IS NOT PROCESSED. | Explanation: An attempt to stop DBD/AREA cccccccc has not | completed within a time limit set by TOITIME= keyword or | default value. | System Action: Image copy process is not performed for this | DBD/AREA. | Programmer Response: Increase the time limit by specifying | TOITIME= keyword and rerun the job. If the database or area is | still not stopped, check the IMS console and determine the | reason for not stopping database or area. And rerun the job | after correcting the problem. A.3.276 FABJ4612E The following sentences are added. : Programmer Response: Contact IBM Software Support, and provide the RC and RSN found in the message. | If RC=04 and RSN=101, increase the time limit by specifying | TOITIME= keyword and rerun the job.
APAR Information
APAR number
PK68158
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
2008-06-24
Closed date
2008-07-01
Last modified date
2008-08-02
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
014PC3Ÿ UK37777
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD FABJCMDB 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 FABJFCCA FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDA FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJGLRP FABJICDD FABJIDXA FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPA FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGC 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 FABJTOI FABJUIC1 FABJXCR FABJXHPC FABJXLIM
| SC18940900 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R410 PSY UK37777
UP08/07/03 P F807
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.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCX89E","label":"IMS HP Image Copy"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"4.1.0"}]
Document Information
Modified date:
14 December 2020