IST663I
request REQUEST [{TO|FROM} adjnode] action, SENSE= code

Explanation

This message is the first in a group of messages that VTAM® issues when a request/response unit (RU) fails to complete successfully. A complete description of the message group follows.
IST663I  request REQUEST [{TO|FROM} adjnode] action, SENSE=code
IST664I  {REAL|ALIAS} {OLU|PLU}=luname1 {REAL|ALIAS} {DLU|SLU}=luname2
IST889I  SID = sessid
Note: One or more messages might follow IST889I. See "Additional messages" in this message explanation for more information.
IST663I
  • request is the name of the RU that failed. See Command and RU types in VTAM messages for a description of request.
  • action can be one of the following:
  • TO/FROM is not issued if the failing RU flows in a same domain session. For example, if the INIT OTHER RU failed, TO/FROM is not issued. FROM is issued only if a request failed, not as a reply to a request.
  • adjnode is the SSCP which sent or is to receive the request, or the related resource to which the request was sent. If a CDINIT failed to initiate an adjacent SSCP for any reason, this message is issued in the following format:
    IST663I  CDINIT REQUEST FROM SSCP1A FAILED, SENSE=0801000F
  • code provides additional information about the cause of the failure. See the z/OS Communications Server: IP and SNA Codes for a description of code.
IST664I
  • This message occurs during session initiation request and response processing. The origin LU (luname1) might be either the primary logical unit or the secondary logical unit. The same applies for the destination LU (luname2). The real names of the session partners will be displayed if they are known (indicated by REAL);, otherwise the alias names will be displayed (indicated by ALIAS). The DLU’s name will indicate REAL if it has been assumed. When the session setup direction cannot be determined, PLU and SLU will be displayed rather than OLU and DLU.
    Note: ***NA*** is displayed in place of the network identifier portion of the LU name, or the whole LU name, if either is not known.
IST889I
  • The session ID sessid provides a unique identifier for the session. If the session ID is unknown, VTAM displays ***NA***.
