PK57710: ENHANCE FPO ODE TO SUPPORT FP RANDOMIZER XCI INTERFACE

APAR status

• Closed as new function.

Error description

• Enhance FPO ODE (Online Data Extract) to support the FP
  Randomizer XCI interface that was provided by IMS V10 PK40256.
  This is a forward fit of HPFPU V3R1 FPO APAR PK56199.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All using FP randomizer XCI interface for    *
  *                 users of High Performance Fast Path          *
  *                 Utilities Online Data Extract Version 3      *
  *                 Release 2 (FMID: H31A320).                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit APAR of FP0 V3R1 PK56199:   *
  *                      FPO ODE supports FP Randomizer XCI      *
  *                      interface for Batch provided by IMS V10 *
  *                      PK40256.                                *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Forward Fit APAR of FP0 V3R1 PK56199:
  FPO ODE supports FP Randomizer XCI interface for Batch
  provided by IMS V10 (5635-A01) PK40256.
  

Problem conclusion

Temporary fix

Comments

• ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 3: Fast Path Online Tools Version 3 Release 2
  (SC18-9871-03).
  
  Appendix G. Messages and codes
    Messages
  
  The following messages should be changed as follows:
  
    FPX0064W Randomizer is not loaded. Full area scan will be
             used.
    Explanation: The randomizer has not been loaded. A full area
    scan will be performed.
    System action: Processing continues and a full area scan will
  | be done. Processing ends with a return code of 4.
    User response: This is a warning message. Check that the
    randomizer is included in the load module in STEPLIB.
  
  ----------------------------------------------------------------
    FPX0065W Randomizer returned correct area # but invalid RAP
  |          number. Full area scan will be used.
  
    Explanation: The randomizer was successfully loaded and
    selected the proper DMAC; however, the RAP number was not
    within the RAA range.
  | System action: Processing continues and a full area scan will
  | be done. Processing ends with a return code of 4.
    User response: Determine the reason why this RAP number was
    not within the RAA range.
  
  ----------------------------------------------------------------
    FPX0067W Randomizer is AMODE(24). Must be AMODE(31).
  
    Explanation: The randomizer has been compiled/linked with
                 AMODE(24).
    System action: The utility detected that the randomizer is
    not 31-bit capable. Processing continues to build the
    performance optimized UOW list using the randomizer.
    IMS requires all randomizers to be 31-bit capable.
  | Processing ends with a return code of 4.
    User response: This is a warning message. If possible,
    determine the reason the randomizer is AMODE (24) and correct
    the problem.
  
  ----------------------------------------------------------------
  
  The following message should be added as follows:
  
    FPX0401W Error in call to randomizer routine rmodname
             FUNCTION: function name. Full area scan will be used.
     (cont)  RETURN CODE: xxx REASON CODE: X'xxxxxxxx'
  
    Explanation: Specified randomize module returned with error.
    FUNCTION and REASON CODE are issued only when XCI randomizer
    is called.
    System action: Processing continues and a full area scan will
    be done. Processing ends with a return code of 4.
    Programmer response: Check the randomizer that is loaded by
    IMS.
  

APAR Information

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

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

  UK32120

Modules/Macros

•    FPXDDRVA FPXDDRV0 FPXDDRV8 FPXDDRV9 FPXDRIVA
  FPXDRIV0 FPXDRIV8 FPXDRIV9 FPXMBLK  FPXMBLK0 FPXMSG00 FPXMXCI0
  FPXTERMA FPXTERM0 FPXTERM8 FPXTERM9 FPXUXCI  FPXVPRM1 H31A320J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK32120

     UP07/12/28 P F712