IBM Support

OA43305: D NET,ID=PU_NAME,DET RESULTS DO NOT INCLUDE INBOUND PACKETS AND INBOUND BYTES THAT WERE ANR ROUTED.

A fix is available

Subscribe

You can track all active APARs for this component.

 

APAR status

  • Closed as program error.

Error description

  • D NET,ID=pu_name,DET results do not include inbound packets
    and inbound bytes that were ANR routed.
    Affected messages are:
    IST2040I  NLPS RECEIVED
    IST2041I  BYTES RECEIVED
    

Local fix

Problem summary

  • ****************************************************************
    * USERS AFFECTED: All users of the IBM Communications Server   *
    *                 for z/OS Version 1 Release 13 SNA:           *
    *                 Enterprise Extender                          *
    ****************************************************************
    * PROBLEM DESCRIPTION: Diagnostic EE counters for inbound      *
    *                      HPR packets that are ANR routed through *
    *                      a network node are not available.       *
    ****************************************************************
    * RECOMMENDATION:                                              *
    ****************************************************************
    1) VTAM currently does not maintain diagnostic EE counters for
       inbound HPR traffic which is being ANR routed through a
       network node.
    
    2) The D NET,EE,ID=eepuname,DET output may show traffic for a
       specific port with zero inbound counters.  In this example,
       there are no local RTP pipes using the same EE link.
    .
    .
    IST2032I PORT PRIORITY = HIGH
    IST2029I   MTU SIZE =  4068
    IST2036I   NLPS SENT           =                18650  ( 018K )
    IST2037I   BYTES SENT          =              1675939  ( 001M )
    IST2038I   NLPS RETRANSMITTED  =                    0  ( 000K )
    IST2039I   BYTES RETRANSMITTED =                    0  ( 000K )
    IST2040I   NLPS RECEIVED       =                    0  ( 000K )
    IST2041I   BYTES RECEIVED      =                    0  ( 000K )
    
    These counters are visible through Network
    Management Interface application (SNAMGMT) EE displays.
    
    3) A new start option, EEHPRANR=YES, is being introduced to
       allow VTAM to maintain these statistics.  The default is
       EEHPRANR=NO.
    

