IBM Support

PK34133: NEW FUNCTION FOR HP IMAGE COPY

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as new function.

Error description

  • New Function for HP Fast Path Utilities
    

Local fix

  • Apply fix
    

Problem summary

  • ****************************************************************
    * USERS AFFECTED: IBM IMS High Performance Image Copy for z/OS *
    *                 Version 4 Release 1 ( FMID=H1J0410 ) users   *
    *                 who run under IMS High Performance Fast Path *
    *                 Utilities for z/OS Version 3 Release 1       *
    *                 ( FMID=H31A310 ).                            *
    ****************************************************************
    * PROBLEM DESCRIPTION: This is a required APAR for a new       *
    *                      function of IMS High Performance Fast   *
    *                      Path Utilities for z/OS V3R1.           *
    ****************************************************************
    * RECOMMENDATION: Apply the maintenance for this APAR.         *
    ****************************************************************
    The HPIC Image Copy function can be invoked under IMS High
    Performance Fast Path Utilities for z/OS V3R1.
    For information about how to invoke this function, see IMS High
    Performance Fast Path Utilities for z/OS User's Guide.
    

Problem conclusion

Temporary fix

Comments

  • The following modules and macro have been changed to support the
    function:
      FABJBLKD  FABJDMPN  FABJDPSN  FABJGLRP  FABJINT1  FABJINT2
      FABJIPRC  FABJNTFC  FABJPRM2  FABJTERM  FABUITCT
    The following modules have been reassembled.
      FABJACQG FABJAPIM FABJATRC FABJCMDB FABJCRC0 FABJCRC1 FABJCRC3
      FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS FABJDBCM FABJDBC1
      FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9 FABJDBF0 FABJDBLK FABJDBRC
      FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL FABJDDIM FABJDEMP FABJDFCN
      FABJDFC7 FABJDFC8 FABJDFC9 FABJDMP0 FABJDMP7 FABJDMP8 FABJDMP9
      FABJDOPN FABJDPS7 FABJDPS8 FABJDPS9 FABJDPUT FABJDREQ FABJDRQS
      FABJFCAI FABJFCCM FABJFCCN FABJFCC7 FABJFCC8 FABJFCC9 FABJFCDN
      FABJFCD7 FABJFCD8 FABJFCD9 FABJGDGB FABJICDD FABJIDXN FABJIDX7
      FABJIDX8 FABJIDX9 FABJINT3 FABJMAIN FABJMAS1 FABJMDPN FABJMDP7
      FABJMDP8 FABJMDP9 FABJMRGE FABJNTFI FABJORCN FABJORC7 FABJORC8
      FABJORC9 FABJPARM FABJPRM3 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9
      FABJRDB7 FABJRDB8 FABJRDB9 FABJRETC FABJRETM FABJRFCN FABJRFC7
      FABJRFC  FABJRFC9 FABJRPT0 FABJSAS1 FABJSAS2 FABJSTA  FABJTGEN
      FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM
    
    ========================
    = DOCUMENTATION CHANGE =
    ========================
    IMS High Performance Image Copy for z/OS Version 4 Release 1
    User's Guide SC18-9409-00 ( SC18940900 ) should be changed as
    follows:
    
    | X Image Copy Function under HP First Path Utility Version 3
    | The HPIC Image Copy function can be invoked under HP First
    | Path Utility Version 3. HPIC Image Copy function is scheduled
    | by Reload and Analyze of First Path Advanced Tool.
    |
    | For information about how to invoke this function, see High
    | Performance Fast path Utility for z/OS User's Guide.
    |
    | X.1 ICEIN Control Statement
    | When you use the HPIC Image Copy function under First Path
    | Advanced Tool, even if you do not code the ICEIN control
    | statements, HPIC will take an image copy for all database data
    | sets that are reorganized. If you specify the HPIC control
    | statements in the ICEIN DD statement, HPIC adds or replaces
    | the default values of the FP Advanced Tool with the specified
    | values. Following table shows which options can be replaced by
    | the ICEIN control statement.
    |
    | Replacement of the default values by the ICEIN control
    | statement
    | +----------+--------------------------+----------------------+
    | |Statement |The statement is replaced |Notes                 |
    | |          |by ICEIN                  |                      |
    | +----------+--------------------------+----------------------+
    | |GLOBAL    |Yes                       |                      |
    | +----------+--------------------------+----------------------+
    | |GROUP     |No                        |                      |
    | +----------+--------------------------+----------------------+
    | |AIC       |Yes                       |This is the default.  |
    | +----------+--------------------------+----------------------+
    | |IC        |Yes                       |                      |
    | +----------+--------------------------+----------------------+
    | |ACIC      |No                        |                      |
    | +----------+--------------------------+----------------------+
    | |CIC       |No                        |                      |
    | +----------+--------------------------+----------------------+
    | |WAIT      |Yes                       |                      |
    | +----------+--------------------------+----------------------+
    |
    | 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.
    |
    | The default for the ICEIN control statement under the First
    | Path Advanced Tool is always AIC. If you want to use
    | sequential process, you need to code the IC statement in the
    | ICEIN DD control card.
    |
    | Following table shows the ICEIN control statement parameters
    | that can be used for Image Copy process.
    |
    | ICEIN control statement parameters for Image Copy process
    | +--------+-------+-----------+----------+--------------------+
    | |Keyword |Can be |Acceptable |System    |Description         |
    | |        |specifi|Values     |Default   |                    |
    | |        |ed on  |           |          |                    |
    | |        +-------+           |          |                    |
    | |        |GLO|IC |           |          |                    |
    | |        |BAL|or |           |          |                    |
    | |        |   |AIC|           |          |                    |
    | +--------+---+---+-----------+----------+--------------------+
    | |AREA    |NO |YES|areaname   |None      |Specifies the AREA  |
    | |        |   |   |           |          |name of the data set|
    | |        |   |   |           |          |that is to be       |
    | |        |   |   |           |          |processed. If this  |
    | |        |   |   |           |          |parameter is        |
    | |        |   |   |           |          |omitted, all the    |
    | |        |   |   |           |          |data sets defined in|
    | |        |   |   |           |          |the AREA that is    |
    | |        |   |   |           |          |specified by the    |
    | |        |   |   |           |          |AREA parameter are  |
    | |        |   |   |           |          |processed by HPIC.  |
    | +--------+---+---+-----------+----------+--------------------+
    | |COMP    |YES|YES|Y or N     |N         |Specifies whether to|
    | |        |   |   |           |          |compress the output |
    | |        |   |   |           |          |record of the image |
    | |        |   |   |           |          |copy data set.      |
    | +--------+---+---+-----------+----------+--------------------+
    | |COMPRTN |YES|YES|routine    |FABJCMP4  |Specifies the name  |
    | |        |   |   |           |          |of the HPIC image   |
    | |        |   |   |           |          |copy compression    |
    | |        |   |   |           |          |exit routine. This  |
    | |        |   |   |           |          |keyword can be      |
    | |        |   |   |           |          |specified when      |
    | |        |   |   |           |          |COMP=Y.             |
    | +--------+---+---+-----------+----------+--------------------+
    | |DATACLAS|YES|YES|data_class_|None      |Specifies the name  |
    | |        |   |   |name       |          |of the data class   |
    | |        |   |   |           |          |for the SMS managed |
    | |        |   |   |           |          |output image copy   |
    | |        |   |   |           |          |data set.           |
    | +--------+---+---+-----------+----------+--------------------+
    | |DBBUF   |YES|YES|nnnn       |The value |Specifies the I/O   |
    | |        |   |   |           |optimized |buffer for the      |
    | |        |   |   |           |for the   |database data sets. |
    | |        |   |   |           |data set  |                    |
    | +--------+---+---+-----------+----------+--------------------+
    | |DBD     |YES|YES|dbdname    |None      |Specifies the name  |
    | |        |   |   |           |          |of the DBD to which |
    | |        |   |   |           |          |other parameters    |
    | |        |   |   |           |          |that are specified  |
    | |        |   |   |           |          |on the control      |
    | |        |   |   |           |          |statement are to be |
    | |        |   |   |           |          |applied.            |
    | +--------+---+---+-----------+----------+--------------------+
    | |DBRC    |YES|NO |Y or N     |None      |Is always ignored   |
    | |        |   |   |           |          |under the First Path|
    | |        |   |   |           |          |Advanced Tool.      |
    | +--------+---+---+-----------+----------+--------------------+
    | |DSN     |YES|NO |expression |None      |Specifies the       |
    | |        |   |   |           |          |template for the    |
    | |        |   |   |           |          |primary output image|
    | |        |   |   |           |          |copy data set.      |
    | +--------+---+---+-----------+----------+--------------------+
    | |DSN2    |YES|NO |expression |None      |Specifies the       |
    | |        |   |   |           |          |template for the    |
    | |        |   |   |           |          |secondary output    |
    | |        |   |   |           |          |image copy data set.|
    | +--------+---+---+-----------+----------+--------------------+
    | |EXPDT   |YES|NO |yyyyddd or |None      |Specifies the       |
    | |        |   |   |yyddd      |          |expiration date of  |
    | |        |   |   |           |          |the output image    |
    | |        |   |   |           |          |copy data set.      |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICBUF   |YES|NO |nnnnn      |The value |Specifies the I/O   |
    | |        |   |   |           |optimized |buffer for the      |
    | |        |   |   |           |for the   |output image copy   |
    | |        |   |   |           |image copy|data sets.          |
    | |        |   |   |           |data set  |                    |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICCAT   |YES|NO |Y or N     |Y         |Specifies whether to|
    | |        |   |   |           |          |request that the    |
    | |        |   |   |           |          |output image copy   |
    | |        |   |   |           |          |data set be         |
    | |        |   |   |           |          |cataloged.          |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICDALLOC|YES|NO |Y or N     |Y         |Requests dynamic    |
    | |        |   |   |           |          |allocation of the   |
    | |        |   |   |           |          |output image copy   |
    | |        |   |   |           |          |data set.           |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICHLQ   |YES|YES|hlq1 or    |None      |Specifies the data  |
    | |        |   |   |(hlq1,hlq2)|          |set name prefix of  |
    | |        |   |   |           |          |the image copy data |
    | |        |   |   |           |          |set. (1)            |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICHLQ2  |YES|YES|hlq2       |None      |Specifies the data  |
    | |        |   |   |           |          |set name prefix of  |
    | |        |   |   |           |          |the image copy data |
    | |        |   |   |           |          |set. (1)            |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICNMRULE|YES|NO |Y or N     |N         |Selects a naming    |
    | |        |   |   |           |          |convention for the  |
    | |        |   |   |           |          |output image copy   |
    | |        |   |   |           |          |data set of ICOUT=. |
    | |        |   |   |           |          |(1)                 |
    | +--------+---+---+-----------+----------+--------------------+
    | |ICOUT   |NO |YES|One of the |*         |Specifies the DD    |
    | |        |   |   |following  |          |name of the image   |
    | |        |   |   |formats:   |          |copy data set.      |
    | |        |   |   |-ddname    |          |                    |
    | |        |   |   |-(dd1,dd2) |          |                    |
    | |        |   |   |-*         |          |                    |
    | |        |   |   |-(*,*)     |          |                    |
    | +--------+---+---+-----------+----------+--------------------+
    | |MGMTCLAS|YES|YES|mgmt_class_|None      |Specifies the name  |
    | |        |   |   |name       |          |of the management   |
    | |        |   |   |           |          |class for the SMS   |
    | |        |   |   |           |          |managed output image|
    | |        |   |   |           |          |copy data set.      |
    | +--------+---+---+-----------+----------+--------------------+
    | |RETPD   |YES|YES|parm       |None      |Specifies the RETPD |
    | |        |   |   |           |          |parameter for the   |
    | |        |   |   |           |          |image copy data set.|
    | +--------+---+---+-----------+----------+--------------------+
    | |SPACE   |YES|YES|( CYL|TRK| |None      |Specifies the space |
    | |        |   |   |blk ,      |          |parameter of the    |
    | |        |   |   |primary ,  |          |image copy data set |
    | |        |   |   |secondary )|          |when it is          |
    | |        |   |   |           |          |dynamically         |
    | |        |   |   |           |          |allocated.          |
    | +--------+---+---+-----------+----------+--------------------+
    | |STACK   |NO |YES|One of the |None      |Requests that the   |
    | |        |   |   |following  |          |image copy data set |
    | |        |   |   |formats:   |          |be stacked.         |
    | |        |   |   |-ddname    |          |                    |
    | |        |   |   |-(dd1,dd2) |          |                    |
    | |        |   |   |-*         |          |                    |
    | |        |   |   |-(*,*)     |          |                    |
    | +--------+---+---+-----------+----------+--------------------+
    | |STORCLAS|YES|YES|stor_class_|None      |Specifies the name  |
    | |        |   |   |name       |          |of the storage class|
    | |        |   |   |           |          |for the SMS managed |
    | |        |   |   |           |          |output image copy   |
    | |        |   |   |           |          |data set.           |
    | +--------+---+---+-----------+----------+--------------------+
    | |UNIT    |YES|YES|unit_name  |SYSALLDA  |Specifies the UNIT  |
    | |        |   |   |or         |          |parameter for the   |
    | |        |   |   |(unit_name,|          |image copy data set |
    | |        |   |   |unit_count)|          |when if is          |
    | |        |   |   |           |          |dynamically         |
    | |        |   |   |           |          |allocated.          |
    | +--------+---+---+-----------+----------+--------------------+
    | |UNIT2   |YES|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|YES|nnn        |1         |Specifies how many  |
    | |        |   |   |           |          |tape volumes are to |
    | |        |   |   |           |          |be used for the     |
    | |        |   |   |           |          |image copy data set.|
    | +--------+---+---+-----------+----------+--------------------+
    | |VOLSER  |YES|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|YES|volser     |None      |Specifies the volume|
    | |        |   |   |or         |          |serial number of the|
    | |        |   |   |(vol1,     |          |tape volume used for|
    | |        |   |   |vol2,..)   |          |the secondary image |
    | |        |   |   |           |          |copy data set.      |
    | +--------+---+---+-----------+----------+--------------------+
    | |WAITTIME|YES|NO |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|NO |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     |
    | |        |   |   |           |          |(SVC99) is 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.|
    | +------------------------------------------------------------+
    |
    | For information about how to invoke this function, see IMS
    | High Performance Fast Path Utilities for z/OS User's Guide.
    

