OA45736: After a NETSERV socket gets into a hung condition a "*C TCP,SOCKET=xxx" command does not terminate it

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• External symptoms:
  Customer finds a NETSERV socket is in hung state; a cancel is
  issued, the socket does not end
  Impact to customer:
    Customer has to MVS cancel terminate the Netserv to
  get the sockets cleaned up
  Analysis:
    The initial hang of the socket is undiagnosed.  The NETSERV
  socket task for the hung socket is waiting for a response to an
  MJIB (IATYMJIB) from the global.  This is the same task to which
  the socket cancel was directed.  However, because the task
  is already waiting, the cancel is prevented from running.
  
  Verification steps:
  
  1)  socket hangs
  2)  socket cancel issued, socket does not end
  3)  dump of Netserv shows task waiting for MJIB processing
  
  The projected closing code is PER for HJS7790.
  

Local fix

• The netserv needs to be MVS cancelled when this state occurs
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJS7790.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: Hung TCP socket can not be cancelled.   *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A batch job was sent from one JES3 TCP NJE (Network Job Entry)
  node to another.  After the transfer completes, the receiving
  NETSERV socket subtask sends an MJIB (IATYMJIB) to the node's
  global to complete the transferred job's set up.  During this
  process, the NETSERV subtask waits for a reply.  In the
  reported case, the reply was lost, and the NETSERV subtask was
  hung.  The customer entered a "*C TCP,SOCKET=sockname" command
  to end and recover the socket subtask, but since that subtask
  was waiting, the cancel was ineffective.
  

Problem conclusion

• 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 define flags and storage needed
  to suspend and resume MJIB (IATYMJIB) processing.  Modules
  IATNTTXR and IATSIJAM were changed to make MJIB processing
  interruptible.  Modules IATABTC, IATNTTAS, IATNTTCT, and
  IATNTTSS were recompiled to pick up the macro  changes.
  
  
  APAR OA45736 prereq's (and sup's) for FMID HJS7790:
  Pre's: * NONE *
  

Temporary fix

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

Comments

• ×**** PE15/04/07 FIX IN ERROR. SEE APAR OA47513  FOR DESCRIPTION
  

APAR Information

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

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

  UA76116

Modules/Macros

• IATABTC  IATNTTAS IATNTTCT IATNTTSS IATNTTXR
  IATSIJAM IATYNSST
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R790 PSY UA76116

     UP15/02/04 P F502 Ž

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.