PK93925: SUPPORT MULTIPLE AREAS PROCESSING FOR ONLINE POINTER CHECKER

APAR status

• Closed as new function.

Error description

• This APAR will enhance Online Pointer Checker to process
  multiple areas serially within a single step.
  
  This issue is implemented as a result of FITS requirement
  MR0604084757.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of High Performance Fast Path      *
  *                 Utilities Fast Path Online Tools Version 3   *
  *                 Release 2 (FMID: H31A320).                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Online Pointer Checker (OPC) supports   *
  *                      multiple areas processing within a      *
  *                      single job step.                        *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR addresses the following enhancements:
  1. Support OPC to process multiple areas serially within a
  single job step.
  2. Support OPC, ODE and ODM to process the remaining areas even
  though an error is encounted during processing.
  3. Support OPC to generate image copy using IMS High Performance
  Image Copy.
  4. Support OPC, ODE, ODM and OER to generate a new Process
  Summary Report that summarizes the processing result of each
  area.
  
  This issue is implemented as a result of FITS requirement
  MR0604084757.
  

Problem conclusion

Temporary fix

Comments

• 1. This APAR allows OPC 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 control statement in FPXIN DD, OPC process
  them serially.
  
  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 error that is specific to the area
  in process. If PROC_AFT_ERROR=NEXTAREA is specified, the job
  step continues to process the remaining areas after encoutering
  an error that is specific to the area in process.
  .ANALYZE control statement
  .EXTRACT 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.
  
  3. To use IMS High Performance Image Copy to generate image
  copy during the OPC processing, specify IC=(YES,ICEDD) in
  ANALYZE control statement. For multiple areas processing,
  OPC only allows getnerating image copy using IMS High
  Performance Image Copy.
  
  4. OPC, ODE, ODM and OER generate a new Process Summary Report
  that summarizes the processing result of each area. To store
  the new report in the IMS Tools KB repository, see 1.1.7 Support
  for IMS Tools KB, 1. Register IMS HPFPU with IMS Tools KB.
  
  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
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Version 3 Release 2 (SC18-9869-04).
  About DOCUMENTATION CHANGE, See
  http://www-01.ibm.com/support/docview.wss?rs=434&context=SSZJXP
  &context=SSUSPA&context=SSUSPS&q1=SC18-9869-04&uid=swg27015322
  &loc=en_US&cs=utf-8&lang=en
  

APAR Information

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

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

  UK53196

Modules/Macros

•    FPXAHPIT FPXAHPI0 FPXALIC0 FPXALIF0 FPXALTM0
  FPXANAL0 FPXANTF0 FPXAOFP0 FPXAOPC0 FPXAPIV0 FPXAPRCA FPXAPRCB
  FPXAPRC0 FPXAPRC8 FPXAPRC9 FPXAPSA0 FPXAPSD0 FPXAPST0 FPXAPUW0
  FPXAQAN0 FPXAQPR0 FPXAQWRK FPXAREA0 FPXASNP1 FPXASNP2 FPXATALA
  FPXATALB FPXATAL0 FPXATAL8 FPXATAL9 FPXATA00 FPXATER0 FPXATF00
  FPXATJ0A FPXATJ0B FPXATJ00 FPXATJ08 FPXATJ09 FPXATMCB FPXATMC0
  FPXATMDB FPXATMD0 FPXATO00 FPXATQD0 FPXATQ00 FPXATWRK FPXAUCS0
  FPXAUIOB FPXAUIO0 FPXAXRT0 FPXA0000 FPXCONS0 FPXDCCS0 FPXDCEX0
  FPXDCFP0 FPXDCPR0 FPXDCTL0 FPXDCWRK FPXDDRVA FPXDDRVB FPXDDRV0
  FPXDDRV8 FPXDDRV9 FPXDEC00 FPXDEDCB FPXDEDC0 FPXDED2A FPXDED2B
  FPXDED20 FPXDED28 FPXDED29 FPXDEIOB FPXDEIO0 FPXDEMCB FPXDEMC0
  FPXDEMDB FPXDEMD0 FPXDEWRK FPXDEXC0 FPXDEXE0 FPXDPST0 FPXDRIVA
  FPXDRIVB FPXDRIV0 FPXDRIV8 FPXDRIV9 FPXDTER0 FPXD0000 FPXINITA
  FPXINITB FPXINIT0 FPXINIT8 FPXINIT9 FPXMBLK  FPXMBLK0 FPXMCDM0
  FPXMCPR0 FPXMDMLA FPXMDMLB FPXMDML0 FPXMDML8 FPXMDML9 FPXMOC00
  FPXMODE0 FPXMODS0 FPXMOIOB FPXMOIO0 FPXMOMCB FPXMOMC0 FPXMOMDB
  FPXMOMD0 FPXMOWRK FPXMPST0 FPXMSG00 FPXMTER0 FPXMUCM0 FPXM0000
  FPXPANA0 FPXPCTL0 FPXPDRVA FPXPDRVB FPXPDRV0 FPXPDRV8 FPXPDRV9
  FPXPPRC0 FPXTERMA FPXTERMB FPXTERM0 FPXTERM8 FPXTERM9 FPXUAI2A
  FPXUAI2B FPXUAI20 FPXUAI28 FPXUAI29 FPXUALST FPXUDBR0 FPXUDSI
  FPXUHPI0 FPXUICT  FPXUITB  FPXUITB0 FPXUMOD  FPXUMOD0 FPXUNTY0
  FPXUPPE0 FPXUPSR0 FPXUPTM0 FPXUREQ  FPXUREQ0 FPXUSIT0 FPXUXIN0
  FPXXAR10 FPXXCAR0 FPXXCCS0 FPXXCPR0 FPXXCPT0 FPXXCRE0 FPXXCTL0
  FPXXGIOB FPXXGIO0 FPXXGMDB FPXXGMD0 FPXXGRGB FPXXGRG0 FPXXGWRK
  FPXXRA00 FPXXRC00 FPXXRGA0 FPXXRGE0 FPXXRGM0 FPXXRG00 FPXXRP0A
  FPXXRP0B FPXXRP00 FPXXRP08 FPXXRP09 FPXXUALA FPXXUALB FPXXUAL0
  FPXXUAL8 FPXXUAL9 FPXXUPS0 FPXXUWRK HFPGHKI0 HFPGPRS0 HFPGPST
  HFPGRPT  HFPLANA0 HFPQACT0 HFPQAMA0 HFPQARCA HFPQARCB HFPQARCM
  HFPQARC8 HFPQARC9 HFPQATR0 HFPQA5E0 HFPQA5I0 HFPQA500 HFPQFAH0
  HFPQFAN0 HFPQGCIA HFPQGCIB HFPQGCIM HFPQGCI8 HFPQGCI9 HFPQMAI0
  HFPQMES0 HFPQUBLK HFPQUTHA HFPQUTHB HFPQUTHM HFPQUTH8 HFPQUTH9
  HFPUEST0 HFPUMVT0 HFPZMCT  HFPZMVT  H31A320J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK53196

     UP09/12/29 P F912