PK67422: ENHANCEMENT OF THE FABCUR1 USER EXIT ROUTINE PARAMETER LIST

APAR status

• Closed as new function.

Error description

• This APAR enhances the FABCUR1 user exit routine parameter list.
  
  This is a forward fit of HPFPU V3R1 FPB APAR PK66591.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All DEDB Unload users of High Performance    *
  *                 Fast Path Utilities FP Basic Tools           *
  *                 Version 3 Release 2 (FMID: H31A320).         *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit APAR of FPB V3R1 PK66591.   *
  *                      FPB Unload provides a new exit routine  *
  *                      interface for a user exit routine.      *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  Forward Fit APAR of FPB V3R1 PK66591.
  FPB Unload(FABCUR1) provides a new exit routine interface that
  includes the information that a user exit routine can call a
  randamizer.
  

Problem conclusion

Temporary fix

Comments

• FPB Unload(FABCUR1) provides the information that a user exit
  routine needs to call a randamizer only when EXITRTN=FABCRPCX
  is specified.
  When the exit routine is invoked, register 0 contains the
  address of a 9-address parameter list.
  
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS High Performance Fast Path Utilities for z/OS User's
  Guide Volume 2: Fast Path Basic Tools Version 3 Release 2
  (SC18-9870-03) should be added and changed as follows:
  
  
  Chapter 25. Exit routine option
    Exit routine overview
  |   When the exit routine FABCRPCX is specified in FPB Unload
  |   Reorg mode, FPB Unload passes the information to invoke the
  |   randomizer to the exit routine. FABCRPCX can validate the
  |   area number and RAP RBA of the segment stored in the AREA
  |   by comparing with those returned by the randomizer.
  |   FABCRPCX does not support the XCI randomizer interface for
  |   batch.
  
    Exit routine interface
  
  
  |   When the exit routine FABCRPCX is invoked in FPB Unload,
  |   register 0 contain the 9 parameter list
  |   (9 full-words).  Each parameter and value in the list is
  |   as follows:
  |
  |   Parameter 1
  |     Address of 8-byte randomizer module.
  |
  |   Parameter 2
  |     Entry point of randomizing module that FPB loaded from
  |     RMODLIB or JOBLIB/STEPLIB.
  |   Parameter 3
  |     Number of entiries in the MRMB(total number of
  |     AREAs int the DEDB).
  |
  |   Parameter 4
  |     Address of first MRMB the routine uses.
  |
  |   Parameter 5
  |     Size of an entry in the MRMB.
  |
  |   Parameter 6
  |     Total number of RAPs in the DEDB.
  |
  |   Parameter 7
  |     Address of 8-byte IMSID.
  |
  |   Parameter 8
  |     Value of RAP RBA.
  |
  |   Parameter 9
  |     Address of the area that contains the root key
  |     (LL + root key value).
  |
  |   Restriction
  |     The exit routine FABCRPCX must be specified in FPB Unload
  |     Reorg mode.
  
  
  
  Appendix O. FPB.Messages and codes
    FABC messages
      The following message should be added as follows:
  
  | FABC3914E - EXITRTN=FABCRPCX MUST BE SPECIFIED IN REORG MODE
  |
  | Explanation:The exit routine FABCRPCX was specified in
  | "Change mode".
  | System action: FABCUR1 abends with user code of 3914.
  | Programer response: Delete NEWACB DD statement, and rerun
  | the job.
  

APAR Information

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

  PK66591

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

  UK37738

Modules/Macros

•    FABAMOD0 FABCUR1U FABC1EOJ FABC1INI FABUTLMD
  UR#DUCT0 UR1WSTG0
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R320 PSY UK37738

     UP08/07/02 P F807