PK15169: THIS APAR IS FORWARD FIT APAR FROM HPIC V3R2 CONTAINING SOME NEW FUNCTIONS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• This APAR is a "forward-fit" APAR from the following HPIC V3R2
  APARs:
  - PK11169
  - PK11775
  - PK13863
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 4 Release 1 users ( FMID=H1J0410 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR includes following APARs of   *
  *                      HPIC V3R2:                              *
  *                       PK11169, PK11775, PK13863              *
  *                      And HPIC V4R1 includes some problems of *
  *                      Global Options Report.                  *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  This APAR includes following APAR fixes from IMS High
  Performance Image Copy for z/OS version 3 release 2:
  - PK11169 provides a new optional keyword WAITALOC= and enhances
    optional keyword WAITTIME=.
  - PK11775 provides new keyword HOMECHK= and some new optional
    parameters of HDPC= keyword that controls HASH Check Reports.
    The new keywords are enabled, when APAR PK11923 is applied to
    IMS High Performance Pointer Checker for z/OS Version 2
    Release 1 ( FMID=HPC2210 ).
  - PK13863 provides new parameter LASTICALL of TIMESTMP= keyword.
  This APAR also corrects following problems of Global Options
  Report:
  - Some keywords are not reported.
  - The default values of some keywords are incorrect.
  - Some reported values of some keywords are incorrect.
  - The keywords are not reported in alphabetic order.
  - The garbage is printed.
  

Problem conclusion

• - A new module FABJDALS has been created. This module requests
    dynamic allocation of IC data set.
  - FABJMAIN, FABJDCTL, FABJDRQS, FABJIPRC, and FABJDMPN have been
    modified to attach and detach the new module.
  - FABJDALC and FABJDALO have been modified to control the
    request of dynamic allocation to FABJDALS.
  - FABJMAIN, FABJINT1, and FABUITCT have been modified to pass
    the HOMECHK value and HDPC value to HPPC.
  - FABJRCHK has been modified to provide the LASTICALL parameter.
  - FABJBLKD, FABJMRGE, FABJPARM, FABJPRM2, FABJSTMD and FABJTGEN
    have been modified to add new areas for new keyword and new
    keyword parameters.
  - FABJMSGC has been modified to add new message.
  - FABJMAS1 has been modified to calculate data space origin
    correctly.
  - FABJGLRP has been modified following things:
    - To report new keywords and missing keywords.
    - To report correct default value for following keywords:
        FASTIC, COMPRTN under IPR, HDPC under IPR
    - To report correct values for the following keywords:
        DEDBPC, RETPD
    - To add the new some values for the following keywords:
        HDPC, WAITTIME
    - To report the keyword in alphabetic order.
    - To remove the garbage in the UNIT2 keyword.
    - To change the default and active value for DBRC keyword from
      'NO' to 'N/A' under IPR.
  - The following modules have been reassembled.
    FABJACQG, FABJCMDB, FABJCRC0, FABJCRC1, FABJCRC3, FABJCTCV,
    FABJCZCV, FABJDBCM, FABJDBC1, FABJDBD7, FABJDBD8, FABJDBD9,
    FABJDBF0, FABJDBLK, FABJDBR7, FABJDBR8, FABJDBR9, FABJDEMP,
    FABJDFC7, FABJDFC8, FABJDFC9, FABJDMP0, FABJDMP7, FABJDMP8,
    FABJDMP9, FABJDOPN, FABJDPS7, FABJDPS8, FABJDPS9, FABJDPUT,
    FABJDREQ, FABJFCAI, FABJFCCM, FABJFCC7, FABJFCC8, FABJFCC9,
    FABJFCD7, FABJFCD8, FABJFCD9, FABJICDD, FABJINT2, FABJMDP7,
    FABJMDP8, FABJMDP9, FABJNTFC, FABJORC7, FABJORC8, FABJORC9,
    FABJRCH7, FABJRCH8, FABJRCH9, FABJRDB7, FABJRDB8, FABJRDB9,
    FABJRFC7, FABJRFC8, FABJRFC9, FABJRPT0, 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-00 ( SC18940900 ) should be changed as
  follows:
   2.2 JCL Requirements
   2.2.1 FABJMAIN JCL
   --------------------------------------------------------------
   The following descriptions are added
  ADD:
   If HP Pointer Checker is called with HOMECHK, CHAINDIST, or
   COMPFACT options, you must specify the library containing
   randomizer or segment edit/compression routine.
  ADD:
   --------------------------------------------------------------
   2.3 Input
   2.3.5     ICEIN Keywords
   --------------------------------------------------------------
   2.3.4.1 GLOBAL Statement
   The GLOBAL statement contains the following keywords:
       :
     . HOMECHK=
     . TIMESTMP=
     . WAITALOC=
       :
     2.3.4.2 GROUP Statement
     Optional keywords:
       :
     . HOMECHK=
       :
     2.3.4.3 IC/AIC Statement
     Optional keywords:
       :
     . HDPC=
     . HOMECHK=
     . ICBUF=
       :
   --------------------------------------------------------------
   Add a new sub section = to 2.3.5 ICEIN keywords.
  ADD:
   2.3.5.xx HOMECHK=
   The HOMECHK keyword specifies print the DISTRIBUTION OF ROOT
   SEGMENTS part in the DB Record Distribution Statistics Report
   of HD Pointer Checker. It is printed for HDAM or PHDAM, and
   only for the data set group that contains root segments.
   +--------------------------------------+
   | HOMECHK = (YES,-mmm,+nnn) | YES | NO |
   +--------------------------------------+
   where:
   (YES,-mmm,+nnn) or YES
   The DISTRIBUTION OF ROOT SEGMENTS is printed. Y can be used
   shortened forms of YES.
   If YES, mmm is the backward distance from Home Block (1-999) an
   nnn is the forward distance from Home Block (1-999).
   The sign "+" can be omitted.
   If, only YES is specified, the range is assumed as -10 to +10.
   Randomizer module is used for this option. Specify the data set
   name containing the randomizer module to the STEPLIB DD
   statement.
   If a segment edit/compression exit routine is defined to a root
   segment, the segment edit/compression exit module is used for
   this option. Specify the data set name containing the segment
   edit/compression exit to the STEPLIB DD statement.
   It is supported in the Single-Step HASH Check under HP Image
   Copy job.
  ADD:
   2.3.5.xx WAITALOC=
   This keyword specifies whether to display the 'WAIT' option on
   the message IEF238D or not, when the dynamic allocation fails
   on the tape unit.
   +---------------------------------------------------------+
   | WAITALOC=Y|N                                            +
   +---------------------------------------------------------+
   where:
   Y displays the 'WAIT' option on the message IEF238D.
     WAITALOC=Y is ignored, if any of the libraries specified in
     the STEPLIB DD statement are not APF-authorized.
   N does not display the 'WAIT' option on the message IEF238D.
     This is the default.
   When 'WAIT' is replied to the message IEF238D, HPIC waits
   dynamic allocation until the required units are released.
   This keyword can be used in the following control statement:
     GLOBAL
   2.3.5.27  HDPC=
   --------------------------------------------------------------
   Add the following new options to HDPC= keyword parameter:
  ADD:
   DBDIST
   requests to print the DB Record Distribution Statistics report.
   It is available for HDAM, HIDAM, PHDAM, and PHIDAM databases.
   This report contains the following information:
   TOTAL NUMBER OF SEGMENTS (ROOTS + DEPENDENTS) IN THE DATA SET
   MAXIMUM ROOTS PER BLOCK
   Note:
   DISTRIBUTION OF DEPENDENT SEGMENTS IN ROOT BLOCK and
   DISTRIBUTION OF DEPENDENT SEGMENTS BY SEGMENT CODE are not
   printed in the HP Image Copy Job. To take these reports, run
   the HD Pointer Checker FABPMAIN job with HASH=NO.
   It is supported in the Single-Step HASH Check under HP Image
   Copy job.
   It is not supported in the following environments:
    - the Multiple-Step HASH Check.
    - the Concurrent Image Copy process
    - HASH Check option is called from the IMS Parallel
      Reorganization (IPR) job.
   CHAINDIST
   requests to print the Distribution of RAP Chain Lengths part in
   the DB Record Distribution Statistics report.
   It is printed for HDAM or PHDAM database.
   Randomizer module is used for this option. Specify the data set
   name containing the randomizer module to the STEPLIB DD
   statement.
   If a segment edit/compression exit routine is defined to a root
   segment, the segment edit/compression exit module is used for
   this option. Specify the data set name containing the segment
   edit/compression exit to the STEPLIB DD statement
   It is supported in the Single-Step HASH Check under HP Image
   Copy job.
   It is not supported in the following environments:
    - The Multiple-Step HASH Check.
    - The Concurrent Image Copy process
    - HASH Check option is called form the IMS Parallel
      Reorganization (IPR) job.
   COMPFACT
   requests to print the Compression Factor in the Partition
   Statistics report and the Database Statistics report.
   A segment edit/compression routine is used for this option.
   Specify the data set name containing the exit load module to
   the  STEPLIB DD statement.
   It is supported in the Single-Step HASH Check under HP Image
   Copy job.
   It is not supported in the following environments:
    - the Multiple-Step HASH Check.
    - the Concurrent Image Copy process
    - HASH Check option is called form the IMS Parallel
      Reorganization (IPR) job
   SEGIO
   requests to print the Rate of Segment I/O occurrence part in
   the Partition statistics report and the Database Statistics
   report. It is available for HDAM, HIDAM, PHDAM, and PHIDAM
   databases. If SEGIO is specified to the other database than the
   above, it is ignored.
   It is supported in the Single-Step HASH Check under HP Image
   Copy job.
   It is not supported in the Multiple-Step HASH Check.
   VLSSUMM
   requests to print the Summary of VL Segment Sizes in the
   Partition Statistics Report and Database Statistics Report.
   It is supported in the Single-Step HASH Check under HP Image
   Copy job.
   It is not supported in the Multiple-Step HASH Check.
   If VLSSUMM is specified to some database data sets, this option
   is effective to all of database data sets.
   2.3.5.51  TIMECHK=
   --------------------------------------------------------------
   Add the following description to TIMECHK= keyword parameter:
  ADD:
      :
   N specifies that the HPIC Recovery function is not to compare :
     the time stamp data in the header record of the input image
     copy data set with that in the DBRC record. If the input
     image copy data set is the same as the concurrent image copy
     (CIC), IMECHK=N is ignored.
   Note: TIMECHK keyword is not effect for following type of
   image copy data set.
     - Online Image Copy
     - IC2 Image Copy
      :
   2.3.5.52  TIMESTMP=
   --------------------------------------------------------------
   Add the following description to TIMESTMP= keyword parameter:
  ADD:
     :
   LASTICALL
     requests the recovery or the create image copy
     function using the latest batch image copy or SMSNOIC stored
     in the DBRC as input.
     :
   2.3.5.63 WAITTIME=
   --------------------------------------------------------------
   Add the following new options to WAITTIME keyword parameter:
  ADD:
   This keyword specifies the wait time for repeating the dynamic
   allocation on the tape unit when the dynamic allocation reason
   code (SVC99) is 214, 220, 228 or 484.
   +---------------------------------------------------------+
   | WAITTIME=nnnn|(nnnn,CANCEL|CANGO)|(,CANCEL|CANGO)       +
   +---------------------------------------------------------+
     :
   CANCEL|CANGO
     specifies whether to retry dynamic allocation or not when
     the reason code is 484.
     CANCEL does not retry dynamic allocation when the reason
            code is 484
     CANGO  retry dynamic allocation when the reason code is 484
     :
   2.3.5.64 WAITMSG=
   --------------------------------------------------------------
   Change the description for WAITMSG= keyword parameter:
  Change:
    This keyword specifies whether to display the FABJ3929A WTO
    message on the operator console or not, when dynamic
    allocation is being performed on the tape unit. This keyword
    is effective for the dynamic allocation (SVC99) reason codes
    214, 220, 228 and 484.
    :
    If WAITTIME=0 is specified, this keyword does not work.
    When CANGO is specified for the WAITTIME and the reason code
    of dynamic allocation is 484, the FABJ3929A WTO message is
    displayed even if WAITMSG=N is specified.
    :
  -------------------------------------------
  3. Site Default Generation Utility
  3.2 Generations a Site Default Table
  3.2.2 Input
  --------------------------------------------------
  The keywords for the Site Default Generation utility are as
  follows:
         :
    - HOMECHK
    - TIMESTMP
    - WAITALLOC
         :
    Allowed parameter of TIMESTMP keyword in the Site Default is
    LASTIC or LASTICALL only.
  ---------------------------------------------------
  Appendix A. Return Codes, Abend Codes, and Messages
  ---------------------------------------------------
  FABJ3930W TIMESTMP=LASTIC OR LASTICALL IS REQUIRED FOR
            TIMECHK=NO. TIMECHK IS IG IGNORED
  Explanation: TIMECHECK=YES is ignored, because requested
  recovery type is TIMESTMP=LASTIC or TIMESTMP=LASTICALL.
  When the TIMESTAMP=LAST or TIMESTMP=LASTICALL is requested,
  TIMECHK=NO is used.
  System Action: Program FABJMAIN continues the processing.
  

Temporary fix

Comments

APAR Information

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

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

  UK09262

Modules/Macros

• FABJACQG FABJBLKD FABJCMDB FABJCRC0 FABJCRC1
  FABJCRC3 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS 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 FABJGLRP FABJICDD
  FABJINT1 FABJINT2 FABJIPRC FABJLINK FABJMAIN FABJMAS1 FABJMDPN
  FABJMDP7 FABJMDP8 FABJMDP9 FABJMRGE FABJMSGC FABJNTFC FABJORCN
  FABJORC7 FABJORC8 FABJORC9 FABJPARM FABJPRM2 FABJRCHK FABJRCH7
  FABJRCH8 FABJRCH9 FABJRDB7 FABJRDB8 FABJRDB9 FABJRFCN FABJRFC7
  FABJRFC8 FABJRFC9 FABJRPC0 FABJRPT0 FABJSAS2 FABJSTA  FABJSTMD
  FABJTERM FABJTGEN FABJTOI  FABJUIC1 FABJXCR  FABJXHPC FABJXLIM
  FABUITCT H1J0410J
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R410 PSY UK09262

     UP05/11/22 P F511

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.