PM11303: ONLINE DATA EXTRACT GETS ABENDS0C1

APAR status

• Closed as program error.

Error description

• Online Data Extract gets ABEND0C1 when it is dealt a DB that
  used SRG for the randomizer.
  One S0C1 that showed as a result of this is out of IMS's
  DFSRRC10 at x'1b8'.
  
  This is a forward fit of HPFPU FPO V3R1 APAR PM11116.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All Online Data Extract users of High        *
  *                 Performance Fast Path Utilities FP Online    *
  *                 Tools Version 3 Release 2 (FMID: H31A320).   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit APAR of HPFPU V3R1 FPO      *
  *                      PM11116.                                *
  *                      Abend SOC1 occurs at X'1B8' of the IMS  *
  *                      DFSRRC10 module when Online Data        *
  *                      Extract (ODE) processes a DEDB          *
  *                      that uses SRG for randomizer.           *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Forward Fit APAR of HPFPU V3R1 FPO PM11116.
  If the selection criteria specify the root segment, and the
  specification is an equal compare on the entire key field,
  ODE invokes the randomizer and determines which UOWs must be
  read to satisfy the selection criteria.
  On entry to a non-XCI randomizer, ODE sets 0 for register 10 and
  -1 for register 11. But register 10 must contain -1 and register
  11 must contain 0. The ABENDS0C1 or other system abend can occur
  if the randomizer that is used for the database expects specific
  values in registers 10 and 11.
  

Problem conclusion

• The module FPXVPRM1 is modified to set -1 for register 10,
  and 0 for register 11.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Version 3 Release 2 (SC18-9869-04).
  
  4.3 Extracting a DEDB online with FPO
  4.3.2 Restrictions of ODE
  
  The following restriction should be added:
  
   | . If the selection criteria specify the root segment,
   | and the specification is an equal compare on the entire
   | key field, ODE invokes the randomizer and determines which
   | UOWs must be read to satisfy the selection criteria.
   | When a randomizer is invoked by IMS, register 10 contains
   | the address of the EPST, and register 11 contains the
   | address of the ESCD. Some user-written or user-customized
   | randomizers are designed to use these addresses to gain
   | access to IMS control blocks other than those passed as
   | part of the published interface. When ODE issues a call
   | to a randomizing module, register 10 is set to -1 and
   | register 11 is set to 0.
  
  4.3.6 DD statements for ODE
  
    STEPLIB DD
  
     The following paragraph should be added as follows:
  
     Describes the library that contains the ODE utility.
     The load library that contains the segment edit/compression
     routine must be concatenated when the EXPAND keyword is
     specified in the FPXCTL statement.
   | Considerations for calling a randomizer through batch
   | interface:
   | If the database uses a randomizer that uses a table or
   | another load module, you must specify the load module library
   | that contains the table or the load module. Such randomizers
   | include randomizers that were generated by IBM IMS Sequential
   | Randomizer Generator for z/OS as multiple modules
   | (SRTYPE=MULTI). For details of the batch interface for the
   | randomizer, see 4.3.2 "Restrictions of ODE".
  320Y
  FPXVPRM1
  

Temporary fix

Comments

APAR Information

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

  PM11116

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

  UK55799

Modules/Macros

•    FPXVPRM1
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK55799

     UP10/04/04 P F004