LATCP$HELP.HLB  —  SHOW

1  –  LINK

    Displays the status and LAT characteristics of links on the local
    node.

    Format

      SHOW LINK  [link-name]

1.1  –  Parameter

 link-name

    Specifies the name for a LAT data link. A link name can have up
    to 16 ASCII characters.

    If you do not specify a link name, LATCP displays information
    about all links currently defined for the node.

1.2  –  Qualifiers

1.2.1    /BRIEF

    Displays the device name and state of the link. This is the
    default display.

1.2.2    /COUNTERS

    Displays the device counters kept for the link. The numbers
    displayed represent the values recorded since the last time the
    counters were reset (when the node first started or when the ZERO
    COUNTERS command was used).

    Do not use the /BRIEF or /FULL qualifier with this qualifier.

    Counters Common to CSMA/CD and FDDI Links lists and describes
    counters common to both CSMA/CD (carrier sense, multiple
    access with collision detect) and FDDI (fiber distributed data
    interface) links.

    Table 1 Counters Common to CSMA/CD and FDDI Links

    Counter            Description

    Messages received  The total number of messages received over the
                       link.
    Multicast          The total number of multicast messages
    messages received  received over the link.
    Bytes received     The total number of bytes of information
                       received over the link.
    Multicast bytes    The total number of multicast bytes received
    received           over the link.
    System buffer      The total number of times no system buffer was
    unavailable        available for an incoming frame.
    Unrecognized       The total number of times a frame was
    destination        discarded because there was no portal with
                       the protocol enabled. This count includes
                       frames received for the physical address only.
    Messages sent      The total number of messages sent over the
                       link.
    Multicast          The total number of multicast messages sent
    messages sent      over the link.
    Bytes sent         The total number of bytes of information sent
                       over the link.
    Multicast bytes    The total number of bytes of multicast
    sent               messages sent over the link.
    User buffer        The total number of times no user buffer was
    unavailable        available for an incoming frame that passed
                       all filtering.
    Data overrun       The total number of bytes lost on the link's
                       device because the local node's input buffers
                       were full. A nonzero value can indicate noisy
                       lines, a bad device, a busy or poorly tuned
                       system (not enough resources allocated), or
                       a hardware problem with another device on the
                       LAN connection.

    Receive Errors Common to CSMA/CD and FDDI Links lists and
    describes receive errors common to both CSMA/CD and FDDI links.
    These errors, which are included in the display generated by
    the SHOW LINK/COUNTERS command, are represented by flags that
    indicate the error has occurred.

    Table 2 Receive Errors Common to CSMA/CD and FDDI Links

    Flag               Description

    Block check error  CRC error in packet(s) received.
    Framing error      Received frame(s) ended incorrectly.
    Frame too long     Frame(s) received longer than length limits.
    Frame status       CRC error on ring noticed by local FDDI
    error              station (FDDI only).
    Frame length       Frame length too short (FDDI only).
    error

    Transmit Errors Common to CSMA/CD and FDDI Links lists and
    describes transmit errors common to both CSMA/CD and FDDI links.
    These errors, which are included in the display generated by
    the SHOW LINK/COUNTERS command, are represented by flags that
    indicate the error has occurred.

    Table 3 Transmit Errors Common to CSMA/CD and FDDI Links

    Flag               Description

    Excessive          Frame(s) failed to transmit because the
    collisions         collision limit of 16 was reached (CSMA/CD
                       only).
    Carrier check      Indicates transceiver problem or short circuit
    failures           in cable.
    Short circuit      Short circuit in cable.
    Open circuit       Open circuit in cable.
    Frame too long     Frame(s) too long. Indicates a transmission
                       problem in one of the portals using the link.
    Remote failure to  A remote station failed to defer frame(s)
    defer              transmission. Could indicate a misconfigured
                       network.
    Transmit underrun  Transmission of a frame was too slow.
                       Indicates a hardware controller error.
    Transmit failure   Frame(s) failed to transmit.

    CSMA/CD Counters lists and describes link counters specific to
    CSMA/CD only.

    Table 4 CSMA/CD Counters

    Counter            Description

    Transmit CDC       The total number of carrier detect check
    failure            errors, that is, the number of times the local
                       node failed to detect that another Ethernet
                       station was already transmitting when the
                       local node began transmitting.
    Messages           Single collision-The total number of times
    transmitted:       a frame was successfully transmitted on the
                       second attempt after a normal collision on the
                       first attempt.

                       Multiple collision-The total number of times
                       a frame was successfully transmitted on the
                       third or later attempt after normal collisions
                       on previous attempts.

                       Initially deferred-The total number of times
                       a frame transmission was deferred on its
                       first attempt. This counter is used to measure
                       Ethernet contention with no collisions.

    FDDI Counters lists and describes link counters specific to FDDI
    only.

    Table 5 FDDI Counters

    Counter                Description

    Ring initializations   The total number of times a ring
    initiated              reinitialization was initiated by the
                           link.
    Ring initializations   The total number of times a ring
    received               reinitialization was initiated by some
                           other link.
    Directed beacons       The number of times the link detected the
    received               directed beacon process. Each invocation
                           of the directed beacon process is counted
                           only once.
    Connections completed  The number of times the station
                           successfully connected to the
                           concentrator.
    Duplicate tokens       The number of times a duplicate token was
    detected               detected on the link.
    Ring purge errors      The number of times the ring purger
                           received a token while still in the ring
                           purge state.
    LCT rejects            Link Confidence Test rejects. Indicates a
                           problem with communication between station
                           and concentrator.
    Elasticity buffer      Elasticity buffer function errors.
    errors                 Indicates a station on the ring with a
                           transmit clock out of tolerance.
    MAC error count        The number of times the MAC (Media Access
                           Control) changed the E indicator in a
                           frame from R to S.
    Traces initiated       The number of times the PC-trace process
                           was initiated by the link.
    Traces received        The number of times the link was requested
                           to perform the PC-trace process.
    Ring beacons           The number of times the ring beacon
    initiated              process was initiated by the link.
    Link errors            The number of times the Link Error Monitor
                           (LEM) detected an error in a received
                           message. Slow counts are normal.
    Duplicate address      The number of times the link address was a
    test failures          duplicate.
    FCI strip errors       The number of times a Frame Content
                           Independent Strip operation was terminated
                           by receipt of a token.
    LEM rejects            The number of times excessive LEM errors
                           were encountered.
    MAC frame count        The total number of frames (other than
                           tokens) seen by the link.
    MAC lost count         The total number of times a frame (other
                           than a token) was improperly terminated.

