PQ97705: DUE TO A FPB ENHANCEMENT, FABCRMIF LOST THE ABILITY TO PROCESS PLURAL DEDB'S SERIALLY AFTER FPB UNLOAD.

APAR status

• Closed as program error.

Error description

• Due to the multiple INIT calls enhancement of FPB, FABCRMIF
  lost the ability to process plural DEDB's serially in one
  application.
  Forward fit of APAR PQ92528.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All FP Basic Tools Version 2 Release 1       *
  *                 users who use the FABCRMIF interface.        *
  *                 (FMID: H31A210)                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: Forward Fit of APAR PQ92528.            *
  *                      User program which use FABCRMIF to      *
  *                      process nearly 100 DBDs serially,       *
  *                      didn't work expectedly in HPFP          *
  *                      environment, though it worked in DBT    *
  *                      V2.3 environment.                       *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  User program which use FABCRMIF to process nearly 100 DBDs
  serially, didn't work expectedly in HPFP environment, though
  this program worked in DBT V2.3 environment.
  

Problem conclusion

• Due to the multiple INIT calls enhancement of FPB, FABCRMIF
  lost the ability to process plural DEDBs serially in one
  application, and it is impossible to recover its ability
  without spoiling that enhancement. To resolve the problem,
  FABCRMIF of DBT V2.3 is revived by another name and use it when
  processing plural DEDBs serially.
  
  Following two new modules are introduced:
  
  FABDRMI0: This module is the application interface to invoke
            FABCRMIZ.
            This module has following entries which equate to the
            FABDRMI0.
            - FABARMIF
            - FABBRMIF
            - FABCRMIF
  
  FABCRMIZ: This module is the copy of FABURMIF of DBT V2.3 and
            is the interface to invoke an the IMS/VS DEDB
            randomizing module.
  
  ---------------------------------------------------------------
  Documentation Changes:
  The IMS High Performance Fast Path Utilities for z/OS
  User's Guide Volume 2: Fast Path Basic Tools (SC18-9238-00)
  should be added or changed as follows:
  
  Appendix S. Fast Path Basic Tools - Invoking An IMS DEDB
  Randomizing Module
  
  The following description should be added to the bottom of
  the Appendix S.
  
   DBT V2 Application that Process Multiple DEDBs Sequentially
  
    For DBT V2 application that issues multiple combinations of
    INIT and CALC calls to process multiple DEDBs sequentially,
    it is necessary that FABDRMI0 must be link-edited into
    the application instead of FABARMIF, FABBRMIF, or FABCRMIF.
  
    In a CALC call for FABDRMI0, the 6th parameter, DBD name,
    is not effective if specified, and the CALC call is
    performed for the DEDB that was specified in the INIT call
    issued just before the CALC call.
  
  Appendix X. Fast Path Basic Tools - Messages and Codes
  FABC Messages
  
  The word FABCRMIF should be changed to FABCRMIF/FABDRMI0 in the
  message text, Explanation, the System Action,
  and the Programmer Response sections of following messages:
  
  FABD3650E, FABD3651E, FABD3652E, FABD3653E, FABD3654E,
  FABD3661E, FABD3662E, FABD3663E, FABD3664E, FABD3665E
  FABD3666E, FABD3667E, FABD3670E
  
  FABD3671E message should be changed as follows:
  
  FABD3671E LOAD FAILED FOR LOAD MODULE FABCRMIX/FABCRMIZ
             (ABEND Sxxx / REASON CODE xxxxxxxx)
  Explanation: FABCRMIF/FABDRMI0/FABDRMIF issued an SVC 8 (LOAD)
  to bring into storage a copy of FABCRMIX/FABCRMIZ.
  The return code received from OS means that the attempt failed.
  that the attempt failed. The return code (reason code) and abend
  code returned by OS are shown in the message.
  
  System Action: FABCRMIF/FABDRMI0/FABDRMIF ends with an abend
  code of 4011.
  
  Programmer Response:  Make sure that the FP Basic Tools load
  module library is concatenated to the JOBLIB/STEPLIB DD
  statement. If it is concatenated, refer to MVS Programming:
  Assembler Services Reference for a further explanation of
  the problem. Correct any errors, and rerun the job.
  210Y
  FABALINK
  FABCRMIZ
  FABDRMI0
  H31A210J
  

Temporary fix

Comments

APAR Information

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

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

  UQ95685

Modules/Macros

•    FABALINK FABCRMIZ FABDRMI0 H31A210J
  

Fix information

• Fixed component name

  IMS HP FP UTILI

• Fixed component ID

  5655K9400

Applicable component levels

• R210 PSY UQ95685

     UP04/12/06 P F412