Problem conclusion

  • The following modules/macros have been changed:
    
    ISTCICS2 - Defined new EEHPRANR start option
             - Included in APPNCHAR and HPREE function
               groups
             - Defaults to EEHPRANR = NO
    ISTCICPP - Code changes to validate EEHPRANR option
             - Valid only for Network Nodes
             - Valid only when HPR=ANR or RTP
    ISTTSCB  - Defined new bit TSCB_INB_EE to indicate this
               TSCB represents an inbound EE packet
    ISTCICOM - Defined CIC_EEHPRANR to indicate EEHPRANR option
               has been specified
    ISTAUNCB - Defined AUNCB_Dealloc_TOD to indicate when
               the AUNCB was added to the ACM_AUNCB_Que
    ISTAUCDL - Modified to TPADDEL the AUNCB to the
               new ACM_AUNCB_Que if EEHPRANR=YES has ever
               been specified.  Otherwise, ISTAUCDL will
               continue to free the AUNCB and data
               extension inline.
    ISTACMDT - Define ACM_AUNCB_Que (AUNCB aging queue)
               Define ACMDT_EEHPRANR
               Define ACMDT_EEHPRANR_SET_ONCE
    ISTTSCRG - Has been modified to process AUNCBs on
               the ACM_AUNCB_Que. If AUNCBs have aged
               60 seconds, code has been added to
               free up the AUNCB and data extension.
    ISTTSCWU - Modified to call ISTTSCRG if AUNCBs are
               queued to the ACM_AUNCB_Que
    ISTTSCAR - Modified to locate the AUNCB associated
               with an inbound ANR routed EE packet.
               Once found, EE statistics are maintained
               for this EE line.
    ISTAUCII - If processing inbound HPR data new code has
               been added to set the following TSCB fields:
    
               TSCB_AUNCB_INDEX
               TSCB_AUNCB_ELEM
               TSCB_INB_EE
    
               These fields are used by ISTTSCAR to locate
               and lock the correct EE line (AUNCB).
    
    IST400C  - Defined M448EEHPRANR constant
    IST1050C - Defined M1093EEHPRANR constant
    IST1100C - Defined M1114EEHPRANR constant
    
    ISTAUCCL,
    ISTAUCIL,
    ISTAUCIR - Recompile Only - To clear AUNCB_DYNAMIC_DATA2
    
    ***********************************************************
    
    The following documentation changes have been made:
    
    z/OS IBM Communications Server
    SNA Resource Definition Reference
    Chapter 4. Start options
    Summary of start options
    
    1. Add the following description of new start option EEHPRANR
    to Table 62.
    
    Table 62. Start options that define APPN characteristics.
    
    EEHPRANR      The EEHPRANR start option determines whether
                  VTAM maintains diagnostic EE counters for
                  inbound HPR packets that are ANR routed through
                  this network node.
    
    2. Add the following description of new start option EEHPRANR
    to Table 64.
    
    Table 64. Start options that define HPR and Enterprise Extender
    
    EEHPRANR      The EEHPRANR start option determines whether
                  VTAM maintains diagnostic EE counters for
                  inbound HPR packets that are ANR routed through
                  this network node.
    
    3. Add description of new start option EEHPRANR
    Chapter 4. Start options
    Description of start options
    
    
                     (1)
        |-EEHPRANR=NO------------|
        |                        |
     >>-+----------------------------------------------------><
        |                        |
        |-EEHPRANR=__ __NO____ __|
                     |__YES___|
    
    
     Note: (1) EEHPRANR is meaningful only if the NODETYPE=NN
               start option is also used.
    
    EEHPRANR      The EEHPRANR start option determines whether
                  VTAM maintains diagnostic EE counters for
                  inbound HPR packets that are ANR routed through
                  this network node.
    
    This option determines whether VTAM maintains diagnostic
    EE counters for inbound HPR packets that are ANR routed
    through this network node.  These counters are visible through
    the DISPLAY EE command output as well as through Network
    Management Interface application (SNAMGMT) EE displays.
    
    EEHPRANR = NO
    
      This specifies that VTAM will not maintain diagnostic
      EE counters for inbound HPR packets that are ANR routed
      through this node.  VTAM does maintain diagnostic
      EE counters for outbound HPR packets that are ANR routed
      through this node.
    
    EEHPRANR = YES
    
      This specifies that VTAM will maintain diagnostic
      EE counters for both inbound and outbound HPR packets
      that are ANR routed through this node.
    
      NOTE: In environments with large numbers of RTP pipes,
            specifying EEHPRANR=YES may increase CPU overhead
            to maintain these statistics.
    
    ***********************************************************
    
    z/OS IBM Communications Server
    SNA Operation
    Chapter 2. VTAM Operator command
    
    
    4. Add EEHPRANR to the Display VTAMOPTS
       (Function=APPNCHAR output)
    
    Display VTAMOPTS command
    
    FUNCTION=APPNCHAR
    
    Add EEHPRANR alphabetically in the defined start options
    associated with the APPNCHAR function list.
    
    5. Add EEHPRANR to the Display VTAMOPTS
       (Function=HPREE output)
    
    Display VTAMOPTS command
    
    FUNCTION=HPREE
    
    Add EEHPRANR alphabetically in the defined start options
    associated with the HPREE function list.
    
    6. Add EEHPRANR to the Modify VTAMOPTS railroad tracks
    
      >-+-----------------------+---------------------------->
        |                 (xx)   |
        |-EEHPRANR=__ __NO____ __|
                     |__YES___|
    
     Note: (xx) EEHPRANR is meaningful only if the NODETYPE=NN
                start option is also used.
    
    7. Add EEHPRANR to the START command railroad tracks
    
    START command
    
        |-EEHPRANR=NO------------|
        |                        |
      >-+---------------------------------------------------->
        |                 (xx)   |
        |-EEHPRANR=__ __NO____ __|
                     |__YES___|
    
     Note: (xx) EEHPRANR is meaningful only if the NODETYPE=NN
                start option is also used.
    

Temporary fix

Comments

APAR Information

  • APAR number

    OA43305

  • Reported component name

    VTAM V4 MVS/ESA

  • Reported component ID

    569511701

  • Reported release

    1D0

  • Status

    CLOSED PER

  • PE

    NoPE

  • HIPER

    NoHIPER

  • Special Attention

    NoSpecatt / Xsystem

  • Submitted date

    2013-09-10

  • Closed date

    2013-10-08

  • Last modified date

    2013-12-02

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

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

    OA43580 UA71022

Modules/Macros

  • ISTACMDT ISTAUCCL ISTAUCDL ISTAUCII ISTAUCIL
    ISTAUCIR ISTAUNCB ISTCICOM ISTCICPP ISTCICS2 ISTTSCAR ISTTSCB
    ISTTSCRG ISTTSCWU IST1050C IST1100C IST400C
    

Publications Referenced
SC31877812SC31877911SX75012411  

Fix information

  • Fixed component name

    VTAM V4 MVS/ESA

  • Fixed component ID

    569511701

Applicable component levels

  • R1D0 PSY UA71022

       UP13/11/16 P F311

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.

[{"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":"1D0","Edition":"","Line of Business":{"code":"","label":""}},{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SSCY4DZ","label":"DO NOT USE"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1D0","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
02 December 2013