IST2001I

Explanation
 VTAM® issues
this message as part of a group of messages in response to a  DISPLAY
EE command for Enterprise Extender connection 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.    IST2001I ENTERPRISE EXTENDER CONNECTION INFORMATION
[IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator]
[IST075I NAME = name, TYPE = type ]
[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]
 IST2346I CP NAME = cp_name
 IST2022I EE CONNECTION ACTIVATED ON date AT TIME time
 IST2114I LIVTIME:    INITIAL = init_value MAXIMUM = max_value CURRENT = cur_value
[IST2023I CONNECTED TO LINE linename ]
[IST2024I CONNECTED TO SWITCHED PU puname ]
[IST2343I EE HEALTH VERIFICATION NOT SUPPORTED BY REMOTE EE PARTNER]
 IST2025I LDLC SIGNALS RETRANSMITTED AT LEAST ONE TIME      = numsignals
 IST2026I LDLC SIGNALS RETRANSMITTED SRQRETRY TIMES         = numsignals
 IST2009I RTP PIPES = rtppipes    LU-LU SESSIONS           = sessions
 IST2027I DWINOP  = dwinop    REDIAL = redial    REDDELAY = reddelay
 IST2028I KEEPACT = keepact     
[IST924I -------------------------------------------------------------]
[IST2030I PORT PRIORITY = SIGNAL ]
[IST2029I   MTU SIZE = mtusize]
[IST2036I   NLPS SENT           = nlps_sent          ( estimate ) ]
[IST2037I   BYTES SENT          = bytes_sent         ( estimate ) ]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate ) ]
[IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate ) ]
[IST2040I   NLPS RECEIVED       = nlps_received      ( estimate ) ]
[IST2041I   BYTES RECEIVED      = bytes_received     ( estimate ) ]
[IST924I -------------------------------------------------------------]
[IST2031I PORT PRIORITY = NETWORK]
[IST2029I   MTU SIZE = mtusize]   
[IST2036I   NLPS SENT           = nlps_sent          ( estimate ) ]
[IST2037I   BYTES SENT          = bytes_sent         ( estimate ) ]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate ) ]
[IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate ) ]
[IST2040I   NLPS RECEIVED       = nlps_received      ( estimate ) ]
[IST2041I   BYTES RECEIVED      = bytes_received     ( estimate ) ]
[IST924I -------------------------------------------------------------]
[IST2032I PORT PRIORITY = HIGH  ]
[IST2029I   MTU SIZE = mtusize]  
[IST2036I   NLPS SENT           = nlps_sent          ( estimate ) ]
[IST2037I   BYTES SENT          = bytes_sent         ( estimate ) ]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate ) ]
[IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate ) ]
[IST2040I   NLPS RECEIVED       = nlps_received      ( estimate ) ]
[IST2041I   BYTES RECEIVED      = bytes_received     ( estimate ) ]
[IST924I -------------------------------------------------------------]
[IST2033I PORT PRIORITY = MEDIUM ]
[IST2029I   MTU SIZE = mtusize]   
[IST2036I   NLPS SENT           = nlps_sent          ( estimate ) ]
[IST2037I   BYTES SENT          = bytes_sent         ( estimate ) ]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate ) ]
[IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate ) ]
[IST2040I   NLPS RECEIVED       = nlps_received      ( estimate ) ]
[IST2041I   BYTES RECEIVED      = bytes_received     ( estimate ) ]
[IST924I -------------------------------------------------------------]
[IST2034I PORT PRIORITY = LOW ]
[IST2029I   MTU SIZE = mtusize] 
[IST2036I   NLPS SENT           = nlps_sent          ( estimate ) ]
[IST2037I   BYTES SENT          = bytes_sent         ( estimate ) ]
[IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate ) ]
[IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate ) ]
[IST2040I   NLPS RECEIVED       = nlps_received      ( estimate ) ]
[IST2041I   BYTES RECEIVED      = bytes_received     ( estimate ) ]
 IST924I -------------------------------------------------------------
 IST2035I TOTALS FOR ALL PORT PRIORITIES
 IST2036I   NLPS SENT            = nlps_sent          ( estimate )
 IST2037I   BYTES SENT           = bytes_sent         ( estimate )
 IST2038I   NLPS RETRANSMITTED   = nlps_retransmitted ( estimate )
 IST2039I   BYTES RETRANSMITTED  = bytes_retransmitted( estimate )
 IST2040I   NLPS RECEIVED        = nlps_received      ( estimate )
 IST2041I   BYTES RECEIVED       = bytes_received     ( estimate )
[IST2042I count OF total EE CONNECTIONS DISPLAYED ]
 IST314I END

 IST075I   This message is displayed when a DISPLAY EE command is issued
using the ID  parameter.
name  is the name of the LINE or PU that is
displayed.  
type is described in Node and ID types in VTAM messages.

 IST924I  This message is a line separator between subgroups.      

 IST1680I   This is the first message of a message subgroup.  For DISPLAY
