LATCP$HELP.HLB  —  SHOW  NODE
    Displays the status and LAT characteristics of a node.

    Format

      SHOW NODE  [node-name]

1  –  Parameter

 node-name

    Specifies the name of the node for which information is
    displayed. If you do not specify a node name, LATCP displays
    information about the local node.

    You can also specify any valid wildcard for this parameter
    For example, the SHOW NODE A* command displays the status and
    characteristics of all nodes that begin with the letter A.

2  –  Qualifiers

2.1    /ALL

    Displays information about all nodes known to your local node.
    When you use this qualifier, specify the /FULL or /BRIEF
    qualifier as well. If you do not specify either the /FULL or
    /BRIEF qualifier, the default display will contain the node
    status and identification string (the display generated by the
    /BRIEF qualifier).

2.2    /BRIEF

    Displays the node status and identification string. This is the
    default display if you specify the /ALL qualifier.

2.3    /COUNTERS

    Displays the counters kept for the node. Do not use the /BRIEF or
    /FULL qualifier with this qualifier. LAT Node Counters lists and
    describes the counters displayed with SHOW NODE/COUNTERS.

    Table 6 LAT Node Counters

    Counter            Description

    Messages received  The total number of LAT messages received by
                       the local node. If you specify a remote node
                       with the SHOW NODE command, the number of LAT
                       messages received from that remote node.
    Messages           The total number of LAT messages transmitted
    transmitted        by the local node. If you specify a remote
                       node with the SHOW NODE command, the number of
                       LAT messages transmitted to that remote node.
    Slots received     The total number of LAT slots received by the
                       local node. If you specify a remote node with
                       the SHOW NODE command, the number of slots
                       received from that remote node. A slot is a
                       message segment that contains information
                       corresponding to a single session.
    Slots transmitted  The total number of LAT slots transmitted by
                       the local node. If you specify a remote node
                       with the SHOW NODE command, the number of
                       slots transmitted to that remote node.
    Bytes received     The total number of bytes of LAT information
                       received by the local node. If you specify a
                       remote node with the SHOW NODE command, the
                       number of bytes received from that remote
                       node.
    Bytes transmitted  The total number of bytes of LAT information
                       transmitted by the local node. If you specify
                       a remote node with the SHOW NODE command, the
                       number of bytes transmitted to that remote
                       node.
    Multicast bytes    The total number of LAT multicast bytes
    received           received by the local node.
    Multicast bytes    The total number of LAT multicast bytes sent
    sent               by the local node.
    Multicast          The total number of LAT multicast messages
    messages received  received by the local node.
    Multicast          The total number of LAT multicast messages
    messages sent      sent by the local node.
    No transmit        The total number of times no buffer was
    buffer             available on the local node for transmission.
    Multicast          The total number of times LTDRIVER failed to
    messages lost      process an inbound multicast message because
                       of failed communication with the LATACP.
    Multicast send     The total number of times LTDRIVER failed to
    failures           send a multicast message because of failed
                       communication with the LATACP.
    Controller errors  The total number of times LTDRIVER failed
                       to communicate with the data link controller
                       driver.
    Last controller    The most recent controller error.
    error
    Multiple node      The total number of times that a node
    addresses          announced itself with a physical address
                       different from that in a previous
                       announcement.
    Duplicates         The total number of duplicate messages
    received           received by the local node. If you specify
                       a remote node with the SHOW NODE command, the
                       number of duplicate messages received from
                       that remote node. This counter can indicate a
                       system slowdown.
    Messages           The total number of LAT messages that the
    retransmitted      local node retransmitted because they were
                       not acknowledged by terminal servers (or
                       nodes that support outgoing connections). If
                       you specify a remote node with the SHOW NODE
                       command, the number of messages retransmitted
                       to that remote node.
    Illegal messages   The total number of invalidly formatted LAT
    received           messages received by the local node. If you
                       specify a remote node with the SHOW NODE
                       command, the number of invalidly formatted
                       messages the local node received from that
                       remote node. Illegal messages are grouped into
                       several types of protocol errors, which are
                       listed at the end of this table.
    Illegal slots      The total number of invalidly formatted LAT
    received           slots received by the local node. If you
                       specify a remote node with the SHOW NODE
                       command, the number of invalidly formatted
                       slots the local node received from that remote
                       node.
    Solicitations      The total number of times a remote node
    accepted           accepted solicitations from the local node. If
                       you specify a remote node with the SHOW NODE
                       command, the number of accepted solicitations
                       by that remote node.
    Solicitations      The total number of times a remote node
    rejected           rejected solicitation from the local node. If
                       you specify a remote node with the SHOW NODE
                       command, the number of rejected solicitations
                       by that remote node.
    Solicitation       The total number of times solicitations by the
    failures           local node received no response.
    Transmit errors    The total number of times the data link failed
                       to transmit a LAT message.
    Last transmit      The most recent transmit error.
    error
    Virtual circuit    The total number of times a LAT circuit to
    timeouts           another node timed out, indicating that the
                       remote node failed to send a valid message
                       in the required time span. If you specify a
                       remote node with the SHOW NODE command, the
                       number of times the local node timed out from
                       a connection to that remote node.
    Discarded output   The total number of data bytes that were
    bytes              discarded because of an overflow of an
                       internal buffer before the data could be
                       output to an LTA device.
    User data lost     The total number of times LTDRIVER failed to
                       allocate resources to buffer session data.
                       User data is lost and the session is stopped.
    Resource errors    The number of times LTDRIVER was unable to
                       allocate system resources.
    Incoming solicits  The total number of times the local node
    accepted           accepted solicitations from other nodes.
    Incoming solicits  The total number of times the local node
    rejected           rejected solicitations from other nodes.

    The protocol errors that are counted as illegal messages are as
    follows. These protocol error messages are displayed if their
    associated counter is greater than zero:

    o  Invalid message type received

    o  Invalid start message received

    o  Invalid sequence number received in start message

    o  Zero-node index received

    o  Node circuit index out of range

    o  Node circuit sequence invalid

    o  Node circuit index no longer valid

    o  Circuit was forced to halt

    o  Invalid server slot index

    o  Invalid node slot index

    o  Invalid credit field or too many credits used

    o  Repeat creation of slot by server

    o  Repeat disconnection of slot by master

