A fix is available
APAR status
Closed as new function.
Error description
This APAR enables a new function of HPIC V3.
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: IBM High Performance Image Copy for z/OS * * Version 3 Release 2 (FMID=H1J0320) users who * * invoke Image Copy function via IMS Database * * Recovery Facility for z/OS Version 3 Release * * 1 (FMID=H27L310). * **************************************************************** * PROBLEM DESCRIPTION: + NOTE -------------------------------+ * * | This new function is only available | * * | for IMS Database Recovery Facility | * * | (DRF) Version 3 Release 1. | * * +-------------------------------------+ * * By applying this APAR, the Image Copy * * function can be invoked under DRF. * * Use the DRF ADD control statement IC * * keyword to indicate that * * the Image Copy function is required. * * For more details, see "IMS Database * * Recovery Facility for z/OS * * User's Guide and Reference * * (SC18940700)" * **************************************************************** * RECOMMENDATION: Apply the maintenance for this APAR. * **************************************************************** + NOTE -------------------------------------------------------+ | This new function is only available for IMS Database | | Recovery Facility (DRF) Version 3 Release 1. | +-------------------------------------------------------------+ By applying this APAR, the Image Copy function can be invoked under DRF. Use the DRF ADD control statement IC keyword to indicate that the Image Copy function is required. For more details, see "IMS Database Recovery Facility for z/OS User's Guide and Reference (SC18940700)"
Problem conclusion
Temporary fix
Comments
======================== = DOCUMENTATION CHANGE = ======================== IMS High Performance Image Copy for z/OS Version 3 Release 2 User's Guide SC18-7617-01 ( SC18761701 ) should be changed as follows: The HPIC Image Copy function can be invoked under IMS Database Recovery Facility for z/OS. The HPIC is invoked by following DRF process. Create New IC data set under Batch Database Recovery. Create Incremental Image Copy data set. For information about how to invoke this function, see IMS Database Recovery Facility for z/OS. When you use the HPIC Image Copy function under the DRF, you do not code ICEIN control statement except HPIC Site Default Table. If you need to add or replace the default values, you need to specify the value in DRF control statement. HPIC control statement under DRF To use the site default options, have the site global options defined in your system, and the library that contains the site default module defined in STEPLIB; HPIC will use the site global options that are defined in your system. Table nn shows the default value for ICEIN control statement parameters under DRF by HPIC Site Default Table. +--------------------------------------------------------------+ | Table nn. ICEIN control statement parameters for Image Copy | |process | +--------+---------+-----------+---------+---------------------+ |Keyword |Can be |Acceptable |System |Description | | |specified|Values |Default | | | |on Site | | | | | |Default | | | | +--------+---------+-----------+---------+---------------------+ |COMP | YES |Y or N |N |Specifies whether to | | | | | |compress the output | | | | | |record of the image | | | | | |copy data set. | +--------+---------+-----------+---------+---------------------+ |COMPRTN |YES |routine |FABJCMP3 |Specifies the name of| | | | | |the HPIC image copy | | | | | |compression exit | | | | | |routine. This keyword| | | | | |can be specified when| | | | | |COMP=Y. | +--------+---------+-----------+---------+---------------------+ |DATACLAS|YES |class name |None |Specifies the name of| | | | | |the DATACLAS for | | | | | |output IC data set | +--------+---------+-----------+---------+---------------------+ |DBRC |YES |Y or N |None |Is always ignored | | | | | |under the DRF. | +--------+---------+-----------+---------+---------------------+ |DSN |YES |expression |None |Specifies the | | | | | |template for the | | | | | |primary output image | | | | | |copy data set. | +--------+---------+-----------+---------+---------------------+ |DSN2 |YES |expression |None |Specifies the | | | | | |template for the | | | | | |secondary output | | | | | |image copy data set. | +--------+---------+-----------+---------+---------------------+ |EXPDT |YES |yyyyddd |None |Specifies the | | | |or yyddd | |expiration date of | | | | | |the output image copy| | | | | |dataset. | +--------+---------+-----------+---------+---------------------+ |ICBUF |YES |nnnn |The value|Specifies the I/O | | | | |optimized|buffer for the output| | | | |for the |image copy data sets.| | | | |image | | | | | |copy data| | | | | |set. | | +--------+---------+-----------+---------+---------------------+ |ICCAT |YES |Y or N |Y |Specifies whether to | | | | | |request that the | | | | | |output image copy | | | | | |data set be | | | | | |cataloged. | +--------+---------+-----------+---------+---------------------+ |ICHLQ |YES |hlq1 |None |Specifies the data | | | |or | |set name prefix of | | | |(hlq1,hlq2)| |the image copy data | | | | | |set.(1) | +--------+---------+-----------+---------+---------------------+ |ICHLQ2 |YES |hlq2 |None |Specifies the data | | | | | |set name prefix of | | | | | |the image copy data | | | | | |set.(1) | +--------+---------+-----------+---------+---------------------+ |ICNMRULE|YES |Y or N |N |Selects a naming | | | | | |convention for the | | | | | |output image copy | | | | | |data set of ICOUT=. | | | | | |(1) | +--------+---------+-----------+---------+---------------------+ |MGMTCLAS|YES |name |None |Specifies the name of| | | | | |the MGMTCLAS for | | | | | |output IC data set | +--------+---------+-----------+---------+---------------------+ |RETPD |YES |nnnn |None |Specifies the RETPD | | | | | |parameter for the | | | | | |image copy data set. | +--------+---------+-----------+---------+---------------------+ |SPACE |YES |( CYL|TRK| |None |Specifies the space | | | |blk , | |parameter of the | | | |primary , | |image copy data set | | | |secondary )| |when it is | | | | | |dynamically | | | | | |allocated. | +--------+---------+-----------+---------+---------------------+ |STORCLAS|YES |name |None |Specifies the name of| | | | | |the STORCLAS for | | | | | |output IC data set | +--------+---------+-----------+---------+---------------------+ |UNIT |YES |unit_name |SYSALLDA |Specifies the UNIT | | | |or | |parameter for the | | | |(unit_name,| |image copy data set | | | |unit_count)| |when it is | | | | | |dynamically | | | | | |allocated. | +--------+---------+-----------+---------+---------------------+ |UNIT2 |YES |unit_name |SYSALLDA |Specifies the UNIT2 | | | |or | |parameter for the | | | |(unit_name,| |secondary image copy | | | |unit_count)| |data set when it is | | | | | |dynamically | | | | | |allocated. If the | | | | | |UNIT2 is omitted and | | | | | |UNIT parameter is | | | | | |defined, specified | | | | | |value in UNIT= is | | | | | |used for the | | | | | |secondary image copy | | | | | |data set. | +--------+---------+-----------+---------+---------------------+ |VOLCNT |YES |nnn |1 |Specifies how many | | | | | |tape volumes are to | | | | | |be used for the image| | | | | |copy data set. | +--------+---------+-----------+---------+---------------------+ |VOLSER |YES |volser |None |Specifies the volume | | | |or | |serial number of the | | | |(vol1, | |tape volume used for | | | |vol2,..) | |the primary image | | | | | |copy data set. | +--------+---------+-----------+---------+---------------------+ |VOLSER2 |YES |volser |None |Specifies the volume | | | |or | |serial number of the | | | |(vol1, | |tape volumes to be | | | |vol2,..) | |used for the | | | | | |secondary image copy | | | | | |data set. | +--------+---------+-----------+---------+---------------------+ |WAITTIME|YES |nnnn |30 |Specifies the wait | | | | | |time for repeating | | | | | |the dynamic | | | | | |allocation on the | | | | | |tape unit when the | | | | | |dynamic allocation | | | | | |reason code (SVC99) | | | | | |is 214, 220, or 228. | | | | | | | +--------+---------+-----------+---------+---------------------+ |WAITMSG |YES |Y or N |N |Specifies whether the| | | | | |FABJ3929A WTO message| | | | | |is to be displayed | | | | | |when dynamic | | | | | |allocation is being | | | | | |performed on the tape| | | | | | unit and the reason | | | | | |code is (SVC99) 214, | | | | | |220, or 228. | +--------+---------+-----------+---------+---------------------+ |1. The naming rule for the image copy data set that is | | allocated dynamically by IMS High Performance Image Copy | | is described in "Output Image Copy Data Set" in topic 5.3.| +--------------------------------------------------------------+
APAR Information
APAR number
PK19890
Reported component name
IMS HP IMAGE CO
Reported component ID
5655K9600
Reported release
320
Status
CLOSED UR1
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2006-02-15
Closed date
2006-03-08
Last modified date
2006-04-05
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UK12398
Modules/Macros
FABJACHK FABJACQG FABJAPI FABJAPIK FABJAPIM FABJAPIP FABJAPIS FABJATRC FABJBLKD FABJCMDB FABJCP4S FABJCP40 FABJCRC0 FABJCRC1 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDATE FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDEMP FABJDMPN FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJICB FABJICDD FABJIDXN FABJIDX7 FABJIDX8 FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMAS2 FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMPC0 FABJMRGE FABJMSGC FABJMSGP FABJMSGS FABJNTFC FABJNTFI FABJNTFS FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRPTH FABJRPT0 FABJSAS1 FABJSAS2 FABJSTMD FABJSTMP FABJSTMS FABJTERM FABJTGEN FABJUIC1 FABJXLIM FABUITCT H1J0320J
| SC18761701 |
Fix information
Fixed component name
IMS HP IMAGE CO
Fixed component ID
5655K9600
Applicable component levels
R320 PSY UK12398
UP06/03/09 P F603
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":"320","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
14 December 2020