A fix is available
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 2 Release 1 SNA: * * Enterprise Extender * **************************************************************** * PROBLEM DESCRIPTION: * * Diagnostic EE counters for inbound * * HPR packets that are ANR routed through * * a network node are not available. * **************************************************************** * RECOMMENDATION: * * Apply PTF * **************************************************************** 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
OA43580
Reported component name
VTAM V4 MVS/ESA
Reported component ID
569511701
Reported release
210
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2013-10-08
Closed date
2013-10-14
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:
UA71064
Modules/Macros
ISTCICS2 ISTCICPP ISTAUCII ISTTSCWU ISTAUCIL ISTTSCAR ISTAUCDL ISTAUCIR ISTAUCCL ISTTSCRG
SC27367500 | SC27367300 | SC27366500 |
Fix information
Fixed component name
VTAM V4 MVS/ESA
Fixed component ID
569511701
Applicable component levels
R210 PSY UA71064
UP13/11/22 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":"210","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":"210","Edition":"","Line of Business":{"code":"","label":""}}]
Document Information
Modified date:
02 December 2013