OA62439: $HASP095 JES2 CATASTROPHIC ERROR CODE = $DP2 IF EXIT51 INTRODUCES $WAIT FOR A JOBGROUP

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• If an installation has an exit51 that introduces a $WAIT during
  Conversion processing (such as if the exit does a $CBIO), then a
  CATASTROPHIC ERROR CODE = $DP2 can occur when the exit processes
  a JOBGROUP.
  
  The normal processing path through Conversion in IBM JES2 code
  will not introduce such a $WAIT; thus there is no exposure.
  This timing window is specific to installation exits (such
  as exit51) or usermods that introduce a $WAIT in Conversion
  while a JOBGROUP is being processed.
  
  ANALYSIS:
  The $DP2 error indicates that a $WAIT occurred while the linkage
  stack contains data.  The JES2 module (HASCJZDN) responsible for
  processing JOBGROUPs creates linkage stack entries under the
  JES2 main task.  When HASCJZDN issue a $QPUT, this will lead to
  exit51 being invoked.  If exit51 introduces a $WAIT (such as by
  doing a $CBIO), then the $DP2 will result since entries exist on
  the linkage stack.
  
  KNOWN IMPACT:
  JES2 will recover and continue normal processing, but may lose
  the Converter PCE:
  $HASP072 RECOVERY IN PROGRESS
  *$HASP068 PARTIAL RECOVERY SUCCESSFUL - CNVT PCE ENDED
            JES2 CONTINUES WITHOUT JCL CONVERTER.  x OF y CNVT
            PCES REMAIN.
  
  VERIFICATION STEPS:
  1) Exit51 active and the exit issues a $CBIO
  2) JOBGROUP is submitted
  3) $DP2 error during Conversion
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of HJE77B0, HJE77C0, and                           *
  * HJE77D0 who utilize JOBGROUP or                              *
  * //*NET dependency networks and                               *
  * customize $QMOD processing via                               *
  * Exit 51.                                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * When a job participating in a job                            *
  * dependency network changes phases, a                         *
  * $DP2 JES2 CATASTROPHIC ERROR may                             *
  * occur when the job is processed by                           *
  * Exit 51.                                                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In the HASCJZDN module, code which utilizes the linkage stack
  for saving registers does not consider that an
  installation-defined Exit 51 routine may result in a call to
  $WAIT, which is unable to tolerate the existence of entries
  on the linkage stack.
  

Problem conclusion

• TYPE/RESTART (WARM) IPL/REQUIRED (YES) CLPA (YES)
  
  CLPA is needed only if HASCxxxx modules currently reside in
  the pageable link pack area (PLPA).
  
  Code running in the HASCJZDN module has been updated to
  avoid usage of the linkage stack while changing the phase
  of a job participating in a JOBGROUP or //*NET dependency
  network.
  
  APAR OA62439 prereq's (and sup's) for FMID HJE77B0:
  Pre's: BA52887 BA56208 BA59033
  
  APAR OA62439 prereq's (and sup's) for FMID HJE77C0:
  Pre's: CA59033
  
  APAR OA62439 prereq's (and sup's) for FMID HJE77D0:
  Pre's: * NONE *
  

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:

  UJ08142 UJ08143 UJ08144

Modules/Macros

• HASPXEQ  HASPJOS  HASPSXJB $JZDN    $CADDR   HASPCNVT HASCSISC
  HASPJQS  HASPWARM HASPCOMM HASPMISC HASPSXIT $XIT     HASCJZDN
  HASMCADR HASCSRIP HASCPCYC
  

Fix information

• Fixed component name

  JES2

• Fixed component ID

  5752SC1BH

Applicable component levels

• R7B0 PSY UJ08142

     UP22/04/27 P F204

• R7C0 PSY UJ08143

     UP22/04/27 P F204

• R7D0 PSY UJ08144

     UP22/04/27 P F204

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.