A fix is available
APAR status
Closed as program error.
Error description
The following keywords regarding SMS classes are not effective when using the STACKING function even though they are specified in the GLOBAL statement: DATACLAS MGMTCLAS STORCLAS
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: All IMS High Performance Image Copy * * for z/OS version 3 users (FMID=H1J0310) * **************************************************************** * PROBLEM DESCRIPTION: HPIC ignores SMS related keywords * * specified in the GLOBAL statement * * when stacking is used. * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** This APAR provides the fix for following problem: HPIC ignores the following keywords specified in the GLOBAL statement when stacking is used: DATACLAS MGMTCLAS STORCLAS
Problem conclusion
FABJICDD has been modified to set DATACLAS, MGMTCLAS, and STORCLAS keywords as allocation information of stacking output image copy data sets if they are specified in the GLOBAL statement. ======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 1 User's Guide SC18-7617-00 ( SC18761700 ) should be changed as follows: 6.2.4 Dynamic Allocation for the Stacked Data Set When stacking is used, the Image Copy function always dynamically allocates the stacked image copy data sets. The Image Copy function uses the allocation information inherited from the stacked data set. The data set name for each stacked image copy data set is constructed as follows: ichlq.ICn.dbdname.ddname.Dyyddd.Thhmmss where: ichlq is specified with the ICHLQ= keyword. n is 1 or 2 indicating the primary or secondary copy. dbdname is the DBD name or the partition dbdname of the database to be copied. ddname | is the DD name specified in the STACK keyword. yyddd is the date. hhmmss is the time stamp. When the stacked data set is requested, HPIC 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: 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 HPIC execution job. hhmmss is the time stamp. Note: You can change the data set naming convention by the data set naming template. | When the stacking is used and DD card for stacked data set is | not presented in running JCL, the Image Copy function | dynamically allocates the stacked data set by using the | allocation information specified by the ICEIN control | statements. | The following keywords are effective for each stacked image | copy data set only when they are specified in the GLOBAL | statement. If they are specified in any other statement except | the GLOBAL statement, they are ignored. UNIT=icunit where: icunit is the unit name specified by the ICEIN UNIT keyword. VOL=(,,,volcnt,SER=(ser1,ser2,...)) where: volcnt is the volume count specified by the ICEIN VOLCNT keyword. ser1, ser2 ... are the volume serial numbers specified by the ICEIN VOLSER keyword. EXPDT=expdt or RETPD=retpd where: expdt is the expiration date specified by the ICEIN EXPDT keyword. retpd is the retention period specified by the ICEIN RETPD keyword. | DATACLAS=data-class-name | | where: | | data-class-name | is the name of the data class specified by the ICEIN | DATACLAS keyword. | | | MGMTCLAS=management-class-name | | where: | | management-class-name | is the name of the management class specified by the ICEIN | MGMTCLAS keyword. | | | STORCLAS=storage-class-name | | where: | | storage-class-name | is the name of the storage class specified by the ICEIN | STORCLAS keyword. The Image Copy function uses the volume information of the dynamically allocated stacked data set when allocating subsequent stacked image copy data sets. | Note: The disposition parameter for each stacked image copy | data set is as follows: | DISP=(NEW,KEEP)
Temporary fix
Comments
APAR Information
APAR number
PQ96271
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
310
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2004-10-26
Closed date
2004-12-02
Last modified date
2005-01-04
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UQ95682
Modules/Macros
FABJDALC
SC18761700 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R310 PSY UQ95682
UP04/12/07 P F412
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