OA60574: NJEROUT COMMAND RESULTS IN MULTIPLE JES3 ABENDS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• A NJEROUT command issued results in multiple JES3 abends
  (ABENDDM729, ABENDDM721, ABENDDM706, ABENDDM711, ABENDDM717).
  
  ANALYSIS:
  After the NJEROUT command is issued, several JES3 ABENDs occur.
  The initial DM729 abend was issued out of IATDMDT. Prior to the
  abend, JES3 was processing in module IATNTRS routine NTRSHSPL -
  SNA/TCP JH/DSH routine which attempts to write the job/dataset
  header to spool. The JES3 trace inidcates the issue is not
  really a DM729, but rather a DM721. TATCKPT calls DMDK via
  IATXSIO and if an error is detected it sets the value into R4.
  The JBTVLID is not '*stt ' in the JBT for JOB0, it is binary
  zeros. The NJEROUT command is picking up and trying to process
  J0 from the prior IPL and re-route it, but this error is
  detected when the NJEROUT process needs more spool space.
  
  NJEROUT specifies JOBNUM=NRSNJBN to assign an owner to the new
  data it writes to spool.  NRSNJBN is the new job number.  For
  job 0, NRSNJBN is not used, so it will contain 0.NRSNJBN is not
  cleared between jobs, or cleared for job 0, so the abend only
  occurs if job 0 is processed before any other job. It is
  necessary to assign new spool space for job 0 to the NJEROUT DSP
  
  
  KNOWN IMPACT:
  Multiple JES3 abends following issuing a NJEROUT command if Job
  0 is processed before other jobs.
  
  VERIFICATION STEPS:
  1. Issue NJEROUT command.
  2. Multiple JES3 abends are issued, likely DM729 and/or DM721,
  and possibly residual DM706, DM711, or DM717 abends.
  
  ADDITIONAL SYMPTOMS:
  ABENDDM721, ABENDDM706, ABENDDM711, ABENDDM717
  
  The projected closing code is PER for HJS77B0 and above.
  

Local fix

• RECOVERY ACTION:
  Once the original and residual abends have occured, the NJEROUT
  DSP should able to be reinstated.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * All users of HJS77B0 and HJS77C0.                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * ABENDDM729 in NJEROUT when                                   *
  * processing job 0 output.                                     *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A '*CALL NJEROUT' command was issued to reroute Network Job
  Entry (NJE) output.  The first output processed was for JES3
  job 0.
  
  Module IATNTDR opened an output data set using AOPEN and
  specified the new job number as the owner of the spool
  space.  The new job number does not apply to job 0, so the
  field was zero, and the spool space was assigned to job 0.
  
  When data was written to the output data set, module IATDMDK
  detected that the spool space was owned by job 0 but was not
  part of the Single Track Table (STT) and returned with an
  error code.  Module IATDMDT set an abend code of ABENDDM721.
  On a subsequent call, IATDMDT converted this to ABENDDM729,
  then failed NJEROUT.
  

Problem conclusion

• Installation On (Global)
               Order (Any)
  Activation   Order (Any)
               Type/JES3 restart (Hot/Command)
               Type/IPL (None)
               CLPA (No)
  (See Apar II07968 for definitions)
  
  Module IATNTRS has been changed to properly specify the owner
  of the spool space for job 0 to match the owner of the
  original data.
  
  APAR OA60574 prereq's (and sup's) for FMID HJS77B0:
  Pre's: * NONE *
  
  APAR OA60574 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:

  UJ05011 UJ05012

Modules/Macros

• IATNTRS
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R7B0 PSY UJ05011

     UP21/03/17 P F103

• R7C0 PSY UJ05012

     UP21/03/17 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.