1.2.3    /FULL

    Displays the device name, state, and datalink address of the link
    and indicates whether the DECnet address is enabled.

1.3  –  Examples

    1.LATCP> SHOW LINK/FULL NETWORK_A

      The SHOW LINK command in this example produces the following
      display of information about link NETWORK_A:

        Link Name:     NETWORK_A   Datalink Address:  08-00-2B-10-12-E3
        Device Name:   _ESA7:      DECnet Address:    Disabled
        Link State:    On

      The display in this example gives the device name of link
      NETWORK_A and the device's hardware address. The link is in
      the On state.

2  –  NODE

    Displays the status and LAT characteristics of a node.

    Format

      SHOW NODE  [node-name]

2.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.2  –  Qualifiers

2.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.2    /BRIEF

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

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

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

3  –  PORT

    Displays the status and LAT characteristics of ports on the local
    node.

    Format

      SHOW PORT  [port-name]

3.1  –  Parameter

 port-name

    Specifies the name of the port for which information is
    displayed. If you do not specify a port name, the SHOW PORT
    command displays the characteristics for all LTAn: ports on a
    node.

    Do not use the /APPLICATION, /DEDICATED, /FORWARD, or
    /INTERACTIVE qualifiers with a specific port name.

    In addition do not use the /LIMITED qualifier with a specific
    port name.

3.2  –  Qualifiers

3.2.1    /APPLICATION

    Generates a display of all application ports.

3.2.2    /BRIEF

    Displays port type, port status, and the remote node name, port,
    and service associated with the port. This is the default if you
    do not specify a port name with the SHOW PORT command.

3.2.3    /COUNTERS

    Displays the counters kept for the port. Do not use the /BRIEF or
    /FULL qualifiers with this qualifier.

3.2.4    /DEDICATED

    Generates a display of all dedicated ports.

3.2.5    /FORWARD

    Generates a display of all LAT ports used for either outgoing LAT
    connections or local LAT management functions.

3.2.6    /FULL

    Displays the following information:

    o  Port type

    o  Port status

    o  Target port name, node name, and service name associated with
       the port

    o  Remote node name, port, and service associated with the port
       if a connection is currently active

    For more information, see the description of the SHOW PORT/FULL
    example.

3.2.7    /INTERACTIVE

    Generates a display of all LAT ports used for incoming
    interactive connections.

3.2.8    /LIMITED

    Generates a display of all limited LTA devices on the system
    (previously established with the CREATE PORT /LIMITED or SET PORT
    /LIMITED command).

