PM73261: NEW FUNCTION

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• New Function
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All users of the IBM Communications Server   *
  *                 for z/OS Version 1 Release 13 IP Telnet      *
  *                 services                                     *
  ****************************************************************
  * PROBLEM DESCRIPTION: New Function.                           *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  New Function.
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  

Problem conclusion

Temporary fix

• *********
  * HIPER *
  *********
  

Comments

• A new keyword is defined to give the customer the ability to
  limit the size of an internal queue of messages for a single
  connection.  The new keyword is MAXTCPSENDQ. It can be specified
  on TelnetGlobals, TelnetParms, and ParmsGroup. Its range is
  0-99999999 and its default is 0, meaning no limit.
  
  If the number of bytes on the internal ASYD_LIFO/ASYD_FIFO
  queues exceed MAXTCPSENDQ, then return code x'4018' will
  result and the connection will be dropped.
  
  EZBZVREQ, EZBZPRMG, EZBTDPRM, EZBTDPRU, EZBTMPRP, and EZBTMPRT
  are all updated to allow the specification and propagation of
  the new keyword.
  
  EZBTMQPR is updated to allow the display of the presence of the
  new keyword in PROFILE, CONN, and CLID displays.
  
  EZBDGPRG is updated to allow TCPIPCS PROFILE to display the new
  keyword.
  
  EZBZTTIF is updated to increment the byte count for the
  connection when adding message triples to the queue. It also
  tests to see if the limit has been exceeded.
  
  EZBZASY is updated to have a definition where the current count
  is kept for the connection.
  
  EZBTTSND is updated to decrement the byte count for the
  connection as it removes message triples from the queue.
  
  EZBZTDBG is updated with the new return code (x'4018') that
  indicates that MAXTCPSENDQ has been exceeded.
  
  EZBTTCLS is updated to drop the connection for the new return
  code, but not to send unbind for it.
  
  EZBTVXRC is updated to retain any return code around the call
  to AllocRPL.
  
  EZBTRCLT is updated to correctly handle the new return code
  for the translate path.
  
  EZBTTCCU is updated to send a reset for the new return code.
  
  EZBZCVB has a bit defined to record if the limit is reached.
  
  All the modules that invoke the ttSend routine in EZBZTTIF are
  recompiled.
  
  The following SRLs are changed:
  
  SC31877619
  SC31877518
  SC31878111
  SC31878614
  GC31877107
  
  The required documentation  changes can be found at this URL:
  http://www.ibm.com/support/docview.wss?uid=swg27036905
  
  One of the things you should consider when selecting a value
  for MAXTCPSENDQ is what type of sessions the client is used
  for (e.g., a printer client may be expected to have more
  data destined for it at any one point in time than a client
  used for interactive sessions).
  

APAR Information

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

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

  UK90713

Modules/Macros

• EZBDGPRG EZBTDPRM EZBTDPRU EZBTMPRP EZBTMPRT
  EZBTMQPR EZBTPACP EZBTPAYT EZBTPCCO EZBTPELU EZBTPHAO EZBTPHDB
  EZBTPHDR EZBTPISY EZBTPLMB EZBTPLMO EZBTPOEF EZBTPSOM EZBTPSOW
  EZBTPSTF EZBTPSUS EZBTPTDP EZBTPTKO EZBTPUSL EZBTPUSM EZBTPUSW
  EZBTPUTS EZBTRCLT EZBTRTFO EZBTTCCC EZBTTCCU EZBTTCLS EZBTTSND
  EZBTTTSI EZBTVBND EZBTVCLR EZBTVSSC EZBTVXRC EZBTVXR2 EZBTZDBG
  EZBZASY  EZBZCVB  EZBZPRMG EZBZTDBG EZBZTTIF EZBZVREQ EZB2ASY
  EZB2CVB  EZB2PRMG EZB2VREQ
  

Fix information

• Fixed component name

  TCP/IP V3 MVS

• Fixed component ID

  5655HAL00

Applicable component levels

• R1D0 PSY UK90713

     UP13/02/12 P F302

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.