Additional messages
  • One or more messages might follow IST889I, depending on the type of error.
    • Processing error
      IST264I  REQUIRED resource [luname] reason
      or
      IST1138I REQUIRED resource [luname] reason
      The combination of resource and reason can be any of the following:
      ADJSSCP TABLE
      UNDEFINED
      COS NAME cosname
      UNDEFINED
      LOGMODE NAME logmode
      UNDEFINED
      RESOURCE luname
      UNDEFINED
      RESOURCE luname
      NOT ACTIVE
      RESOURCE luname
      UNSTABLE (device-type LUs only)
      RESOURCE luname
      DISABLED
      RESOURCE luname
      QUIESCING
      RESOURCE luname
      BLOCKING LOGONS (for application PLUs only)
      STORAGE
      NOT AVAILABLE
      luname appears when resource is RESOURCE. luname is the real name of the LU or application that was in error. If the SLU is not known, VTAM displays ***NA*** for luname.
      • If a network-qualified name was entered on the command line and the MSGLVL option specifies V4R1 or above, VTAM displays message IST1138I and issues luname as a network-qualified name in the form netid.name
      • If the default is used or the MSGLVL option specifies BASE, VTAM issues message IST264I, and luname is not network-qualified.

      See the z/OS Communications Server: SNA Resource Definition Reference for a description of the MSGLEVEL start option and the MSGLVL operand on the USSMSG macro.

      See the explanation of IST264I or IST1138I for additional information.

    • Autologon session setup failure
      IST890I  AUTOLOGON SESSION SETUP FAILED
      This message indicates that an autologon attempt to a controlling PLU failed. The autologon could have originated from one of the following:
      • VARY LOGON or VARY ACT with LOGON command
      • VARY ACT command that applied to LUs with LOGAPPL specified
      • Reallocation of the controlling PLU session
    • Dynamic dial failure
       IST1015I APPLICATION SUPPLIED parameter name = parameter value
      [IST1028I parameter value]

      See the explanation of IST1015I for additional information.

    • Extended sense data
       IST891I  netid.nodename1[.nodename2] GENERATED FAILURE NOTIFICATION
      [IST892I  resourcename ORIGINATED FAILURE NOTIFICATION]
       IST893I  ORIGINAL FAILING REQUEST IS request

      See the explanation of IST891I for additional information.

    • Notification of available resource
      IST896I  AUTOLOGON WILL BE RETRIED WHEN CONTROLLING PLU IS AVAILABLE

      See the explanation of IST896I for additional information.

    • Adjacent SSCP table information
      [IST1705I sc_option = sc_value FROM START OPTION]
      [IST1704I sc_option = sc_value FROM ADJACENT SSCP TABLE]
       IST894I  ADJSSCPS TRIED  FAILURE SENSE   ADJSSCPS TRIED  FAILURE SENSE
       IST895I     sscpname        sense        sscpname        sense
      For IST1705I or IST1704I:
      • sc_option indicates a search control option that was used for the session. Possible values are: SORDER and SSCPORD. When VTAM is enabled for APPN, both search control options will be displayed with SORDER being first. When VTAM is not enabled for APPN, SSCPORD will be the only search control option displayed. Either IST1704I or IST1705I will be issued for each search control option displayed.
      • sc_value indicates the value of the search control option that was used for the session. If sc_value is ADJLIST, the adjacent SSCP table used for this session was for a resource that specified an adjacent CDRM list (ADJLIST); therefore, the SORDER and SSCPORD search control options do not apply.

      For IST895I, see the explanation of IST894I for additional information.

    • Translation error
      IST523I  REASON = IMPROPER TRANSLATION OF {OLU|DLU} NAME

      During an LU-LU session setup request, VTAM requested that the alias-name translation facility translate either the OLU name (luname1) or the DLU name (luname2), and the facility returned a different name with the same network identifier. If the alias and real names are in the same network, VTAM requires that the names be the same.

    • TN3270 Resource information
      [IST1727I DNS NAME: dns_name]
      [IST1728I dns_name_continued]
       IST1669I IPADDR..PORT ipaddr..portno

      Messages IST1669I, IST1727I, and IST1728I will be allowed whenever the SLU of the session is known to be a TN3270-connected application, CDRSC, or LU resource.

    • Border node search information
      [IST2208I sc_option = sc_value FROM START OPTION]
      [IST2209I sc_option = sc_value FROM ADJCLUST TABLE]
      For IST2208I or IST2209I:
      • The sc_option value indicates a border node search control option that was used for the locate. Possible values are: BNORD and BNDYN. When VTAM is enabled as a border node and performs border node searching, both border node search control options are displayed. Either IST2208I or IST2209I is issued for each search control option.
      • The sc_value value indicates the value of the search control option that was used for the search. When the sc_option value is BNORD, possible sc_value values are PRIORITY and DEFINED. When the sc_option value is BNDYN, possible sc_value values are NONE, LIMITED, and FULL. See z/OS Communications Server: SNA Resource Definition Reference for a description of the values.
    • APPN Locate Search Failure information
       IST1942I APPN LOCATE SEARCH STEPS ATTEMPTED 
      [IST1943I DIRECTED SEARCH TO A SERVED END NODE] 
      [IST1953I   search nodename - SENSE code FROM reply nodename]
      [IST1944I DIRECTED SEARCH TO A NETWORK NODE] 
      [IST1953I   search nodename - SENSE code FROM reply nodename] 
      [IST1945I DIRECTED SEARCH TO A BORDER NODE]
      [IST1953I   search nodename - SENSE code FROM reply nodename] 
      [IST1946I LOCAL SUBAREA SEARCH] 
      [IST1953I   search nodename - SENSE code FROM reply nodename]
      [IST1947I BROADCAST SEARCH TO SERVED END NODES] 
      [IST1953I   search nodename - SENSE code FROM reply nodename] 
      [IST1948I DIRECTED SEARCHES TO BORDER NODES]
      [IST1953I   search nodename - SENSE code FROM reply nodename] 
      [IST1949I DIRECTED SEARCH TO A CENTRAL DIRECTORY SERVER] 
      [IST1953I   search nodename - SENSE code FROM reply nodename] 
      [IST1950I DIRECTED SEARCHES TO ALTERNATE CENTRAL DIRECTORY SERVERS] 
      [IST1953I   search nodename - SENSE code FROM reply nodename]
      [IST1951I BROADCAST SEARCH TO NETWORK NODES] 
      [IST1953I   search nodename - SENSE code FROM reply nodename] 
      [IST1952I DIRECTED SEARCHES TO INTERCHANGE NODES] 
      [IST1953I   search nodename - SENSE code FROM reply nodename]
      See IST1942I for a complete description of the message group.
    • Session path information
      [IST2102I RSCV FROM PLU]
      [IST1460I TGN  CPNAME             TG TYPE      HPR]       
      [IST1461I tgn  cpname             tgtype       hpr]
      [IST2103I RSCV TOWARDS SLU] 
      [IST1460I TGN  CPNAME             TG TYPE      HPR]       
      [IST1461I tgn  cpname             tgtype       hpr]
      [IST2104I RSCV TOWARDS DLUR] 
      [IST1460I TGN  CPNAME             TG TYPE      HPR]       
      [IST1461I tgn  cpname             tgtype       hpr]

      See the explanation of IST2102I, IST2103I, or IST2104I for additional information.

System action

  • If action is FAILED or RECEIVED, the LU-LU session setup request fails.
  • If action is PURGED, the LU-LU session setup request continues its routing to other SSCPs. If there are no additional adjacent SSCPs, the LU-LU session setup fails.

Operator response

Save the system log for problem determination.

System programmer response

  • If action is FAILED or RECEIVED, review the definition for the facility where the LU translation is defined. Either change the name translation for the LU or change the network ID of the translated name to a different network identifier.
  • If action is PURGED, verify that the timeout value specified for IOPURGE on either the MODIFY IOPURGE command or the IOPURGE start option is adequate. If this value is too small, it might result in premature routing failures.

    If the IOPURGE value is adequate, verify that the adjacent SSCP adjnode in message IST663I is active and operational.

    See z/OS Communications Server: SNA Operation for a description of the MODIFY IOPURGE command. See the z/OS Communications Server: SNA Resource Definition Reference for a description of the IOPURGE start option.

User response

Not applicable.

Problem determination

See the System programmer response.

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

8

Descriptor code

4

Example

Not applicable.