EE  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, will
 also be 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]
 IST2346I CP NAME = cp_name
 IST2022I EE CONNECTION ACTIVATED ON date AT TIME time
[IST2023I CONNECTED TO LINE linename ]
[IST2024I CONNECTED TO SWITCHED PU puname ]
 IST2025I LDLC SIGNALS RETRANSMITTED AT LEAST ONE TIME = numsignals
 IST2026I LDLC SIGNALS RETRANSMITTED SRQRETRY TIMES    = numsignals
 IST2009I RTP PIPES = rtppipes    LU-LU SESSIONS      = lusessions
 IST2027I DWINOP  = dwinop    REDIAL = redial    REDDELAY = reddelay
 IST2028I KEEPACT = keepact   
 IST2029I MTU SIZE = mtusize  
 IST924I -------------------------------------------------------------
 IST2035I TOTALS FOR ALL PORT PRIORITIES
 IST2036I   NLPS SENT           = nlps_sent          ( estimate )
 IST2037I   BYTES SENT          = bytes_sent         ( estimate )
 IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )
 IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate )
 IST2040I   NLPS RECEIVED       = nlps_received      ( estimate )
 IST2041I   BYTES RECEIVED      = bytes_received     ( estimate )

 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 IP  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.

 IST2001I  This message is the header message for the Enterprise  Extender
connection display output.

 IST2009I  rtppipes is the number of RTP pipes originating
in  this host that  traverse EE connections associated with the local
IP address  displayed in message IST1680I of this subgroup.    
sessions is the number of LU-LU sessions associated
with the rtppipes.

 IST2022I  The date and time values
specify when  this EE  connection was activated. See DATE and TIME formats for information about the date and time values.

 IST2023I  linename is the name of the Enterprise Extender
line  that is being used  for this Enterprise Extender connection.

 IST2024I  puname is the name of the switched PU that
is being  used for this  Enterprise Extender connection.  

 IST2025I  numsignals is the number of Logical Data Link
Control  (LDLC) signals that had to be retransmitted at least one
time, prior to a  response being received from the partner Enterprise
 Extender node.

 IST2026I  numsignals is the number of Logical Data Link
Control  (LDLC) signals that had to be retransmitted SRQRETRY times,
prior to a  response being received from the partner Enterprise Extender
node.

 IST2027I  dwinop  is the value of the DWINOP parameter
associated with this  Enterprise Extender physical unit.  The DWINOP
parameter  specifies whether the physical unit is to be dialed after
it has INOPed.  
redial is the value of the REDIAL parameter
associated with this Enterprise       Extender physical unit. The
REDIAL parameter specifies the number of times dialing is to be  
    tried again before returning a dialing error to VTAM. 
reddelay is the value of the REDDELAY parameter
associated with this  Enterprise Extender physical unit.  The REDDELAY
parameter  specifies the number of seconds between each attempt to
 redial an Enterprise Extender connection.   

 IST2028I   keepact  is the value of the KEEPACT parameter
associated with this  Enterprise Extender line.  The KEEPACT parameter
specifies  whether the line used for this Enterprise Extender connection
 should be automatically reactivated when the line is  deactivated
by a link INOP.   

 IST2029I  This message is associated with a subgroup of messages that begins
with message IST2030I, IST2031I, IST2032I, IST2033I, or IST2034I.
When policy-based routing is in effect, the MTU size might be different
for each of the ports, depending on the routes chosen for EE traffic.
 This message is issued for each of the five EE ports, regardless
of whether policy-based routing is in effect and regardless of whether
the display is for an IPv4 or IPv6 connection. 
mtusize is the size of the largest packet that VTAM will send over this Enterprise
Extender connection. The MTU size (both IPv4 and IPv6) might change
during the life of the EE connection. The displayed value is obtained
in the following manner: VTAM queries the TCP/IP
stack to obtain its MTU size and sets the EE connection to use this
value.  This MTU size has already been reduced to account for various
header lengths such as the IP, UDP, and LLC headers necessary for
EE traffic.
VTAM takes into account
the VTAM MTU operand value,
if it is specified.  The MTU operand can be specified on three types
of VTAM major nodes: For EE connection networks, this operand is defined on the connection
network GROUP definition statements in the EE XCA major node.    
For dial-in EE connections with associated PUs that are dynamically
created, this operand is defined on the model major node (DYNTYPE=EE)
PU definition statement.   
For predefined EE connections, this operand is defined on the
PU definition statement in the switched major node.  

VTAM uses the lesser of
the TCP/IP stack computed MTU size and the VTAM defined MTU operand value (if it is specified).
 If the TCP/IP stack value is less than 768 bytes, VTAM sets the MTU value to 768 because this
is the smallest packet size allowed by the HPR architecture.   Generally,
the MTU size for an EE connection is reasonably constant when the
EE connection is established.  However, in the event that the TCP/IP
stack MTU size changes, RTP pipes with endpoints on the same node
as the TCP/IP stack dynamically detect these changes when their outbound
packets are being transmitted.  Some reasons for MTU size changes
include the following: New IP routes become available, which have different local MTU
sizes.
Existing IP routes become unavailable. 
Path MTU discovery is enabled for IPv4 or IPv6 EE connections,
and path MTU changes are discovered in the IP network. See the PMTUD start option information in z/OS Communications Server: SNA Resource Definition
Reference.

 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 IST2029I, IST2036I, IST2037I, IST2038I, IST2039I, IST2040I,
