PM07840: SUPPORT MULITPLE AREAS PROCESSING FOR ONLINE POINTER CHECKER ANDONLINE EXPERT REORGANIZATION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• An enhancement of Online Pointer Checker (OPC) and Online Expert
  Reorganization (OER) to process multiple areas serially within
  a single step.
  This APAR will also correct an unreasonable statement in the
  sort control card for FPA ANALYZE.
  
  This is a forward fit of HPFPU V3.2 APARs PK93925, PM04069 and
  PM06841.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of Fast Path Solution Pack, HPFPU  *
  *                 Fast Path Online Tools Version 1 Release 1   *
  *                 (FMID: HAHQ110).                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: 1. Online Pointer Checker (OPC) and     *
  *                      Online Expert Reorganization (OER)      *
  *                      support multiple areas processing       *
  *                      within a single job step.               *
  *                      2. FPA ANALYZE specifies an             *
  *                      unreasonable value for LENGTH keyword   *
  *                      parameter of the DFSORT control card    *
  *                      that is used when REPORT subcommand     *
  *                      is specified.                           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Forward Fit APAR of HPFPU V3R2 FPO PK93925/PM04069 and
  FPA PM06841.
  1. This APAR addresses the following enhancements:
  1-1. Support OPC and OER to process multiple areas serially
  within a single job step.
  1-2. Support OPC, OER, ODE and ODM to process the remaining
  areas even though an area-specific error is encounted during
  processing.
  1-3. Support OPC and OER to generate image copy using IMS High
  Performance Image Copy.
  1-4. Support OPC, OER ODE and ODM to generate a new Process
  Summary Report that summarizes the processing result of each
  area.
  
  2. This APAR also modifies FPA ANALYZE to specify the valid
  value in LENGTH keyword parameter of DFSORT control card.
  FPA ANALYZE generates the sort control card that is used when
  REPORT subcommand is specified. FPA ANALYZE always sets "094"
  for the LENGTH keyword parameter of DFSORT. The value is valid
  when max segment level of the database is 15. But when max
  segment level of the database is less than 15, this vale is
  unreasonable.
  

Problem conclusion

Temporary fix

Comments

• 1-1. This APAR allows OPC and OER to specify multiple specific
  areas using AREA=(area1,area2,...) or all areas that are
  defined in DBD using AREA=ALL. If multiple areas are specifyed
  with AREA keyword of ANALYZE/REORG control statement in FPXIN
  DD, OPC/OER process them serially.
  
  1-2. A new keyword PROC_AFT_ERROR is added for the following
  control statement.If PROC_AFT_ERROR=STOP is specified, the job
  step stops on encountering an area-specific error.
  If PROC_AFT_ERROR=NEXTAREA is specified, the job step continues
  to process the remaining areas after encoutering an
  area-specific error.
  .ANALYZE control statement
  .EXTRACT control statement
  .REORG control statement
  .DMACPRT control statement
  Note: ODM continued to process the remaining areas even though
  an error that is specific to the area in process was detected.
  After this enhancement, the job step stops on encountering the
  error because the default value of PROC_AFT_ERROR is STOP. If
  you need ODM to work as before, PROC_AFT_ERROR=NEXTAREA should
  be specified.
  
  1-3.To use IMS High Performance Image Copy to generate image
  copy during the OPC processing, specify IC=(YES,ICEDD) in
  ANALYZE control statement. To use IMS High Performance Image
  Copy to generate image copy during the OPC processing that
  is running under OER, specify PTRCHK=YES in REORG control
  statement and IC=(YES,ICEDD) in PTRCHK control statement.
  For multiple areas processing, OPC and OER with OPC only
  allows getnerating image copy using IMS High Performance
  Image Copy.
  
  Here is an example JCL for running OPC for multiple areas and
  generating image copy using IMS HP Image Copy.
  
  //ANALYZE EXEC FPUTIL,DBD=DEDBJN23,IMSID=IMS1
  //STEPLIB DD DISP=SHR,DSN=HPFP.SHFPLMD0
  //        DD DISP=SHR,DSN=HPIC.SHPSLMD0
  //        DD DISP=SHR,DSN=IMS.SDFSRESL
  //FPXIN   DD *
   ANALYZE AREA=(DB23AR1,DB23AR2),
           FULLSTEP=YES,
           TYPRUN=RPT,
           IC=(YES,ICEIN),
           ICNOTIFY=YES
   REPORT  REPORTDD=FPXRPTS
  //ICEIN   DD *
    GLOBAL   COMP=Y,COMPRTN=FABJCMP4
    CIC      DBD=DEDBJN23,
             AREA=DB23AR1,
             ICOUT=ICOUT001
    CIC      DBD=DEDBJN23,
             AREA=DB23AR2,
             ICOUT=ICOUT002
  //FPXRPTS  DD SYSOUT=*
  //SYSOUT   DD SYSOUT=*
  //ICOUT001 DD DISP=SHR,DSN=HPFP.DB23AR1.IC
  //ICOUT002 DD DISP=SHR,DSN=HPFP.DB23AR2.IC
  
  1-4. OPC, OER, ODE and ODM generate a new Process Summary Report
  that summarizes the processing result of each area. If you will
  store reports in the IMS Tools KB repository for the first time
  or store the new report in the IMS Tools KB repository, for
  detailed registration process, see 1.1.7.1 Support for IMS Tools
  Knowledge Base.
  
  2. FPA ANALYZE has been modified to set a valid value for the
  LENGTH keyword parameter of DFSORT control card.
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 1
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-2914-00).
  
  For the documentation changes made by this APAR, see the product
  documentation updates page. You can find the product
  documentation updates page in the IMS Tools Library Web page
  (http://www-306.ibm.com/software/data/db2imstools/
  imstools-library.html) when the page is ready.
  

APAR Information

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

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

  UK55924

Modules/Macros

• FPXAB35A FPXAB35B FPXAB350 FPXAB359 FPXACIA0
  FPXAHPIT FPXAHPI0 FPXALIC0 FPXALIF0 FPXALTM0 FPXANAL0 FPXANT
  
  ***This field was truncated.  To obtain the full apar record, please contact your local support center.***
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R110 PSY UK55924

     UP10/04/14 P F004

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.