IST2119I
ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator

Explanation

VTAM® issues this message as part of a group of messages in response to a DISPLAY EE or DISPLAY EEDIAG command that specifies HOSTNAME filters, or in response to a DISPLAY EEDIAG, TEST=YES command. This message is the first in various message groups. This message can also be contained in other message groups headed by message IST2001I, IST2002I, IST2065I, IST2066I, or IST2130I. See the explanation of those messages for a complete description. A complete description of the message groups headed by this message follows.

The following message group is issued when VTAM accepts the DISPLAY EE or DISPLAY EEDIAG command that specifies HOSTNAME filters:
 IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator
[IST2067I EEDIAG DISPLAY ISSUED ON date AT time]
 IST2120I HOSTNAME RESOLUTION IN PROGRESS
 IST314I END
The following message group is issued by VTAM when host name resolution processing successfully completes for a DISPLAY EE command that specifies HOSTNAME filters:
 IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator
 IST2121I HOSTNAME RESOLUTION COMPLETE
[IST1680I type IP ADDRESS ip_address]
[IST1910I LOCAL HOSTNAME value]
[IST1911I value]
[IST1680I type IP ADDRESS ip_address]
[IST1909I REMOTE HOSTNAME value]
[IST1911I value]
 IST314I END 
The following message group is issued by VTAM when host name resolution processing successfully completes for a DISPLAY EEDIAG command that specifies HOSTNAME filters:
 IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator
 IST2121I HOSTNAME RESOLUTION COMPLETE
[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]
[IST2126I CONNECTIVITY TEST IN PROGRESS]
 IST314I END
The following message group is issued by VTAM when host name resolution failure occurs for a DISPLAY EE or DISPLAY EEDIAG command that specifies HOSTNAME filters:
 IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator
 IST2121I HOSTNAME RESOLUTION COMPLETE
[IST1893I NAME-TO-ADDRESS RESOLUTION FAILED]
[IST1680I type IP ADDRESS ip_address]
[IST1910I LOCAL HOSTNAME value]
[IST1911I value]
[IST1893I NAME-TO-ADDRESS RESOLUTION FAILED]
[IST1680I type IP ADDRESS ip_address]
[IST1909I REMOTE HOSTNAME value]
[IST1911I value]
IST314I END
The following message group is issued by VTAM when it accepts a DISPLAY EEDIAG,TEST=YES command that did not specify HOSTNAME filters:
 IST2119I ENTERPRISE EXTENDER DISPLAY CORRELATOR: correlator
 IST2067I EEDIAG DISPLAY ISSUED ON date AT time
 IST1680I type IP ADDRESS ip_address
 IST1680I type IP ADDRESS ip_address
 IST2023I CONNECTED TO LINE linename
 IST2126I CONNECTIVITY TEST IN PROGRESS
 IST314I END
IST1680I
  • This message is displayed for the following reasons:
    • When host name resolution is required to process the display command and the name-to-address function fails for the local host name, this message is issued to display the remote IP address. This IP address might have been specified as input using the IPADDR filter, or it might have been acquired through the host name resolution function.
    • When host name resolution is required to process the display command and the name-to-address function fails for the remote host name, this message is issued to display the local IP address. This IP address might have been specified as input using the IPADDR filter, or it might have been acquired through the host name resolution function.
    • When a D NET,EEDIAG,TEST=YES command is entered that did not specify host name filters, this message is issued to display the local and remote IP addresses used for the EE connectivity test. In this case, the first occurrence of this message identifies the local IP address and the second occurrence identifies the remote IP address.
  • In the message text:
    type
    Indicates which IP address is being displayed. The value is either LOCAL or REMOTE.
    ip_address
    Indicates the IP address.
IST1893I
  • This message is the first in a group of messages displayed when resolution of a host name into an IP address is attempted but was unsuccessful.
  • The following message group is issued by VTAM when host name resolution fails for the local host name:
     IST1893I NAME-TO-ADDRESS RESOLUTION FAILED
     IST1910I LOCAL HOSTNAME value
    [IST1911I value]
    [IST1680I type IP ADDRESS ip_address]
    [IST1909I REMOTE HOSTNAME value]
    [IST1911I value]
     IST314I END

    Result: If host name resolution fails for the local host name, VTAM also displays the information available for the REMOTE filter. This information is presented in the optional messages IST1680I, IST1909I, and IST1911I.

  • The following message group is issued by VTAM when host name resolution fails for the remote host name:
    [IST1680I type IP ADDRESS ip_address]
    [IST1910I LOCAL HOSTNAME value]
    [IST1911I value]
     IST1893I NAME-TO-ADDRESS RESOLUTION FAILED
     IST1909I REMOTE HOSTNAME value
    [IST1911I value]
     IST314I END

    Result: If host name resolution fails for the remote host name, VTAM also displays the information available for the LOCAL filter. This information is presented in optional messages IST1680I, IST1910I, and IST1911I.

IST1909I
  • In the message text:
    value
    The host name supplied to the name-to-address function that is used to acquire the remote IP address. The remote IP address is then used to process the display command. If the host name is longer than 44 characters, then the first 44 characters are displayed as the value value and the remaining characters are displayed in one or more IST1911I messages.
IST1910I
  • In the message text:
    value
    The host name supplied to the name-to-address function that is used to acquire the local IP address. The local IP address is then used in the processing of the display command. If the host name is longer than 45 characters, then the first 45 characters are displayed as the value value and the remaining characters are displayed in one or more IST1911I messages.
IST1911I
  • In the message text:
    value
    The continuation of the value value on messages IST1909I and IST1910I. Message IST1911I is repeated as many times as necessary to display the entire character string.
IST2023I
  • In the message text:
    linename
    The name of the Enterprise Extender line that VTAM is using to perform an Enterprise Extender connectivity test.
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.
IST2119I
  • In the message text:
    correlator
    A unique display correlator associated with this DISPLAY EE or DISPLAY EEDIAG command, which requires host name resolution. This correlator can be used to locate the various message groups associated with this display command.
IST2120I
  • This message indicates that name-to-address resolution for the host name filters has been initiated. When the host name resolution completes, another IST2119I message group is issued, which includes message IST2121I.
IST2121I
  • This message indicates that name-to-address resolution for the host name filters has completed.
IST2126I
  • This message is issued when VTAM initiates an Enterprise Extender connectivity test. When the connectivity test completes, a message group headed by IST2130I is issued.

System action

If message IST1893I is issued to report a host name resolution failure, the DISPLAY EE or DISPLAY EEDIAG command is not performed. Otherwise, the DISPLAY EE or DISPLAY EEDIAG command processing continues.

Operator response

If message IST1893I is issued to report a host name resolution failure, save the system log for problem determination if the correct host name value is being resolved. If you specified an incorrect host name, specify the correct host name and issue the display command again.

System programmer response

If message IST1893I is issued to report a host name resolution failure, and the correct host name is being specified on the display command, ensure the following:
  • The name-to-address resolution mapping for the host name yields the correct static VIPA address (if on a z/OS® host) of the node that owns the host name.
  • If network address translation (NAT) is in use, the name-to-address resolution mapping for the host name yields the correct NAT address to ultimately reach the target static VIPA address of the node that owns the host name.

If the resolution is not correct, update the DNS zone files or the appropriate local hosts files with the corrected name-to-address resolution. If the resolution is intended to yield an IPv6 address, ensure that the TCP/IP stack is enabled for IPv6 processing so that the resolver searches for IPv6 addresses. See the information about resolvers in z/OS Communications Server: IP Configuration Guide for more information about the resolver function.

User response

Not applicable.

Problem determination

Not applicable.

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

Example

None.