OA40491: Information needed to *FAIL a TCP FCT is not available

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• External symptoms:
  Recommended action when having an issue with the TCP function
  is to *FAIL the function.  If there are multiple TCP FCT's
  active for multiple netservs, the customer has no mechanism to
  determine the job number associated with the TCP FCT that needs
  to be *FAILed.
  Impact to customer:
    Inability to *FAIL without searching days worth of syslog
  Analysis:
    We do not provide a mechanism for a customer to obtain the
  TCP FCT job number associated with a specific netserv, nor do
  we provide a mechanism for a customer to *FAIL a TCP FCT by
  Netserv name.  The customer needs the ability to *FAIL the TCP
  FCT associated with a specific NETSERV address space.  This
  apar is being taken to provide that function.
  
  The projected closing code is PER for release HJS7780.
  

Local fix

• none, RAS
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of HJS7780.                        *
  ****************************************************************
  * PROBLEM DESCRIPTION: TCP DSP job number is not known.        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  A user wanted to *FAIL the TCP dynamic service program (DSP)
  associated with a particular Netserv address space, but was
  unable to do so because the DSP job number was not known.
  

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 IATIQNSV was changed to return the TCP DSP and Netserv
  address space jobids as part of "*INQUIRY,NETSERV=" command
  processing.
  
  The information in the following manuals should appear as
  indicated below.  Updates will only be made to the manuals
  in future releases.
  
  SA22-7552-xx
  JES3 Messages
  
  Change the following message (changes marked with "|").
  
    IAT8707
    Explanation:
    >>___NETSERV INQUIRY RESPONSE_______________________>
       _______________________________
       v                             |
    >____| INFORMATION FOR NETSERV |____________________>
  
    >____END OF NETSERV INQUIRY RESPONSE_______________><
  
    INFORMATION FOR NETSERV:
  
    |___INFORMATION FOR NETSERV_nname__SYSTEM=_sysname__>
  |                                           |_______|
  
    >___HOST=_host__PORT=_port__STACK=_stack__JTRACE=___>
  |          |____|                   |_____|
                                         _
    >___YES____ITRACE=___YES___VTRACE=___YES____________>
      |_NO__|          |_NO__|         |_NO__|
  
  | >___TLS=___YES___NETSERV JOBID=_njobid______________>
  |          |_NO__|               |______|
  |
  | >___DSP JOBID=_djobid____ACTIVE=___YES______________>
  |               |______|           |_NO__|
  
    >___SOCKETS DEFINED IN THIS NETSERV_________________>
  
    >____| socket information |_________________________|
         |_NONE_______________|
  
    socket information:
    |___SOCKET ACTIVE NODE SERVER_______________________>
  
    >___sname_n___YES___nname_n___YES____________________|
                |_NO__|         |_NO__|
  
    This message is issued in response to an *I,NETSERV=
    command to display information about a given Netserv
    definition, or all Netserv definitions.
    In the message text:
    system
      The system on which the Netserv runs, or blank if
      none is defined.
    host
      The name of the IP host that the Netserv uses to
      listen to TCP/IP, or blank if none is defined.
    port
      The name of the IP port for the Netserv, or blank if
      none is defined.
    stack
      The TCP/IP stack name containing the TCP/IP
      definition for the host, or blank if the default
      stack is used.
  | njobid
  |   The jobid of the Netserv address space, or blank
  |   if it is not active.
  | djobid
  |   The jobid of the TCP DSP, or blank if it is not
  |   active.
    sname_n
      A socket name within a list of socket lines, each
      representing a socket that is defined for the given
      Netserv, and an active status.
    nname_n
      The node name with which the home node uses
      the socket named sname_n to communicate.
  
    System action: Processing continues.
  
    Operator response: None.
  
    Module: None
  
    Containing      Detecting      Issuing
    IATIQNSV        IATIQNSV       IATIQNSV
  
    Routing Code: Hardcopy   Descriptor Code: 5
                  log
  
  
  APAR OA40491 prereq's (and sup's) for FMID HJS7780:
  Pre's: * NONE *
  

Temporary fix

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

Comments

• ž**** PE15/06/05 FIX IN ERROR. SEE APAR OA48059  FOR DESCRIPTION
  

APAR Information

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

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

  UA67667

Modules/Macros

• IATIQNSV
  

Fix information

• Fixed component name

  JES3

• Fixed component ID

  5752SC1BA

Applicable component levels

• R780 PSY UA67667

     UP13/01/23 P F301

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.