3.3  –  Examples

    1.LATCP> SHOW PORT /FULL

      The SHOW PORT command in this example produces the following
      type of display. The display reflects the characteristics set
      by the command examples given with the SET PORT command.

        Local Port Name:   _LTA16:           Local Port Type:  Forward
        Local Port State:  Inactive
        Connected Link:

         Target Port Name:                      Actual Port Name:
         Target Node Name:     LATCP$MGMT_PORT  Actual Node Name:
         Target Service Name:                   Actual Service Name:

        --------------------------------------------------------------

        Local Port Name:   _LTA17:       Local Port Type:  Interactive
        Local Port State:  Active
        Connected Link:    LAT$LINK

         Target Port Name:         Actual Port Name:  PORT_1
         Target Node Name:         Actual Node Name:  MY_DS200_SERVER
         Target Service Name:      Actual Service Name:

        --------------------------------------------------------------

        Local Port Name: _LTA19: Local Port Type: Application (Queued)
        Local Port State:  Active
        Connected Link:    LAT$LINK

         Target Port Name:               Actual Port Name:
         Target Node Name:     TLAT1     Actual Node Name:     TLAT1
         Target Service Name:  PRINTER   Actual Service Name:  PRINTER

        --------------------------------------------------------------

        Local Port Name:   _LTA21:         Local Port Type:  Dedicated
        Local Port State:  Inactive
        Connected Link:

         Target Port Name:                      Actual Port Name:
         Target Node Name:                      Actual Node Name:
         Target Service Name:  GRAPHICS         Actual Service Name:

        --------------------------------------------------------------

        Local Port Name: _LTA22: Local Port Type: Application (Queued)
        Local Port State:  Active
        Connected Link:    LAT$LINK

         Target Port Name:     LN02         Actual Port Name:    LN02
         Target Node Name:     TS33EW       Actual Node Name:   TS33EW
         Target Service Name:               Actual Service Name:

        --------------------------------------------------------------

      The display in this example shows information about all the
      ports on the local node. The display shows information for each
      of the four types of ports:

      o  Forward: a port used for outgoing LAT connections or for
         executing local management functions and LATCP commands.
         Port LTA16: is a forward port. The display shows that the
         port is currently inactive-no current LAT connection exists.
         The target node name of LATCP$MGMT_PORT indicates that LATCP
         is using this port to execute the LATCP commands entered
         by the user. If the display listed a node and service name,
         it would mean that the port is being used for an outgoing
         connection.

      o  Interactive: a port created as a result of an incoming LAT
         connection request from another node or terminal server.
         Port LTA17: is an interactive port connected with port PORT_
         1 on the terminal server MY_DS200_SERVER.

      o  Application: a port used for solicited connections to
         devices on terminal servers or to application services on
         remote LAT service nodes. Port LTA22: is an application
         port. The port maps to port LN02 (a printer) on a terminal
         server node TS33EW. The display indicates that server TS33EW
         queues connection requests from the local node. Port LTA19:
         is also an application port. The port maps to the service
         PRINTER on terminal server TLAT1.

      o  Dedicated: a port dedicated to a local application service.
         Port LTA21: is dedicated to the service GRAPHICS.

      The target port name, target node name, and target service
      name are the names specified with the SET PORT command. They
      are passed to the remote node or terminal server when the
      connection request is made.

      The actual port name, actual node name, and actual service name
      are the names returned by the remote node when it accepts the
      connection request. They may differ from the corresponding
      target names (specified with the SET PORT command) if the
      remote node translates the names. For example, terminal servers
      that accept connections to LAT service names usually return the
      name of the port to which the connection was actually directed.

    2.LATCP> SHOW PORT LTA1 /COUNTERS

      The SHOW PORT /COUNTERS command in this example produces a
      display that lists counter information for the LTA1 device.

        Port Name:  _LTA1:

        Seconds Since Zeroed:                66
        Remote Accesses:                      0   Framing Errors:      0
        Local Accesses:                       0   Parity Errors:       0
        Bytes Transmitted:                    0   Data Overruns:       0
        Bytes Received:                       0   Password Failures:   0
        Solicitations Accepted:               1
        Solicitations Rejected:               1
        Incoming Solicits Accepted:           0
        Incoming Solicits Rejected:           0
        Last disconnect reason code:         18
            (%LAT-F-LRJDELETED, queue entry deleted by server)

4  –  QUEUE_ENTRY

    Displays information about requests, or entries, queued on the
    local node.

    Format

      SHOW QUEUE_ENTRY  [queue-entry-id]

4.1  –  Parameter

 queue-entry-id

    Specifies the identification number (ID) of the queued entry
    for which information is displayed. If you do not specify a
    value for this parameter, information about all queued entries
    is displayed.

4.2  –  Qualifiers

4.2.1    /BRIEF

    Displays the following information about the queued entries:

    o  Position

    o  Entry ID

    o  Source node

    o  Service

    o  Port name

    (This is the default display.)

