PK71259: ENHANCING THE FPA ANALYZE FUNCTION

APAR status

• Closed as new function.

Error description

• This APAR will enhance the Fast Path Advanced Tool (FPA) ANALYZE
  function in two areas as follows:
  1. Not having different SORTWORK DDNAMEs for areas when running
     ANALYZE.
  2. A new keyword so ANALYZE will complete even if there are more
     than 100 errors.
  
  This is a forward fit of HPFPU V3R1 FPA APAR PK57322.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of Fast Path Advanced Tool         *
  *                 Version 3 Release 2. (FMID: H31A320)         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit APAR of FPA V3R1 PK57322.   *
  *                      This APAR will enhance the Fast Path    *
  *                      Advanced Tool (FPA) ANALYZE function    *
  *                      in two areas as follows:                *
  *                      1. Not having different SORTWORK        *
  *                         DDNAMEs for areas when running       *
  *                         ANALYZE.                             *
  *                      2. A new keyword so ANALYZE will        *
  *                         complete even if there are more      *
  *                         than 100 errors.                     *
  *                      These issues are implemented as a       *
  *                      result of FITS requirements             *
  *                      MR065072946 and MR060507457.            *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Forward Fit APAR of FPA V3R1 PK57322.
  1. When running ANALYZE function, there is a naming rule
     depending on area number for the DDNAMEs for SORTWORKs.
     This is creating a problem when having a general procedure
     that is used for ANALYZE. Putting hundreds of SORTWORK DD
     cards in the procedure is not a good idea.
  2. When running ANALYZE, it is not finished if more than 100
     errors are detected. A new keyword requested so ANALYZE will
     finish even if more than 100 errors are detected.
  

Problem conclusion

Temporary fix

Comments

• 1. ANALYZE function has been modified to accept the DDNAMEs for
     SORTWORKs depending on the ATASKCTL.
  2. ANALYZE function has been modified not to finish even if more
     than 100 errors are detected.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 1:Fast Path Advanced Tool Version 3 Release 2
  (SC18-9869-03) should be changed as follows:
  
  Chapter 2.Fast Path Advanced Tool
    Job control language(JCL)
      DD statements Input/Output
  
      itttWKnn DD
  
        An optional DD statement for PTRCHKLVL=FULL that is used
        with the RELOAD, CHANGE, and ANALYZE commands. These are
        intermediate storage data sets that are used by DFSORT.
        For more information about coding the SORTWKnn DD
        statements, see DFSORT Application Programming Guide.
        Allocating twice the space used by the SORTIN data set is
        usually adequate for each work data set.
  
        The naming rules of the ddnames are as follows:
  
          i: The thousands digit of the area number of the area
  |          to be analyzed or the thousands digit of ATASKCTL.
           A, D, G and J:
  |          If the number of area to be analyzed or the number
  |          of ATASKCTL is 999 or less.
           B, E, H and K:
  |          If the number of area to be analyzed or the number
  |          of ATASKCTL is from 1000 to 1999.
           C, F, I and L:
  |          If the number of area to be analyzed or the number
  |          of ATASKCTL is from 2000 to 2048.
          ttt: The hundreds digit of the area number of the area
  |          to be analyzed or the nunndreds digit of ATASKCTL.
          nn: The number of the SORT work data sets. This value
             must be from 01 to 06.
  
       Notes on dynamic allocation:
          If this statement is not specified in the JCL statement
          when these data sets are necessary, FPA allocates them
          dynamically.
  
  
  Appendix A.Command reference
  
  The following description should be added.
  
    MAXERROR
      Use this keyword to specify the maximum number of
      pointer errors that might be encountered before
      ANALYZE process terminates.
  
      MAXERROR is an optional keyword for the following commands:
  
          ANALYZE
          CHANGE
          RELOAD
  
      Related keywords: none
  
          Format:
      -----------------------------------------------------------
     |  MAXERROR=parameter                                       |
      -----------------------------------------------------------
  
        parameter
            Specify a value from 0 to 999. If 0 is specified,
            there is no maximum number of errors.
  
      Default:
          MAXERROR=100
          This keyword can be specified for the site default.
  
  Appendix H. Message and codes
  
    HFPU3042E INSUFFICIENT TABLE STORAGE FOR: xxxxxxxx,
              TCT: tctname, MODULE: modulename,
              REQUEST LENGTH: nnnnnnnnn
              - OLD TABLE ADDRESS: xxxxxxxx, HEADER: xx..xx
    Explanation: Program HFPMAIN0 was unable to obtain
    sufficient virtual storage.
    System action: The job ends with an abend code of U3042.
    Programmer response: Correct the errors, and rerun
    the job. If this situation persists, contact IBM Software
    Support.
  
    HFPU3043E TABLE STORAGE RELEASE FAILURE FOR: xxxxxxxx,
              TCT: tctname, MODULE: modulename
              - TABLE ADDRESS: xxxxxxxx, HEADER: xx..xx
    Explanation: Program HFPMAIN0 was unable to release
    virtual storage.
    System action: The job ends with an abend code of U3043.
    Programmer response: Correct the errors, and rerun
    the job. If this situation persists, contact IBM Software
    Support.
  

APAR Information

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

  PK57322

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

  UK40386

Modules/Macros

•    HFPAINI0 HFPAMAN0 HFPAST40 HFPA1DC0 HFPA1IN0
  HFPA1P10 HFPA1RP0 HFPA1SD0 HFPA1TR0 HFPA3BT0 HFPA3MS0 HFPA3MT0
  HFPA3MX0 HFPA3SI0 HFPA3SM0 HFPA3SS0 HFPA3SWK HFPA3S00 HFPA30WK
  HFPA3000 HFPA4000 HFPCCDT0 HFPCDEF0 HFPFACC0 HFPFATI0 HFPLCC30
  HFPQAIN0 HFPQAMA0 HFPQA1I0 HFPQA400 HFPQFAC0 HFPQFAD0 HFPUMVT0
  HFPUROB0 HFPUTBL  HFPUTBL0 HFPWMTU0 HFPZACC  HFPZATT  HFPZCCTA
  HFPZMVT  HFPZROB  HFPZTTT  H31A320J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK40386

     UP08/10/07 P F810