OA47513: JES3 NETSERV HANG AFTER APPLYING OA45736

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• External symptoms:
  Several externals were reported related to this issue.  A
  Netserv address space hung, a JES3 restart resulted in IAT4162
  messages, and an ABENDDM760 occurred
  PE information:
    OA45736  PTF UA76116
  User's affected:
    All JES3 users using the TCPIP/NJE interface
  User impact:
    Several different externals can occur.  If you don't have this
  apar applied, do not apply it.  If you have it applied you
  may encounter significant issues.
  Analysis:
    The initial external will be the Netserv task not processing
  work.  The JES3 monitor will issue IAT6397 messages indicating a
  DMJA FCT is waiting for JDS access.
    Syslog analysis shows two jobs being received at the same
  time from the same system, the monitor messages begin shortly
  after the IAT9127 is issued for the jobs.  A dump taken of the
  hang (in this case, a Netserv TCB is hung up in IATSIOR on a
  OPEN request) shows no spool assigned to one of the two jobs
  although the resqueue for the job shows it has spool.  The
  RQJOBTAT value is the same for each of the jobs.  When an IPL
  and JES3 hotstart was initiated it results in duplicate
  track condition messages, and an ABENDDM760 occurs.
  
  The apar in question has an error in how it handles multiple
  tasks, sharing the same storage for a parameter list.
  Verification steps:
  1)  OA45736 is applied
  2)  Netserv hang
  3)  spool related issues (duplicate track condition,
  ABENDDM760)
  
  
  The projected closing code is PER for HJS7790 and HJS77A0.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJS7790 and HJS77A0.            *
  ****************************************************************
  * PROBLEM DESCRIPTION: JES3 Netserv hangs after applying       *
  *                      OA45736.                                *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A user had enabled multiplexing across his TCP NJE connections
  by defining multiple job receivers and transmitters.  Two jobs
  were transmitted concurrently using this multiplexed
  connection.  When end-of-job is received for a job in the
  Netserv address space, the socket task attaches a subtask to
  build an MJIB (IATYMJIB), send it to the global, and wait for
  a reply.  Module IATNTTXR attached the subtasks for these jobs
  using parameter lists built in the same storage area.  In the
  failing scenario, the first subtask attached did not reference
  its parameters until after the second subtask was attached.
  Both subtasks used the same set of parameters to build their
  MJIBs which resulted in the failure.
  

Problem conclusion

• UA76116
  Installation On (Netserv)
               Order (Any)
  Activation   Order (Any)
               Type/JES3 restart (Netserv)
               Type/IPL (None)
               CLPA (No)
  (See Apar II07968 for definitions)
  
  Macro IATYNSST was changed to place a copy of the ATTACH
  parameters into each receiver.  Module IATNTTXR was changed
  to use the relocated ATTACH parameters.  Modules IATABTC,
  IATNTTAS, IATNTTCT, IATNTTSS, and IATSIJAM were included
  to pick up the IATYNSST changes.
  
  APAR OA47513 prereq's (and sup's) for FMID HJS7790:
  Pre's: XA45736
  
  APAR OA47513 prereq's (and sup's) for FMID HJS77A0:
  Pre's: * NONE *
  

Temporary fix

• *********
                      * HIPER *
                      *********
  *** * TEMPORARY FIX MAY BE OBTAINED FROM DLL OR INFO/ACCESS ****
  ******************* OA47513  DECK AVAILABLE ********************
  

Comments

APAR Information

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

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

  UA77321 UA77322

Modules/Macros

• IATABTC  IATNTTAS IATNTTCT IATNTTSS IATNTTXR
  IATSIJAM IATYNSST
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R7A0 PSY UA77321

     UP15/05/27 P F505 ®

• R790 PSY UA77322

     UP15/05/27 P F505 ®

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.