APAR Information

  • APAR number

    PK34133

  • 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

    2006-11-06

  • Closed date

    2006-12-13

  • Last modified date

    2007-01-04

  • APAR is sysrouted FROM one or more of the following:

  • APAR is sysrouted TO one or more of the following:

    UK20622

Modules/Macros

  • FABJACQG FABJAPIM FABJATRC FABJBLKD FABJCMDB
    FABJCRC0 FABJCRC1 FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO
    FABJDALS FABJDBCM FABJDBC1 FABJDBDN FABJDBD7 FABJDBD8 FABJDBD9
    FABJDBF0 FABJDBLK FABJDBRC FABJDBR7 FABJDBR8 FABJDBR9 FABJDCTL
    FABJDDIM 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 FABJICDD FABJIDXN FABJIDX7 FABJIDX8
    FABJIDX9 FABJINT1 FABJINT2 FABJINT3 FABJIPRC FABJMAIN FABJMAS1
    FABJMDPN FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJNTFC FABJNTFI
    FABJORCN FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJPRM3
    FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9
    FABJRETC FABJRETM FABJRFCN FABJRFC7 FABJRFC8 FABJRFC9 FABJRPT0
    FABJSAS1 FABJSAS2 FABJSTA  FABJTERM FABJTGEN FABJTOI  FABJUIC1
    FABJXCR  FABJXHPC FABJXLIM FABUITCT
    

Publications Referenced
SC18940900    

Fix information

  • Fixed component name

    IMS HP IMAGE CO

  • Fixed component ID

    5655K9600

Applicable component levels

  • R410 PSY UK20622

       UP06/12/16 P F612

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