PK11775: SUPPORT SOME NEW FUNCTIONAL KEYWORDS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This is an enhancement APAR that introduces some new
  functional keywords for HPIC V3R2. The new keywords are
  related to new HPPC functions.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All IMS High Performance Image Copy for z/OS *
  *                 Version 3 Release 2 users ( FMID=H1J0320 )   *
  ****************************************************************
  * PROBLEM DESCRIPTION: HPIC provides new keyword HOMECHK= and  *
  *                      some new optional parameters of HDPC=   *
  *                      keyword that controls HASH Check        *
  *                      Reports.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  HPIC provides new keyword HOMECHK= and some new optional
  parameters of HDPC= keyword that controls HASH Check Reports.
  
  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.
  
  Following new optional parameters of HDPC= keyword controls
  HASH Check Reports.
  - VLSSUMM
  - DBDIST
  - CHAINDIST
  - COMPFACT
  - SEGIO
  
  APAR PK11923 is required to be applied to IMS High Performance
  Pointer Checker for z/OS Version 2 Release 1 ( FMID=HPC2210 ).
  
  If APAR PK11923 is not applied to IMS High Performance Pointer
  Checker for z/OS Version 2 Release 1, these new keyword and
  parameters are ignored.
  

Problem conclusion

Temporary fix

Comments

• FABJMAIN, FABJINT1, and FABUITCT have been modified to pass
  the HOMECHK value and HDPC value to HPPC.
  
  FABJPARM, FABJPRM2, FABJSTMD, FABJTGEN, FABJMRGE, and FABJBLKD
  have been to modified to support the new keyword HOMECHK= and
  new optional parameters of HDPC= keyword.
  
  The following modules have been reassembled.
    FABJACQG  FABJATRC  FABJCMDB  FABJCRC0  FABJCRC1  FABJCTCV
    FABJCZCV  FABJDALC  FABJDALO  FABJDALS  FABJDBCM  FABJDBC1
    FABJDBD7  FABJDBD8  FABJDBD9  FABJDBF0  FABJDBLK  FABJDBR7
    FABJDBR8  FABJDBR9  FABJDCTL  FABJDEMP  FABJDMP0  FABJDMP7
    FABJDMP8  FABJDMP9  FABJDOPN  FABJDPS7  FABJDPS8  FABJDPS9
    FABJDPUT  FABJDREQ  FABJDRQS  FABJICDD  FABJINT2  FABJIPRC
    FABJMAS1  FABJMDP7  FABJMDP8  FABJMDP9  FABJNTFC  FABJORC7
    FABJORC8  FABJORC9  FABJRCH7  FABJRCH8  FABJRCH9  FABJRDB7
    FABJRDB8  FABJRDB9  FABJRPT0  FABJSAS2  FABJTERM  FABJUIC1
    FABJXLIM  FABJDBDN  FABJDBRC  FABJDMPN  FABJDPSN  FABJMDPN
    FABJORCN  FABJRCHK
  
  The documentation is modified as follows:
  ==============================================================
  IMS High Performance Image Copy for z/OS, V3R2, User's Guide
  (SC18761701)
  ==============================================================
  
  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:
      :
    . HDPC=
    . HOMECHK=
    . ICBUF=
      :
  
    2.3.4.2 GROUP Statement
    Optional keywords:
      :
    . HDPC=
    . HOMECHK=
    . ICBUF=
      :
  
    2.3.4.3 IC/AIC Statement
    Optional keywords:
      :
    . HDPC=
    . HOMECHK=
    . ICBUF=
      :
  
  Add a new sub section about HOMECHK= 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) and
  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.
  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
  NO
  The DISTRIBUTION OF ROOT SEGMENTS is not printed.
  
  This is the default value. N can be used shortened forms of NO.
  
  ADD:
  --------------------------------------------------------------
  2.3 Input
  2.3.5     ICEIN Keywords
  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 following environments the
  Multiple-Step HASH Check.
  
  If VLSSUMM is specified to some database data sets, this option
  is effective to all of database data sets.
  

APAR Information

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

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

  UK08475

Modules/Macros

• FABJACQG FABJATRC FABJBLKD FABJCMDB FABJCRC0
  FABJCRC1 FABJCTCV FABJCZCV FABJDALC FABJDALO FABJDALS 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 FABJICDD FABJINT1
  FABJINT2 FABJIPRC FABJMAIN FABJMAS1 FABJMDPN FABJMDP7 FABJMDP8
  FABJMDP9 FABJMRGE FABJMSGC FABJNTFC FABJORCN FABJORC7 FABJORC8
  FABJORC9 FABJPARM FABJPRM2 FABJRCHK FABJRCH7 FABJRCH8 FABJRCH9
  FABJRDB7 FABJRDB8 FABJRDB9 FABJRPT0 FABJSAS2 FABJSTMD FABJTERM
  FABJTGEN FABJUIC1 FABJXLIM FABUITCT
  

Fix information

• Fixed component name

  IMS HP IMAGE CO

• Fixed component ID

  5655K9600

Applicable component levels

• R320 PSY UK08475

     UP05/10/28 P F510

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.