IST2065I
ENTERPRISE EXTENDER CONNECTION REXMIT INFORMATION

Explanation

VTAM® issues this message as part of a group of messages in response to a DISPLAY EEDIAG command for Enterprise Extender connection retransmission information. This message is the first in a group of messages. The display output might consist of multiple Enterprise Extender connections being displayed. Each matching connection will be displayed in a subgroup beginning with message IST1680I. The full description of the message group follows the example.
 IST2065I ENTERPRISE EXTENDER CONNECTION REXMIT INFORMATION
[IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator]
 IST2067I EEDIAG DISPLAY ISSUED ON date AT time
 IST924I -------------------------------------------------------------
 IST1680I type IP ADDRESS ip_address
[IST1910I LOCAL HOSTNAME value]
[IST1911I value]
 IST1680I type IP ADDRESS ip_address
[IST1909I REMOTE HOSTNAME value]
[IST1911I value]
[IST2023I CONNECTED TO LINE linename]
[IST2024I CONNECTED TO SWITCHED PU puname]
[IST924I -------------------------------------------------------------]
[IST2030I PORT PRIORITY = SIGNAL]
[IST2036I   NLPS SENT           = nlps_sent          ( estimate )]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )]
[IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate]
[IST924I -------------------------------------------------------------]
[IST2031I PORT PRIORITY = NETWORK]
[IST2036I   NLPS SENT           = nlps_sent          ( estimate )]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )]
[IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate]
[IST924I -------------------------------------------------------------]
[IST2032I PORT PRIORITY = HIGH  ]
[IST2036I   NLPS SENT           = nlps_sent          ( estimate )]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )]
[IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate]
[IST924I -------------------------------------------------------------]
[IST2033I PORT PRIORITY = MEDIUM]
[IST2036I   NLPS SENT           = nlps_sent          ( estimate )]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )]
[IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate]
[IST924I -------------------------------------------------------------]
[IST2034I PORT PRIORITY = LOW]
[IST2036I   NLPS SENT           = nlps_sent          ( estimate )]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )]
[IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate]
 IST924I -------------------------------------------------------------
 IST2035I TOTALS FOR ALL PORT PRIORITIES
 IST2036I   NLPS SENT           = nlps_sent          ( estimate )
 IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )
 IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate
 IST2069I REXMIT COUNTERS LAST CLEARED ON date AT time
[IST2071I ALL DIAGNOSTIC COUNTERS CLEARED FOR count EE CONNECTIONS]
[IST2072I REXMIT COUNTERS CLEARED FOR count EE CONNECTIONS]
[IST2073I SRQRETRY COUNTERS CLEARED FOR count EE CONNECTIONS]
[IST1315I DISPLAY TRUNCATED AT MAX = number]
 IST2042I count OF total EE CONNECTIONS DISPLAYED
 IST314I END
IST924I
  • This message is a line separator between subgroups.
IST1315I
  • This message is issued when the number of EE connections displayed exceeds the value specified for the MAX operand.
  • number is the value specified for the MAX operand.
IST1680I
  • This is the first message of a message subgroup. For DISPLAY EEDIAG commands that result in multiple EE connections being displayed, this subgroup is displayed for each matching EE connection. When LIST=DETAIL is specified, five optional subgroups, beginning with the IST2030I subgroup and ending with the IST2034I subgroup, are also displayed.
  • type is either LOCAL or REMOTE, indicating which IP address is being displayed.
  • ip_address is the IP address.
  • The complete message subgroup (LIST=SUMMARY) follows:
     IST1680I type IP ADDRESS ip_address
    [IST1910I LOCAL HOSTNAME value]
    [IST1911I value]
     IST1680I type IP ADDRESS ip_address
    [IST1909I REMOTE HOSTNAME value]
    [IST1911I value]
    [IST2023I CONNECTED TO LINE linename ]
    [IST2024I CONNECTED TO SWITCHED PU puname ]
     IST924I -------------------------------------------------------------
     IST2035I TOTALS FOR ALL PORT PRIORITIES
     IST2036I   NLPS SENT           = nlps_sent          ( estimate )
     IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )    
     IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate
IST1909I
  • value is the host name used to acquire the remote IP address associated with this connection to the remote node. If the host name is longer than 44 characters, then the first 44 characters are displayed as value and the remaining characters are displayed in one or more IST1911I messages.
IST1910I
  • value is the host name used to acquire the local static VIPA address displayed in message IST1680I. If the host name is longer than 45 characters, then the first 45 characters are displayed as value and the remaining characters are displayed in one or more IST1911I messages.
IST1911I
  • value is the continuation of value on messages IST1909I and IST1910I. IST1911I is repeated as many times as necessary to display the entire character string.
IST2023I
  • This message is issued when the ID operand is specified with a switched PU name that has an active Enterprise Extender connection.
  • linename is the name of the Enterprise Extender line used for this Enterprise Extender connection.
IST2024I
  • This message is not issued in the case where the ID operand is specified with a switched PU name that has an active Enterprise Extender connection. In this case, message IST2023I is issued. For all other cases, this message is issued as part of the DISPLAY EEDIAG connection display.
  • puname is the name of the switched PU used for this Enterprise Extender connection.