and IST2041I.
IST2035I is a header message for a subgroup that displays a summary
of all port priorities. This subgroup includes the same messages as
those that are listed for each port priority subgroup, with the exception
of IST2029I.
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
IST2029I   MTU SIZE = mtusize
IST2036I   NLPS SENT           = nlps_sent          ( estimate )
IST2037I   BYTES SENT          = bytes_sent         ( estimate )
IST2038I   NLPS RETRANSMITTED  = nlps_retransmitted ( estimate )
IST2039I   BYTES RETRANSMITTED = bytes_retransmitted( estimate )
IST2040I   NLPS RECEIVED       = nlps_received      ( estimate )
IST2041I   BYTES RECEIVED      = bytes_received     ( estimate )

 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.  
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.

 IST2037I  This message is associated with a subgroup of messages that begins
with message IST2030I, IST2031I, IST2032I, IST2033I, IST2034I or IST2035I.
bytes_sent is the total number of bytes  that
have been sent  across this EE  connection for this specific priority.
 This value is maintained from the time this connection was  activated.

estimate is an estimate of the displayed bytes_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 bytes.
M
estimate is in units of 1 000 000 bytes.
G
estimate is in units of 1 000 000 000 bytes.
T
estimate is in units of 1 000 000 000 000 bytes.
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.     
estimate is an estimate of the displayed nlps_retransmitted.
   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.

 IST2039I  This message is associated with a subgroup of messages that begins
with message IST2030I, IST2031I, IST2032I, IST2033I, IST2034I or IST2035I.

bytes_retransmitted is the total number of
bytes that have been retransmitted  across this EE  connection for
this specific priority.  This value is maintained from the time  this
 connection was activated.     
estimate is an estimate of the displayed bytes_retransmitted.
  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 bytes.
M
estimate is in units of 1 000 000 bytes.
G
estimate is in units of 1 000 000 000 bytes.
T
estimate is in units of 1 000 000 000 000 bytes.
P
estimate is in units of 1 000 000 000 000 000 bytes.

 IST2040I  This message is associated with a subgroup of messages that begins
with message IST2030I, IST2031I, IST2032I, IST2033I, IST2034I or IST2035I.

nlps_received is the total number of network
layer packets (NLP)  that have  been received across this EE connection
 for this specific priority.  This value is maintained from the time
this  connection was activated.   
estimate is an estimate of the displayed nlps_received.
   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.

 IST2041I  This message is associated with a subgroup of messages that begins
with message  IST2030I, IST2031I, IST2032I, IST2033I, IST2034I or
IST2035I.   
bytes_received is the total number of bytes
 that have been received across  this EE connection  for this specific
priority.  This value is maintained from the time this  connection
was activated.     
estimate is an estimate of the displayed bytes_received.
  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 bytes.
M
estimate is in units of 1 000 000 bytes.
G
estimate is in units of 1 000 000 000 bytes.
T
estimate is in units of 1 000 000 000 000 bytes.
P
estimate is in units of 1 000 000 000 000 000 bytes.

 IST2042I  This is an optional message that is issued when the DISPLAY EE
command  contains either a remote IPADDRor a remote HOSTNAME.    
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 EE command.  The
total might be larger than  the displayed count because the number
of EE connections displayed  is governed by the MAX parameter.

 IST2114I  This message displays the initial, maximum and current LIVTIME
values for an Enterprise Extender connection. See the information
about the external communication adapter (XCA)
major node in z/OS Communications Server: SNA Resource Definition
Reference for more information about the LIVTIME operand
for Enterprise Extender.
init_value is the initial LIVTIME value, in
seconds, defined for Enterprise Extender connections.
max_value is the maximum LIVTIME value, in
seconds, defined for Enterprise Extender connections.
cur_value is the current LIVTIME value, in
seconds, being used by this Enterprise Extender connection.

 IST2119I  This is an optional message that is issued when the DISPLAY EE
command contains HOSTNAME filters.
The correlator value is a unique display correlator
associated with this DISPLAY EE command, which requires host name
resolution.  This correlator can be used to locate the various message
groups associated with this DISPLAY EE command. 

 IST2323I  During the activation of the EE Connection, VTAM sent Logical Data Link Control (LDLC) probes
to the remote partner  to determine if all five ports are accessible. VTAM did not receive a response
from any of the LDLC probe requests. VTAM continued
with the activation of the EE connection between this node and the
remote partner. Because VTAM received
no replies to its LDLC probe requests, VTAM determined
that the remote partner does not support EE health verification. 

IST2346Icp_name is the CP name of the remote node
associated with this Enterprise Extender connection.

System action
 Processing continues.

Operator response
 None.

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

Automation
 Not recommended.