PI22667: SUPPORT FOR IMS V14

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• Support for IMS V14
  KEYWORDS: IMSV14TGT/K
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All FP Solution Pack Version 1 Release 3     *
  *                 users who use HPFPU with IMS Version 14.     *
  ****************************************************************
  * PROBLEM DESCRIPTION: This APAR enables HPFPU in FP Solution  *
  *                      Pack for z/OS Version 1 Release 3 to    *
  *                      run on IMS Version 14.                  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR addresses the following enhancements:
  
  1. HPFPU in FP Solution Pack V1R3 is changed to support IMS
  Version 14.
  
  2. Online Expert Reorganization (OER) and Online Space
  Management (OSM) support FP 64-bit buffers for IMS High-Speed
  DEDB Direct Reorganization utility.
  
  3. Fast Path Online Tools clears the obtained storage before
  it is used in case the Dirty Getmain trap is enabled.
  
  Also, this APAR addresses the following problems:
  
  4. Forward Fit APAR of the FPSP V1R2 APAR PI23537
  
  HPFPU Hash Check support for IMS Database Recovery Facility
  (DRF) temporarily turned off the top bit of FSE in the CI
  record buffer, then IMS HP Image Copy output image copy before
  the top bit of FSE was returned on. When the incorrect image
  copy that had been generated during 1st DRF run was used as an
  input for 2nd DRF run, HPFPU Hash Check support issued FABA4011W
  and FABA4023E messages due to the incorrect top bit of FSE.
  
  5. Forward Fit APAR of the FPSP V1R2 APAR PI24569
  
  Fast Path Advanced Tool (FPA) checked APF auth libraries without
  converting the volume name when it is defined as a system
  symbol, it issued HFPM3061E error message.
  

Problem conclusion

Temporary fix

Comments

• 1. All tools and utilities in HPFPU support IMS Version 14.
  2. OER and OSM support FP 64-bit buffers for IMS High-Speed
  DEDB Direct Reorganization utility.
  3. FPO clears the obtained storage before it is used in case
  the Dirty Getmain trap is enabled.
  4. HPFPU Hash Check support for IMS Database Recovery Facility
  has been modified not to turn off the top bit of FSE in the CI
  record buffer.
  5. FPA has been modified to use ASASYMBM service (Substitute
  text for symbols) to convert the volume name that is defined
  as a system symbol.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 3
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-4010-01).
  
  >Part 1. Overview of IMS High Performance Fast Path Utilities
  >> Chapter 1. What is IMS HP Fast Path Utilities?
  >>> IMS HP Fast Path Utilities terminology
  
  - IMS Version 11 refers to IBM IMS Version 11 Release 1.
  - IMS Version 12 refers to IBM IMS Version 12 Release 1 and
    IBM IMS Database Value Unit Edition Version 12 Release 1.
  - IMS Version 13 refers to IBM IMS Version 13 Release 1 and
    IBM IMS Database Value Unit Edition Version 13 Release 1.
   | - IMS Version 14 refers to IBM IMS Version 14 Release 1 and
   |   IBM IMS Database Value Unit Edition Version 14 Release 1.
  
  > Part 4. IMS Fast Path Online Tools
  >> Chapter 29. Reorganizing a DEDB online with FPO
  >>> Utility control statements for OER
  >>>> REORG statement keywords
  
  Table 134. REROG statement keywords
  
  Add the new keyword FPBP64U as follows:
  
  FPBP64U | Optional | Specifies whether to support FP 64-bit
                       buffers for IMS High-Speed DEDB Direct
                       Reorganization utility.
  
  
  > Part 4. IMS Fast Path Online Tools
  >> Chapter 31. Keyword reference for FPO
  >>> FPO keywords
  
  The following new keyword should be added.
  
   FPBP64U
  
    The FPBP64U keyword specifies whether to support FP 64-bit
    buffers for IMS High-Speed DEDB Direct Reorganization utility.
  
    FPBP64U is an optional keyword for the REORG statement of OER.
  
    Format:
                       +--- YES --+
                       |          |
     >>--- FPBP64U= ---+--- NO ---+---><
  
     The variable fields are defined as follows:
  
      NO   Do not support FP 64-bit buffers for IMS High-Speed
           DEDB Direct Reorganization utility.
      YES  Support FP 64-bit buffers for IMS High-Speed DEDB
           Direct Reorganization utility.
  
      Default: No, if the FPBP64U keyword is not specified.
      Site default support: Supported.
  
    Restrictions:
      FPBP64U=YES is valid only for IMS version 14 or higher.
  
  
  > Part 5. Online Space Management utility
  >> Chapter 39. JCL requirements for the  Online Space Management
  utility
  >>> SETREORGPARM subcommand keywords
  
  The following new keyword should be added.
  
   FPBP64U
  
    Use the FPBP64U keyword to support FP 64-bit buffers for
    IMS High-Speed DEDB Direct Reorganization utility.
  
    FPBP64U is an optional keyword for the SETREORGPARM
    subcommand.
  
    Related keywords: None.
  
                       +--- YES --+
                       |          |
     >>--- FPBP64U= ---+--- NO ---+---><
  
      NO   Do not support FP 64-bit buffers for IMS High-Speed
           DEDB Direct Reorganization utility.
      YES  Support FP 64-bit buffers for IMS High-Speed DEDB
           Direct Reorganization utility.
  
      Default: FPBP64U=NO
      Site default support: Supported.
  
    Restrictions:
      FPBP64U=YES is valid only for IMS version 14 or higher.
  
  
  
  > Part 8. Troubleshooting
  >> Chapter 59. Messages and codes of IMS HP Fast Path Utilities
  >>> Messages
  >>>> FPX messages
  
  Following new messages should be added.
  
  FPX0346I 64 bit storage used for utility private buffers.
  Explanation: OER supports FP 64-bit buffers for IMS High-Speed
  DEDB Direct Reorganization utility.
  System action: Processing continues.
  User response: This message is informational.
  
  FPX0347I FPBP64U=YES is not supported by the current IMS AP&#162;AR
  level.
  Explanation: OER supports FP 64-bit buffers for IMS High-Speed
  DEDB Direct Reorganization utility only for IMS Version 14 or
  higher.
  System action: Processing continues.
  User response: This message is informational.
  &#215;**** PE15/08/17 FIX IN ERROR. SEE APAR PI47029  FOR DESCRIPTION
  

APAR Information

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

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

  UI23956

Modules/Macros

• FABADA7  FABAGDD  FABAGVT0 FABAHSCA FABA1SB0
  FABBGDD  FABCGDD  FABCRMIL FABCRMIS FABCRMIU FABCRMIX FABCRM
  
  ***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

• R130 PSY UI23956

     UP14/12/19 P F412

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.