A fix is available
APAR status
Closed as new function.
Error description
HPIC supports new keyword, STACKBASE=. By this keyword, temporary IC data set for STACK output can be allocated with real data set name instead of temporary data set named by HPIC.
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 a new keyword * * STACKBASE=. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides a new keyword STACKBASE=. The new keyword STACKBASE= is supported in order to specify that the dummy data set for stacking is dynamically allocated by using either the temporary or real name.
Problem conclusion
Temporary fix
Comments
FABJBLKD, FABJGLRP, FABJPARM, FABJPRM2, FABJSTMD and FABJTGEN have been modified to support the new keyword STACKBASE=. FABJDMPN and FABJICDD have been modified to pass the real data set name to module FABJDALC when the STACKBASE=REAL is specified in the ICEIN control statement. 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 FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDFCA FABJDFCB FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDMPA FABJDMPB FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPSA FABJDPSB FABJDPUT FABJDREQ FABJDRQS FABJDRSN FABJFCAI FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCCA FABJFCCB FABJFCDN FABJFCD7 FABJFCD8 FABJFCD9 FABJFCDA FABJFCDB FABJGDGB FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJIDXA FABJIDXB FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMDPA FABJMDPB FABJMRGE 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: 3 Operating instructions 3.4.2.1 GLOBAL statements The GLOBAL statement contains the following keywords: . STACK= | . STACKBASE= . STORCLAS= 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| | | +-------------+-+-+-+-+-+-+-+------------------------+-------+ : : : : +-------------+-+-+-+-+-+-+-+------------------------+-------+ |STACK= |O|O|O|O|O| |O|Requests the image copy | | | | | | | | | | |stacking function and | | | | | | | | | | |specifies the ddname of | | | | | | | | | | |the output stacks. | | +-------------+-+-+-+-+-+-+-+------------------------+-------+ | |STACKBASE= |O| | | | | |O|Specifies that the | | | | | | | | | | | |dummy data set for | | | | | | | | | | | |stacking is dynamically | | | | | | | | | | | |allocated by using | | | | | | | | | | | |either the temporary or | | | | | | | | | | | |real name. | | +-------------+-+-+-+-+-+-+-+------------------------+-------+ |STORCLAS= |O|O|O|O| | |O|Specifies the name of | | | | | | | | | | |the storage class for | | | | | | | | | | |the new SMS managed | | | | | | | | | | |image copy output data | | | | | | | | | | |sets that are | | | | | | | | | | |dynamically allocated. | | +-------------+-+-+-+-+-+-+--------------------------+-------+ | 3.4.3.xx STACKBASE= | The STACKBASE keyword specifies that the dummy data set for | stacking is dynamically allocated by using either the | temporary or real name. | | +---------------------------------------------------------+ | | STACKBASE=TEMP|REAL | | +---------------------------------------------------------+ | | where: | TEMP | specifies that the dummy data set for stacking is allocated | by using the temporary name. | This is the default. | | Note: The temporary name is constructed as follows. | +----------------------------------+ | | DSN=ichlq.ddname.job-no.Thhmmss | | +----------------------------------+ | | REAL | Specifies that the dummy data set for stacking is allocated | by using the real name which is same name as the output | image copy data set. | | 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: : . STACK= | . STACKBASE= . STORCLAS= : 5 Using dynamic allocation 5.2.2.3 Naming convention <Following sentences is added> | Note: You can change the data set naming convention by the | data set naming template. <Following sentences is changed> When the stacked data set is requested, IMS HP Image Copy dynamically allocates a dummy data set first. The dummy data set is not a real data set, but its allocation information is used internally for control. If you control the data set name by using the tape control program, you need to take the dummy | data set into consideration. The dummy data set name is as | follows: | | If STACKBASE=REAL is applied, the real data set name of output | image copy generated by the naming convention is used. | | If STACKBASE=TEMP is applied: +----------------------------------+ | DSN=ichlq.ddname.job-no.Thhmmss | +----------------------------------+ where: ichlq is the data set name prefix specified with the ICHLQ= keyword. ddname is the ddname specified in the STACK keyword. job-no is the job number of the IMS HP Image Copy execution job. hhmmss is the time stamp. <Following sentences is deleted> Note: You can change the data set naming convention by the data set naming template. 11 Working with other IMS tools 11.2 IMS Parallel Reorganization Table 24. ICEIN control statement parameters for Image Copy process (IMS Parallel Reorganization) +-------------+---------+----------+--------+----------------+ | |Can be | | | | | |specified| | | | | |on site | | | | | |default | | | | | Keyword +----+----+Acceptable|System |Description | | | G |IC |values |Default | | | | L |or | | | | | | O |AIC | | | | | | B | | | | | | | A | | | | | | | L | | | | | +-------------+---------+----------+--------+----------------+ : : : : : +-------------+---------+----------+--------+----------------+ |STACK |YES |YES |One Of The|None |Requests that | | | | |following | |the image copy | | | | |formats: | |data sets be | | | | |.ddname | |stacked. The | | | | |.(dd1,dd2)| |STACK parameter | | | | |.* | |can be specified| | | | |.(*,*) | |only when | | | | | | |ICTYPE=B. | +-------------+---------+----------+--------+----------------+ | |STACKBASE |YES |NO |TEMP |TEMP |Specifies that | | | | | |or | |the dummy data | | | | | |REAL | |set for stacking| | | | | | | |is dynamically | | | | | | | |allocated by | | | | | | | |using either the| | | | | | | |temporary or | | | | | | | |real name. | | | | | | | |This keyword is | | | | | | | |available only | | | | | | | |when ICTYPE=B | | | | | | | |and STACK= are | | | | | | | |specified. | +-------------+---------+----------+--------+----------------+ : : : : : 11.3 IMS HP Fast Path Utilities Table 26. ICEIN control statement parameters for Image Copy process (IMS HP Fast Path Utilities) +-------------+---------+----------+--------+----------------+ | |Can be | | | | | |specified| | | | | |on site | | | | | |default | | | | | Keyword +----+----+Acceptable|System |Description | | | G |IC |values |Default | | | | L |or | | | | | | O |AIC | | | | | | B | | | | | | | A | | | | | | | L | | | | | +-------------+---------+----------+--------+----------------+ : : : : : +-------------+---------+----------+--------+----------------+ |STACK |YES |YES |One Of The|None |Requests the | | | | |following | |image copy | | | | |formats: | |stacking | | | | |.ddname | |function and | | | | |.(dd1,dd2)| |specifies the | | | | |.* | |ddname of the | | | | |.(*,*) | |output stacks. | +-------------+---------+----------+--------+----------------+ | |STACKBASE |YES |NO |TEMP |TEMP |Specifies that | | | | | |or | |the dummy data | | | | | |REAL | |set for stacking| | | | | | | |is dynamically | | | | | | | |allocated by | | | | | | | |using either the| | | | | | | |temporary or | | | | | | | |real name. | | | | | | | |This keyword is | | | | | | | |available only | | | | | | | |when STACK= is | | | | | | | |specified. | +-------------+---------+----------+--------+----------------+ : : : : :
APAR Information
APAR number
PK79032
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-01-21
Closed date
2009-02-03
Last modified date
2009-03-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK43745
Modules/Macros
FABJACQG FABJAPIM FABJASPM FABJATRC FABJBLKD 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 FABJFCAI 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 UK43745
UP09/02/07 P F902
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