IST2030I, IST2031I, IST2032I, IST2033I, IST2034I, IST2035I
  • Messages IST2030I through IST2034I are header messages for optional message subgroups. One subgroup is displayed for each port priority when LIST=DETAIL is specified. Each header message is followed by messages IST2036I, IST2038I, and IST2068I.
  • IST2035I is a header message for a subgroup that displays a summary of all port priorities. This subgroup includes the same messages as listed for each port priority subgroup.
  • Each of these subgroups is also associated with a subgroup of messages that begins with message IST1680I.
  • A sample of one of the subgroups follows:
    IST2030I PORT PRIORITY = SIGNAL
    IST2036I   NLPS SENT           = nlps_sent          ( estimate )
    IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )
    IST2068I   NLP RETRANSMIT RATE = nlp_retransmit_rate
IST2036I
  • This message is associated with a subgroup of messages that begins with message IST2030I, IST2031I, IST2032I, IST2033I, IST2034I or IST2035I.
  • nlps_sent is the total number of network layer packets (NLP) that have been sent across this EE connection for this specific priority. This value is maintained from the time this connection was activated, or since the last DISPLAY EEDIAG command was issued specifying the CLEAR=ALL|REXMIT parameter.
  • estimate is an estimate of the displayed nlps_sent. It is in the form xxxU, where xxx is a numeric value and U is the unit of measure for xxx as follows:
    K
    Estimate is in units of 1000 NLPs.
    M
    Estimate is in units of 1 000 000 NLPs.
    G
    Estimate is in units of 1 000 000 000 NLPs.
    T
    Estimate is in units of 1 000 000 000 000 NLPs.
    P
    Estimate is in units of 1 000 000 000 000 000 NLPs.
IST2038I
  • This message is associated with a subgroup of messages that begins with message IST2030I, IST2031I, IST2032I, IST2033I, IST2034I or IST2035I.
  • nlps_retransmitted is the total number of network layer packets (NLP) that have been retransmitted across this EE connection for this specific priority. This value is maintained from the time this connection was activated, or since the last DISPLAY EEDIAG command was issued specifying the CLEAR=ALL|REXMIT parameter.
  • estimate is an estimate of the displayed nlps_retransmitted value. It is in the form xxxU, where xxx is a numeric value and U is the unit of measure for xxx as follows:
    K
    Estimate is in units of 1000 NLPs.
    M
    Estimate is in units of 1 000 000 NLPs.
    G
    Estimate is in units of 1 000 000 000 NLPs.
    T
    Estimate is in units of 1 000 000 000 000 NLPs.
    P
    Estimate is in units of 1 000 000 000 000 000 NLPs.
IST2042I
  • count is the number of matching EE connections displayed in the output.
  • total is the total number of EE connections that match the parameters specified on the DISPLAY EEDIAG command. The total might be larger than the displayed count because the number of EE connections displayed is governed by the MAX parameter.
IST2065I
  • This message is the header message for the Enterprise Extender connection retransmission information display output.
IST2067I
  • The date and time values specify when this DISPLAY EEDIAG command was issued. See DATE and TIME formats for information about the date and time values.
IST2068I
  • This message is associated with a subgroup of messages that begins with message IST2030I, IST2031I, IST2032I, IST2033I, IST2034I, or IST2035I.
  • nlp_retransmit_rate is the current network layer packet (NLP) retransmission rate for this EE connection. This rate is maintained for each specific priority. Issuing the LIST=DETAIL on the DISPLAY EEDIAG,REXMIT command displays the current retransmission rate for each priority level. The LIST=SUMMARY output displays the average retransmission rate for all priorities associated with this EE connection. This value is maintained from the time this connection was activated, or since the last DISPLAY EEDIAG command was issued specifying the CLEAR= ALL|REXMIT parameter.
  • It is in the form xxx%, where xxx is the numeric value of the retransmission rate, specified as a percentage.
IST2069I
  • The date and time values specify when the retransmission counters were last cleared for this EE connection. The date and time values displayed in this message, combined with the date and time values displayed in message IST2067I, provide the time interval during which the retransmission metrics were collected. See DATE and TIME formats for information about the date and time values.
IST2071I
  • count is the number of EE connections that had both their REXMIT and SRQRETRY counters cleared as a result of the CLEAR=ALL parameter.
IST2072I
  • count is the number of EE connections that had their retransmission counters cleared as a result of the CLEAR=REXMIT parameter.
IST2073I
  • count is the number of EE connections that had their SRQRETRY counters cleared as a result of the CLEAR=SRQRETRY parameter.
IST2119I
  • This is an optional message that is issued when the DISPLAY EEDIAG command contains HOSTNAME filters.
  • The correlator value is a unique display correlator associated with this DISPLAY EEDIAG command, which requires host name resolution. This correlator can be used to locate the various message groups associated with this DISPLAY EEDIAG command.

System action

Processing continues.

Operator response

If the nlp_retransmit_rate value displayed in message IST2068I is unusually high, the Enterprise Extender network might need to be diagnosed to determine why the packets are being discarded or lost. If the nlp_retransmit_rate value displayed in message IST2068I is unacceptable, and an alternate non-EE path to the partner exists, the EE connection might need to be deactivated so RTP pipes can pathswitch to the non-EE path.

System programmer response

None.

Source

z/OS® Communications Server SNA

Module

You can display the module that issues a SNA message in the message by setting the MSGMOD start option to YES. See Adding the originating module to the message text for more information about the MSGMOD start option.

Routing code

2

Descriptor code

5