2.4    /FULL

    Displays the node's status, identification string, LAT protocol
    version, and the values of the node's characteristics. This is
    the default except when you specify the /ALL qualifier.

2.5    /STATUS

    Displays statistical information for parameters such as the
    number of active circuits, sessions, and incoming queue entries.
    For each parameter, the display shows the current value, the
    highest value recorded, and the maximum value allowed.

    Note that you can specify the /STATUS qualifier with the SHOW
    NODE command to display information about the local node only
    (for example, the command SHOW NODE /STATUS FOREIGN_NODE is not
    supported).

3  –  Examples

    1.LATCP> SHOW NODE/FULL

      The SHOW NODE command in this example produces the following
      display of information about the local node:

        Node Name:   LTC                  LAT Protocol Version:      5.2
        Node State:  On
        Node Ident:  LTC - Engineering Development

        Incoming Connections:  Enabled    Incoming Session Limit:   None
        Outgoing Connections:  Enabled    Outgoing Session Limit:   None
        Service Responder:     Disabled

        Circuit Timer (msec):        80   Keepalive Timer (sec):      20
        Retransmit Limit (msg):      20   Node Limit (nodes):       None
        Multicast Timer (sec):       20   CPU Rating:                  8
        Maximum Unit Number:       9999

        User Groups:     43, 73
        Service Groups:  7-9,13,23,40,43,45,66,72-73,89,120-127,248-255

        Service Name     Status      Rating  Identification
        LTVMS            Available     31 D  .

      This display indicates that the local node LTC is in the On
      state, which means LAT connections can be created on the
      node. LTC is running Version 5.2. of the LAT protocol. The
      identification of the node is "LTC - Engineering Development".
      Because this is the local node, the display does not give
      the address of a LAN device. Use the SHOW LINK command to
      find addresses of devices on the local node. The display for
      the status of remote nodes, as shown in Example 2, gives the
      Ethernet address of that node.

      Both incoming and outgoing connections can be made on node LTC,
      the number of sessions is unlimited. The display indicates the
      values of various timers and lists the groups that are enabled.
      Users on the local node can access service nodes belonging to
      user groups 43 and 73. Locally offered services can be accessed
      by nodes belonging to the service groups listed.

      The display indicates that the CPU rating of the local node
      is 8. The display shows that the node offers a service named
      LTVMS. This service is available and its rating is 31 D
      (dynamic). (An S would indicate the rating is static.)

    2.LATCP> SHOW NODE/FULL RWWUP

      The SHOW NODE command in this example produces the following
      display about the remote node RWWUP:

        Node Name:   RWWUP              LAT Protocol Version:      5.2
        Node State:  Reachable          Address:     AA-00-04-00-11-10
        Node Ident:  .

        Incoming Connections:  Enabled

        Circuit Timer (msec):        80
        Multicast Timer (sec):       20

        Service Groups:  7, 13, 42-43, 45, 66, 70-72, 75-82, 88-89

        Service Name     Status      Rating  Identification
        NAC              Available     28    .
        SYSMGR           Available     28    .

      This display indicates that remote node RWWUP is reachable and
      runs Version 5.2 of the LAT protocol. The display includes the
      Ethernet address of node RWWUP. Because incoming connections
      are enabled, you can connect to a service on node RWWUP,
      provided that your node belongs to one of the service groups
      listed in the display.

      Node RWWUP offers two services: NAC and SYSMGR. Both are
      available.

    3.LATCP> SHOW NODE/ALL/BRIEF

      The SHOW NODE command in this example produces the following
      display about all nodes known to the local node:

        Node Name       Status       Identification
        ---------       -----------  -----------------------------------
        ABLAN           Reachable     Unauthorized access is prohibited.
        ASKWEN          Reachable     .
        CHUNK           Reachable     A member of the MAIN VMScluster
                  .
                  .
                  .
        UTOO            On            Can be healthy at the Center
        VULCUN          Reachable     Beam me up
        ZENX            Reachable     ZENX

      The SHOW NODE command in this example indicates the status
      (whether a node is reachable) and identification of all nodes
      known to the local node. Note also that the display includes
      the status of the local node UTOO. The status can be either On,
      Off, or Shut. Here it is On.

    4.$ LCP :== $LATCP
      $ LCP SHOW NODE /STATUS

      The SHOW NODE /STATUS in this example produces the following
      display:

        Node Name:   NODE1                       LAT Protocol Version: 5.2
        Node State:  On
        Node Ident:  Test system

                                   Current   Highest   Maximum
                                   -------   -------   -------
        Active Circuits:                 1         2      1023
        Connected Sessions:              1         6    260865
        Incoming Queue Entries:          0         0        24
        Outgoing Queue Entries:          0         1     32767
        Unprocessed Announcements:       0         7       500
        Unprocessed Solicits:            0         2       250

        Local Services:                  1         2       255
        Available Services:            188       194       N/A
        Reachable Nodes:               166       172       N/A

        Discarded Nodes:                 0
Close Help