PM96636: IN RUNNING OPC WITH FULLSTEP=YES, ONLY ONE RETURN CODE GETS RETURNED AS IT IS ONLY ONE STEP WITH THAT MODE

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When using OPC with FULLSTEP=YES we only get one return code in
  that mode.  This could mask error run in subsequent steps such a
  as FABCUR3 and FABCUR5.
  As part of this change we're looking to provide a new keyword
  to give users control in calling FPXRCEX0 or not.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All user of Online Pointer Checker, Online   *
  *                 Expert Reorganization, and Online Data       *
  *                 Extract of HPFPU Fast Path Online Tools in   *
  *                 Fast Path Solution Pack Version 1 Release 2  *
  *                 (FMID: HAHQ120).                             *
  ****************************************************************
  * PROBLEM DESCRIPTION: OPC always calls FPXRCEX0 if it is      *
  *                      included in STEPLIB or JOBLIB.          *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  When the return code user exit routine FPXRCEX0 is included in
  STEPLIB or JOBLIB, OPC always calls it. For the OPC jobs using
  the same STEPLIB and JOBLIB, the user cannot control that some
  jobs call FPXRCEX0 and the other jobs don't call FPXRCEX0.
  

Problem conclusion

• OPC, OER and ODE have been modified to provide a new keyword
  RCEXLOAD. The RCEXLOAD keyword specifies whether to call
  FPXRCEX0.
  
  ========================
  = DOCUMENTATION CHANGE =
  ========================
  The IMS Fast Path Solution Pack for z/OS Version 1 Release 2
  IMS High Performance Fast Path Utilities User's Guide
  (SC19-3287-00).
  
  4.7 Keyword reference for FPO
  4.7.3 FPO keywords
  
   Add the new keyword.
  
   RCEXLOAD
  
   The RCEXLOAD keyword specifies whether to call the return
   code exit routine FPXRCEX0 from STEPLIB or JOBLIB.
  
   The RCEXLOAD keyword is an optional keyword for the following
   statements:
  
   . ANALYZE statement of OPC
   . REORG statement of OER
   . EXTRACT statement of ODE
  
   FORMAT
  
     +------------------------------------------------------+
     |                                                      |
     |  >>--- RCEXLOAD= --+-- YES --+------><               |
     |                    |         |                       |
     |                    +-- NO  --+                       |
     |                                                      |
     +------------------------------------------------------+
  
   The variable fields are defined as follows:
  
     YES: FPXRCEX0 will be called if it is included in STEPLIB or
          JOBLIB.
  
          You can specify just Y rather than YES.
  
     NO:  FPXRCEX0 will not be called even though it is included
          in STEPLIB or JOBLIB.
  
          You can specify just N rather than NO.
  
   Default: YES, if the RCEXLOAD keyword is not specified.
  
   Site default support: Supported.
  
   Restrictions:
     The RCEXLOAD keyword can be specified only in FPXIN.
  
  4.10 Return code user exit routine (FPXRCEX0)
  
  The following description should be modified:
  
  Before
  
  .If FPXRCEX0 is found by OPC, ODE, or OER, it will be called
  no matter what the return code is.
  
  After
  
  .If FPXRCEX0 is found by OPC, ODE, or OER, and RCEXLOAD=NO is
  not specified, it will be called no matter what the return code
  is.
  

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:

  UK98226

Modules/Macros

• FPXAOFP0 FPXAOPC0 FPXDEXA0 FPXDEXD0 FPXMBLK0 FPXUCA00 FPXUCKE0
  FPXUCPR0 FPXUIOB0 FPXXRGA0
  

Fix information

• Fixed component name

  IMS FP SOLUTION

• Fixed component ID

  5655W1400

Applicable component levels

• R120 PSY UK98226

     UP13/10/05 P F310

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.