4.2.2    /FULL

    In addition to the information displayed by the /BRIEF qualifier,
    the /FULL qualifier provides the following information for each
    node:

    o  Node queue position

    o  Service queue position

    o  Node address

    o  Soliciting Link

4.3  –  Examples

    1.LATCP> SHOW QUEUE_ENTRY

      The SHOW QUEUE_ENTRY command in this example produces the
      following type of display.

        Position  Entry ID  Source Node       Service           Port Name
        --------  --------  ----------------  ----------------  ---------
           1      79EC      NODE1             LAT_LIMITED
           2      7AEC      NODE2             LAT_LIMITED
           3      7CEC      NODE3             LAT_LIMITED

    2.LATCP> SHOW QUEUE_ENTRY/FULL

      The SHOW QUEUE_ENTRY/FULL command in this example produces the
      following type of display.

        Entry ID:                 7AEC      Remote Node: NODE1
        Node Queue Position:         1      Address:     08-00-2B-0A-A0-A0
        Service Queue Position:      1

         Target Port:
         Target Service:  LAT_LIMITED
         Soliciting Link: LAT$LINK

        -------------------------------------------------------------------

        Entry ID:                 7CEC      Remote Node: NODE2
        Node Queue Position:         2      Address:     AA-00-04-00-37-DD
        Service Queue Position:      2

         Target Port:
         Target Service:  LAT_LIMITED
         Soliciting Link: LAT$LINK

5  –  SERVICE

    Displays the status and LAT characteristics of LAT services known
    to the local node.

    Format

      SHOW SERVICE  [service-name]

5.1  –  Parameters

 service-name

    Specifies the name of the service for which information will be
    displayed. If you do not specify a service name, LATCP displays
    information about all services known to the node.

    You can also specify any valid wildcard for this parameter. For
    example, the SHOW SERVICE LAT_* command displays the status and
    characteristics of all services that begin with the LAT_ prefix.

5.2  –  Qualifiers

5.2.1    /BRIEF

    Displays the status and identification string of the service.

5.2.2    /COUNTERS

    Displays the counters kept for the service. Do not use the /BRIEF
    or /FULL qualifier with this qualifier. The following table lists
    and describes the counters:

    Counter           Description

    Remote Counters

    Connections       The total number of times the local node
    attempted         attempted to connect to the service offered
                      on a remote node.
    Connections       The total number of times the local node
    completed         successfully connected to the service offered
                      on a remote node.

    Local Counters

    Connections       The total number of times the local node
    accepted          accepted a connection request from a remote
                      node to a locally offered service.
    Connections       The total number of times the local node
    rejected          rejected a connection request from a remote
                      node to a locally offered service.
    Password          The total number of connect requests to the
    failures          service which were rejected due to password
                      violation errors.

5.2.3    /FULL

    Displays the status, identification string, and type of service,
    and the values set for service characteristics. This qualifier
    also displays the status of all service nodes offering the
    service.

5.2.4    /LOCAL

    Displays information about services offered by the local node
    only. You can use this qualifier with the /BRIEF, /COUNTERS, or
    /FULL qualifier.

5.3  –  Examples

    1.LATCP> SHOW SERVICE NODE1 /FULL

      The SHOW SERVICE command in this example produces the following
      display of information about service NODE1. This service is
      offered by the local node.

        Service Name:    NODE1               Service Type:  General
        Service Status:  Available           Connections:   Enabled
        Service Password: Enabled            Queueing:      N/A
        Service Ident:    NODE1 - Test system

        Node Name            Status      Rating   Identification
        LAV                  On            31 D   .
        LATP                 Reachable     48     .
        LITTN                Reachable     37     .
        LTDRV                Reachable     82     .

      The display in this example indicates that the locally offered
      service NODE1 is available and its service type is general,
      meaning that it is a general timesharing service (in contrast
      to a dedicated application service). The display also lists the
      status of all the nodes that offer the service. The local node
      is LAV. The status of the local node can be either On, Off,
      or Shut. Here node LAV's status is On. The status of the other
      nodes indicates whether they are reachable. The display lists
      the ratings of each service node, indicating their relative
      capacity to accept new connections. The D next to the locally
      offered service indicates that node LAV computes its rating
      dynamically. An S would indicate that the node's rating was set
      permanently by the node's system manager.

    2.LATCP> SHOW SERVICE OFFICE/FULL

      The SHOW SERVICE command in this example produces the following
      display of information about the service OFFICE, which is
      offered by a remote node:

        Service Name:    OFFICE
        Service Status:  Available
        Service Ident:   .

        Node Name            Status      Rating   Identification
        BURGIL               Reachable    121     .
        DARWIN               Reachable     43     .

      The display in this example indicates that the service is
      available. The display also indicates the status and other
      information about the nodes that offer the service, BURGIL and
      DARWIN.
Close Help