IBM Support

PK11605: THIS APAR ENABLES A NEW FUNCTION FOR HPIC V4

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • THIS APAR ENABLES A NEW FUNCTION FOR HPIC V4
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: IBM High Performance Image Copy for z/OS     *
    *                 Version 4 Release 1 (FMID=H1J0410) 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:                                              *
    ****************************************************************
    + 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 4 Release 1
    User's Guide: Document Number: SC18-9409-00 ( SC18940900 )
    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

    PK11605

  • 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

    2005-09-08

  • 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:

    UK12399

Modules/Macros

  • FABJACHK FABJACQG FABJAPI  FABJAPIK FABJAPIM
    FABJAPIP FABJAPIS FABJATRC FABJBLKD FABJCMDB FABJCP4S FABJCP40
    FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO
    FABJDALS FABJDATE FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8
    FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9
    FABJDCTL FABJDEMP FABJDFCN FABJDFC7 FABJDFC8 FABJDFC9 FABJDMPN
    FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9 FABJDOPN FABJDPSN FABJDPS7
    FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS FABJFCAI FABJFCCM
    FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDN FABJFCD7 FABJFCD8
    FABJFCD9 FABJGDGB FABJGLRP 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 FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9
    FABJRPTH FABJRPT0 FABJSAS1 FABJSAS2 FABJSTA  FABJSTMD FABJSTMP
    FABJSTMS FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJXCR  FABJXHPC
    FABJXLIM FABUITCT H1J0410J
    

Publications Referenced
SC18940900    

Fix information

  • Fixed component name

    IMS HP IMAGE CO

  • Fixed component ID

    5655K9600

Applicable component levels

  • R410 PSY UK12399

       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":"4.1.0","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
14 December 2020