OA60578: RECOVERY FROM ISSUE ADDRESSED IN OA60574

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• APAR OA60574 addresses an issue with the NJEROUT command
  resulting in multiple JES3 abends. After the initial DM729/DM721
  abend(s), residual DM706 and DM711 abends may occur, related to
  JES3 recovery from the initial problem.
  
  ANALYSIS:
  After the initial DM729/DM721 abend(s) addressed by OA60574 have
  occurred, residual DM711 and DM706 abends are issued from.
  
  The DM711s occur because the NRSOUTOP bit is left on.  That
  indicates that the output data set is open.  That causes NJEROUT
  to skip the AOPEN and go directly to the ALOCATE, which fails
  because the data set is really closed.
  
  The DM706s are issued because no File Directory entry was found.
  In one scenario, the error is detected in ACLOSE processing,
  because there wasn't enough data to fill a buffer.  After the
  DM721/DM729 error is detected, the ACLOSE routine deletes the FD
  entry at label CLOSE50 before abending at CLOSE220.  NJEROUT
  tries to clean up, sees the output file open, and tries ACLOSE
  again.  The lack of an FD entry causes a DM706 abend to be
  issued. There are other possible scenarios, but the cause is the
  same: the FD entry was deleted at some point, and later an
  ACLOSE attempt got the DM706.
  
  KNOWN IMPACT:
  Following the initial DM729/DM721 abend(s) addressed by OA60574,
  residual abends occur.
  
  VERIFICATION STEPS:
  1. Issue the NJEROUT command.
  2. Initally, abend(s) DM729/DM721 is issued.
  3. Residual abend(s) (DM706, DM711) are issued.
  
  ADDITIONAL SYMPTOMS:
  ABENDDM711
  ABENDDM706 for any FCT
  
  The projected closing code is PER for HJS77B0 and above.
  

Local fix

• RECOVERY ACTION:
  Once the abends have been issued, the NJEROUT DSP should be able
  to be reinstated.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of HJS77B0 and HJS77C0.                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Repetitive abends in recovery for                            *
  * NJEROUT due to residual data.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  An abend occurred in module IATNTRS, which was processing a
  '*CALL NJEROUT' command.  During recovery, the ACLOSE service
  failed because module IATDMNC did not properly set up the
  File Description Block (FDB, IATYFDB) address before trying
  to locate the File Directory (FD, IATYFDD) entry.  This path
  left the NRSOUTOP bit (IATYNRS) on, indicating that the
  output data set was still open.  ABENDDM729 and ABENDDM706
  were issued.
  
  When IATNTRS processed subsequent jobs, it assumed that the
  data set was already open, and ABENDDM711 was issued when it
  tried to write to the data set.  ABENDDM706 was again issued
  when attempting to close the data set.  These failures were
  issued for all jobs eligible to be processed by NJEROUT.
  

Problem conclusion

• Installation On (Global)
               Order (Any)
  Activation   Order (Any)
               Type/JES3 restart (Hot)
               Type/IPL (None)
               CLPA (No)
  (See Apar II07968 for definitions)
  
  Module IATDMNC has been changed to properly load the FDB
  (IATYFDB) address before locating the FD (IATYFDD) entry.
  
  Module IATNTRS has been changed to reset the open file
  indicator NRSOUTOP (IATYNRS) before issuing ACLOSE.
  
  This APAR does not address the initial ABENDDM729, which is
  addressed by APAR OA60574.
  
  APAR OA60578 prereq's (and sup's) for FMID HJS77B0:
  Pre's: * NONE *
  APAR OA60578 prereq's (and sup's) for FMID HJS77C0:
  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:

  UJ04921 UJ04922

Modules/Macros

• IATNTRS  IATDMNC
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R7C0 PSY UJ04922

     UP21/03/03 P F103

• R7B0 PSY UJ04921

     UP21/03/03 P F103

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.