IBM Support

II13951: MUSTGATHER: READ FIRST/FIX LIST FOR TCPIP CSM STORAGE FOR Z/OS COMMUNICATIONS SERVER - TCPIPINFO

Subscribe to this APAR

By subscribing, you receive periodic emails alerting you to the status of the APAR, along with a link to the fix after it becomes available. You can track this item individually or track all items by product.

Notify me when this APAR changes.

Notify me when an APAR for this component changes.

 

APAR status

  • INTRAN

Error description

  • This info apar replaces II12658 (which replaced older
    versions: II11180 and II12485) and contains TCP maintenance
    information for releases on z/OS V1R4 and later.
    Please see info apar II12657 for VTAM CSM maintenance.
    ****************************************************************
    *                                                              *
    *  Information in this APAR is no longer being updated.        *
    *  Please use the following URL for the most current           *
    *  information:                                                *
    *                                                              *
    * http://www.ibm.com/support/docview.wss?rs=852&uid=swg21318426
    *                                                              *
    ****************************************************************
    
    * PARMLIB MEMBER IVTPRM00 should initially be coded at       *
    * 120M MAX ECSA and 120M MAX FIXED.  Monitor system for one  *
    * week with DISPLAY CSM command to determine peak usage.     *
    * Adjust IVTPRM00 MAX ECSA and MAX FIXED values to 1.5 times *
    * the highest value indicated in DISPLAY CSM output.         *
    * NOTE:  When coding IVTPRM00, FIXED MAX and ECSA MAX values *
    *        must start in column one and only one space is      *
    *        allowed between fields.                             *
    * NOTE:  If CSM MAX ECSA is coded higher than 90% of the     *
    *        S/390 allowable ECSA (IEASYS00 ECSA), then          *
    *        CSM MAX ECSA will be adjusted to 90% of S/390 ECSA. *
    NOTE:
    In z/OS® V1R13, the processing of IPAQENET and IPAQENET6
    INTERFACE statements is enhanced. Coding the WORKLOADQ
    parameter on these INTERFACE statements now enables the QDIO
    inbound workload queueing function for Enterprise Extender (EE)
    traffic.
    An additional ancillary input queue (AIQ) is established for
    inbound trafic for EE if HPR=RTP is specified as a VTAM start
    option.  Each AIQ increases storage utilization by an amount
    36K of fixed ECSA, plus potentially the READSTORAGE value
    (64K multiplied by the number of SBALs) of fixed CSM 4K
    data space storage.
    If you have configured QDIO inbound workload queuing,
    you must ensure that there is sufficient fixed ECSA and 4K CSM
    dataspace storage for the AIQ for EE traffic.
    The following link provides additional information regarding
    storage needs when using WORKLOADQ:
    
    http://pic.dhe.ibm.com/infocenter/zos/v1r13/index.jsp?topic=%2Fc
    om.ibm.zos.r13.e0zm100%2Fmeestorg.htm
    ***************ADDITIONAL NOTES*******************************
    *  NOTE 1: You must adjust your IEASYSxx CSA parm to include *
    *  the additional amounts of ECSA that CSM will be using.    *
    **************************************************************
    *  Note 2: A shortage of CSM FIXED storage may result in     *
    *  ENOBUFS errors on a variety of TCP/IP Socket calls.  The  *
    *  system programmer should consider increasing CSM MAX FIXED*
    *  if EBOBUFS errors are reported by Sockets Applications    *
    *  running on the z/OS or OS/390 image.                      *
    **************************************************************
    * NOTE 3: To dynamically change the ECSA and FIXED CSM values*
    *  use the following command:                               *
    *     MODIFY net,CSM,ECSA=value,FIXED=value                 *
    *  where value can be in K or M ranging from 1024K to 2048M *
    **************************************************************
    **************************************************************
    If the maintenance listed in this apar does not resolve
    the problem, the following documentation needs to be obtained:
    1) D net,CSM,OWNERID=ALL to determine how much storage is being
       used and by what job / ASID.
       D net,CSM to identify the CSM dataspace being used.
    2) MODIFY net,TRACE,TYPE=VTAM,
       OPTION=(CSM,CIO,SMS,PSS,PIU,MSG,SSCP,API,NRM,XBUF,APPC,CIA)
       NOTE:  Do the following if using 8K VIT buffering:
              -Specify BFRNUM to 10.
              -Ensure you only specify FE1,FEF,FF1 GTF options.
              -Ensure large enough BLOCKSIZE is specified for GTF
                (IEFRDER DD BLKSIZE defined to at least 8K-details
                in OW26052).
       The VIT can also be run to the VTAM dataspace rather than
       externally to GTF:
       MODIFY net,TRACE,TYPE=VTAM,
       OPTION=(CSM,CIO,SMS,PSS,PIU,MSG,SSCP,API,NRM,XBUF,APPC,CIA),
       DSPSIZE=5,SIZE=999
    3)  If the DISPLAY CSM output indicates TCP/IP owns the
        storage:
     a) Update CTIEZB00 member in parmlib to specify at least
        BUFSIZE(16M).
        This will provide a 16M CTRACE buffer.  TCP/IP must be
        recycled after this change.
     b) Bring up TCP/IP and issue:
        - TRACE CT,ON,COMP=SYSTCPIP,SUB=(TCPIP)
        - R xx,options=(STORAGE,VTAM,VTAMDATA,MESSAGE,INTERNET,TCP),
               END
    4) Dump VTAM and TCP/IP, their dataspaces and the CSM
       Dataspaces using a dump command similar to the following:
     DUMP COMM=(csm storage growth)
     R xx,JOBNAME=(net,tcpip),SDATA=(SQA,LSQA,CSA,RGN,TRT,NUC),CONT
     R xx,DSPNAME=('net'.ISTITDS1,'tcpip'.*,1.CSM*),END
    ADDITIONAL NOTE:
     Please read INFO APAR II12320 for additional important
     information regarding a storage shortage when TCP devices
     have invalid MVS MIH values.
    ***************************************************************
    *                  TCP/IP z/OS 1.4 R140                       *
    ***************************************************************
    PQ60706 UQ67460 0207 CSM 4K DATASPACE GROWTH
    PQ61064 UQ67699 0208 CSM ECSA GROWTH WITH IUTSAMEH
    PQ63152 UQ68432 0208 CSM CRITICAL CAUSES TCPIP HANG
    PQ62315 UQ68981 0208 CSM GROWTH OF IUDRS WITH CLAW PACKING
    PQ64240 UQ69360 0209 CSM 4K ECSA GROWTH - OUT OF ORDER SEGMENTS
    PQ68122 UQ71990 0212 CSM HIGH, TCPIP RESTART HANGS W/HIGH ECSA
    PQ70771 UQ74447 0303 CLOSEWAIT W/ZERO WINDOW - DATA NOT FREED
    PQ72228 UQ75661 0304 CSA EXHAUSTION - UNUSED DUCBS NOT FREED
    PQ72259 UQ75479 0304 ABEND0C4 in EZBITSCS
    PQ83748 UQ85490 0403 SNMPIUCV STOPS RECEIVING MESSAGES
    PQ87507 UQ88072 0405 TCPIP HUNG WHEN CSM CONSTRAINED
    PQ87653 UQ88099 0406 EZBAFINB ABEND WHEN CSM CRITICAL
    PQ88146 UQ88341 0406 60K CLAW PACKING BUFFERS & SHORT PACKET
    PQ90467 UQ90582 0408 CSM ECSA GROWS WITH INBOUND PACKETS
    PQ91417 UQ89959 0408 CSM EXHAUSTED - LONG RUNNING CONNECTIONS
    PQ87325 UQ91527 0409 CSM 180K ECSA GROWTH DURING FTP
    PQ84529 UQ91649 0409 4K CSM LEAK W/ AUTHENTICATION & ENCRYPTION
    PQ98609 UK00167 0504 32K ECSA Outbound Packing Buffers
    PK00576 UK00571 0503 EE Packets wait on Policy Lock
    PK01098 UK01082 0504 231 key 6 Growth with DBCSTRANSFORM
    PK03118 UK02558 0505 231 Key 6 and CSM ECSA 4K with IQDIO
    PK04942 UK03081 0506 CSM 4K ECSA due to caching multicast ARP
    PK07385 UK05303 0508 CSM FIXED SHORTAGE CAUSES OBEYFILE LOOP
    PK09341 UK06731 0510 Serviceability apar
    ***************************************************************
    *                  TCP/IP z/OS 1.4 R149                       *
    ***************************************************************
    PQ61064 UQ67700 0208 CSM ECSA GROWTH WITH IUTSAMEH
    ***************************************************************
    ***************************************************************
    *                  TCP/IP z/OS 1.5 R150                       *
    ***************************************************************
    PQ83748 UQ85491 0403 SNMPIUCV STOPS RECEIVING MESSAGES
    PQ82294 UQ86496 0404 60K CLAW PACKING AND SHORT PACKETS
    PQ87507 UQ88073 0405 TCPIP HUNG WHEN CSM CONSTRAINED
    PQ87653 UQ88100 0406 EZBAFINB ABEND WHEN CSM CRITICAL
    PQ91417 UQ89960 0408 CSM EXHAUSTED - LONG RUNNING CONNECTIONS
    PQ87325 UQ91528 0409 CSM 180K ECSA GROWTH DURING FTP
    PQ84529 UQ91650 0409 4K CSM LEAK W/ AUTHENTICATION & ENCRYPTION
    PQ92080 UQ92396 0409 CSM STORAGE GROWTH WITH IUDR AND SKMB
    PQ98609 UK00168 0504 32K ECSA Outbound Packing Buffers
    PK00576 UK00572 0503 EE Packets wait on Policy Lock
    PK01098 UK01083 0504 231 key 6 Growth with DBCSTRANSFORM
    PK03118 UK02559 0505 231 Key 6 and CSM ECSA 4K with IQDIO
    PK04942 UK03082 0506 CSM 4K ECSA due to caching multicast ARP
    PK07385 UK05304 0508 CSM FIXED SHORTAGE CAUSES OBEYFILE LOOP
    PK09341 UK06732 0510 Serviceability apar
    ***************************************************************
    *                  TCP/IP z/OS 1.6 R160                       *
    ***************************************************************
    PQ87507 UQ88074 0405 TCPIP HUNG WHEN CSM CONSTRAINED
    PQ87653 UQ88101 0406 EZBAFINB ABEND WHEN CSM CRITICAL
    PQ88324 UQ88862 0406 ECSA GROWTH TERMINATING TN3270 SESSIONS
    PQ89399 UQ89476 0406 STORAGE LEAK WHEN CSM IS CONSTRAINED
    PQ91417 UQ89961 0408 CSM EXHAUSTED - LONG RUNNING CONNECTIONS
    PQ90094 UQ90367 0408 60K CLAW PACKING AND SHORT PACKETS
    PQ84529 UQ91651 0409 4K CSM LEAK W/ AUTHENTICATION & ENCRYPTION
    PQ87325 UQ91529 0409 CSM 180K ECSA GROWTH DURING FTP
    PQ98609 UK00169 0504 32K ECSA Outbound Packing Buffers
    PK00576 UK00573 0503 EE Packets wait on Policy Lock
    PK01098 UK01084 0504 231 key 6 Growth with DBCSTRANSFORM
    PK03118 UK02560 0505 231 Key 6 and CSM ECSA 4K with IQDIO
    PK04027 UK02523 0505 CSM 4K ECSA due to caching multicast ARP
    PK07385 UK05305 0508 CSM FIXED SHORTAGE CAUSES OBEYFILE LOOP
    PK09341 UK06733 0510 Serviceability apar
    PK16464 UK10588 0602 CSM growth using Firewall
    PK46885 UK27411 0708 FIXED CSM growth with IUDRs and data
    ***************************************************************
    *                  TCP/IP z/OS 1.6 R169                       *
    ***************************************************************
    PQ89399 UQ89477 0406 STORAGE LEAK WHEN CSM IS CONSTRAINED
    ***************************************************************
    *                  TCP/IP z/OS 1.7 R170                       *
    ***************************************************************
    PK05314 UK03793 0506 231 key 6 Growth with DBCSTRANSFORM
    PK06506 UK04299 0506 32K ECSA Outbound Packing Buffers
    PK06529 UK04062 0506 231 Key 6 and CSM ECSA 4K with IQDIO
    PK07385 UK05306 0508 CSM FIXED SHORTAGE CAUSES OBEYFILE LOOP
    PK09341 UK06734 0510 Serviceability apar
    PK20978 UK13220 0604 Overlay -  Record Structure FTP
    PK32215 UK19250 0611 CSM 32K Dataspace buffer growth
    PK44941 UK26099 0707 FIXED CSM growth with IUDRs and data
    PK55824 UK31400 0712 CSM Dataspace and ECSA 4K buffers
    PK61002 UK35461 0805 Consolidate Storage on Receive queue
    ***************************************************************
    *                  TCP/IP z/OS 1.8 180                        *
    ***************************************************************
    PK26464 UK15524 0606 180K ECSA Buffer overlaid x'FF' pattern
    PK32215 UK19251 0611 CSM 32K Dataspace buffer growth
    PK44941 UK26100 0707 FIXED CSM growth with IUDRs and data
    PK55824 UK31401 0712 CSM Dataspace and ECSA 4K buffers
    PK57383 UK32596 0802 CSM 4k ECSA Containing IUDR for IGMP
    PK61002 UK35462 0805 Consolidate Storage on Receive queue
    PK70053 UK39694 0810 Some CSM growth with Loop in Shareport
    PK74282 UK41811 0812 CSM FIXED growth - Large # appl connections
    ***************************************************************
    *                  TCP/IP z/OS 1.9 190                        *
    ***************************************************************
    PK44941 UK26101 0707 FIXED CSM growth with IUDRs and data
    PK55824 UK31402 0712 CSM Dataspace and ECSA 4K buffers
    PK57383 UK32597 0802 CSM 4k ECSA Containing IUDR for IGMP
    PK61002 UK35463 0805 Consolidate Storage on Receive queue
    PK69049 UK38323 0808 16K ECSA CSM Growth with FRCA
    PK69071 UK38816 0809 CSM ECSA due to deleted XCF link
    PK70053 UK39695 0810 Some CSM growth with Loop in Shareport
    PK74282 UK41812 0812 CSM FIXED growth - Large # appl connections
    PK88593              32K CSM ECSA FIXED growth after PK79768
    ********************************************************
    *                  TCP/IP z/OS 1.10 1A0                       *
    ***************************************************************
    PK68520 UK38177 0808 ABEND S0C4 IN WEB SERVER - FIXED CSM GROWTH
    PK69049 UK38322 0808 16K ECSA CSM Growth with FRCA
    PK69071 UK38815 0809 CSM ECSA due to deleted XCF link
    PK70053 UK39693 0810 Some CSM growth with Loop in Shareport
    PK74282 UK41810 0812 CSM FIXED growth - Large # appl connections
    PK82625 UK45669 0905 CSM HDR growth for image buffers
    PK88593              32K CSM ECSA FIXED growth after PK79768
    TCPINFO BOOKAPAR 5655HAL00 R50A R120 R140 R149 R150 R160
    ***************************************************************
    Additional Information regarding VTAM CSM usage:
     HPDT and CSM usage:
     VTAM Network Implementation Guide (SC31-8370-00):
     VTAM Programming for CSM (SC31-8420-00)
     VTAM Guide to Programming for LU 6.2. (SC31-8374-00)
     CSM Guide (SC31-8575-00)
    NOTE: For z/OS Commserver hints and tips go to:
    http://www.ibm.com/software/network/commserver/support/
    **************************************************************
    *      End of II13951 data.                                  *
    **************************************************************
    VTAMINFO
    

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

APAR Information

  • APAR number

    II13951

  • Reported component name

    PA LIB INFO ITE

  • Reported component ID

    INFOPALIB

  • Reported release

    001

  • Status

    INTRAN

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2004-10-08

  • Closed date

  • Last modified date

    2013-10-01

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

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

Fix information

Applicable component levels

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19N","label":"APARs - OS\/390 environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG32M","label":"APARs - VSE\/ESA environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG19M","label":"APARs - z\/OS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":null,"label":null},"Product":{"code":"SG19O","label":"APARs - MVS environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSSN3L","label":"z\/OS Communications Server"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SG27M","label":"APARs - z\/VM environment"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"001","Edition":"","Line of Business":{"code":"LOB16","label":"Mainframe HW"}}]

Document Information

Modified date:
01 October 2013