home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 8 Other / 08-Other.zip / r202041d.dsk / README.TXT < prev    next >
Text File  |  1994-12-14  |  63KB  |  1,294 lines
  1.                   IBM ROUTEXPANDER/2 VERSION 2.0.2
  2.  
  3.   CONTENTS
  4.   ────────
  5.   LICENSE INFORMATION and TRADEMARKS
  6.  
  7.   CHAPTER 1.  WHY README FIRST?
  8.  
  9.   CHAPTER 2.  NEW FEATURES IN ROUTEXPANDER/2 VERSION 2.0.2
  10.               3 Port Bridge Support
  11.               9 Port Bridge Support
  12.               IBM Auto LANStreamer MC 32 Adapter
  13.               Frame Relay Data Compression
  14.               Remote Installation
  15.               Enhanced Bridge Filters
  16.               Tools
  17.  
  18.   CHAPTER 3.  INSTALLATION AND USAGE
  19.               Installing a New Release of RouteXpander/2
  20.               On-line Help Messages
  21.               Sample Bridge Filter Files
  22.               WAC Diagnostics Available on RouteXpander/2 3rd Base Diskette
  23.  
  24.   CHAPTER 4.  NEW TOOLS FOR PROBLEM DETERMINATION AND TRACING
  25.               Wide Area Connector Adapter Status Display (WACSTAT.EXE)
  26.               Frame Relay Status Display (NETSTATF.EXE and FRNOTEBK.EXE)
  27.               Bridge Counter Display (BDMPCNT.EXE)
  28.               IPX Router Status Display (NETSTATX.EXE)
  29.               Token Ring Network Connectivity Test (OS2PING.EXE)
  30.               Tracing for Troubleshooting and Filter Development (GSDTRACE.EXE)
  31.  
  32.   CHAPTER 5.  NOTES ON RELATED PRODUCTS
  33.               PS/ValuePoint Flash PROM Levels
  34.               IBM Token Ring 16/4 Shared RAM Adapter:  Use Size of 64K or 32K
  35.               IBM 16/4 ISA Token Ring Network Adapter - Switch Settings
  36.               IBM 16/4 ISA Token Ring Network Adapter - Example Configuration
  37.               IBM Wide Area Connector for ISA Bus -  Switch Settings
  38.               IBM Wide Area Connector for ISA Bus -  Example Configuration
  39.  
  40.   CHAPTER 6.  ROUTEXPANDER/2 KNOWN PROBLEMS
  41.               OS/2 Warp
  42.               MPTS/2
  43.               WAC
  44.               RouteXpander/2 Nodes with IPX Lockup using Novell Server 3.12
  45.               RouteXpander/2 Remote Installs: SRVIFS Must Be LAST in CONFIG.SYS
  46.               RouteXpander/2 Console's "Keys Help" Not Available
  47.               RouteXpander/2 Console's Message Log's "Save as..." Unreliable
  48.               RouteXpander LNM Support/2 Extraneous Alert
  49.  
  50. ***********************************************************************
  51.   LICENSE INFORMATION
  52.   ───────────────────
  53.   The licensed program described in this document and all licensed material
  54.   available for it are provided by IBM under terms of the Agreement for IBM
  55.   Licensed Programs.
  56.  
  57.   Any reference to an IBM licensed program in this document is not intended
  58.   to state or imply that only IBM's program may be used.
  59.  
  60.   IBM may have patents or pending patent applications covering subject
  61.   matter described in this document.  The furnishing of this document does
  62.   not give you any license to these patents.  You can send inquiries, in
  63.   writing, to the IBM Director of Commercial Relations, International
  64.   Business Machines Corporation, Purchase, New York, 10577.
  65.  
  66.   References in this publication to IBM products, programs, or services do
  67.   not imply that IBM intends to make them available in all countries in
  68.   which IBM operates.
  69.  
  70.   This document is not intended for production use and is furnished as is
  71.   without any warranty of any kind, and all warranties are hereby
  72.   disclaimed including the warranties of merchantability and fitness for a
  73.   particular purpose.
  74.  
  75.   TRADEMARKS
  76.   ──────────
  77.   The following terms, denoted by an asterisk (*) at their first
  78.   occurrences in this publication, are trademarks of IBM Corporation in the
  79.   United States or other countries:
  80.  
  81.   ┌─────────────────────┬─────────────────────┬─────────────────────┐
  82.   │ IBM                 │ PS/2                │ OS/2                │
  83.   ├─────────────────────┼─────────────────────┼─────────────────────┤
  84.   │ ValuePoint          │ Presentation        │ PS/2                │
  85.   │                     │ Manager             │                     │
  86.   └─────────────────────┴─────────────────────┴─────────────────────┘
  87.  
  88.   The following terms, denoted by a double asterisk (**) at their first
  89.   occurrences in this publication, are trademarks of other companies:
  90.  
  91.   TRADEMARK                      OWNED BY
  92.   NDIS                          3Com Corporation/Microsoft Corp.
  93.  
  94. ************************************************************************
  95.   CHAPTER 1.  WHY README FIRST?
  96.   ─────────────────────────────
  97.   This document contains important information about the IBM(*)
  98.   RouteXpander/2 Version 2.0.2 product.  Information that has become
  99.   available since the production of the RouteXpander/2 User's Guide and
  100.   Reference documents has been included in this README.TXT file.
  101.  
  102.   You should familiarize yourself with the contents of this document before
  103.   attempting to install and use this product.
  104.  
  105.   This ASCII text version of this document, named README.TXT, is found
  106.   in the \GSD directory on the disk drive upon which RouteXpander/2 is
  107.   installed.
  108.  
  109. ************************************************************************
  110.   CHAPTER 2.  NEW FEATURES IN ROUTEXPANDER/2 VERSION 2.0.2
  111.   ─────────────────────────────────────────────────────────
  112.   RouteXpander/2 Version 2 Release 0.2 contains several enhancements to
  113.   previous releases:
  114.  
  115.   3 Port Bridge Support
  116.   ─────────────────────
  117.   The RouteXpander/2 Version 2.0.2 Base Program supports up to three ports
  118.   for source-route bridging.  Previous releases supported two ports for
  119.   source-route bridging.
  120.  
  121.   As in previous releases, the RouteXpander/2 Version 2.0.2 platform allows
  122.   for multiport routing.  With the IPX Router provided with the IBM
  123.   RouteXpander V2.0.2 Base Program, one can now configure up to nine ports
  124.   for IPX routing.  With IBM's TCP/IP for OS/2 program, one can configure
  125.   up to eight ports for IP routing.  And, with IBM's Communications
  126.   Manager/2 (CM/2), one can configure SNA and APPN support for any
  127.   combination of two WAN (frame-relay or leased-line or X.25) or LAN ports,
  128.   plus two SDLC ports.  (The number of ports supported by these products
  129.   may change in future releases.  Please contact your IBM representative
  130.   for the latest information.)
  131.  
  132.   9 Port Bridge Support
  133.   ─────────────────────
  134.   RouteXpander/2 Version 2.0.2 is the first release of the RouteXpander/2
  135.   Base Program that can be used with the optional RouteXpander Multiport
  136.   Support/2 program.  With the RouteXpander Multiport Support/2 program,
  137.   RouteXpander/2 supports up to nine ports for source-route bridging.
  138.   These nine ports can be composed of any combination of eight WAN ports
  139.   and two LAN ports.
  140.  
  141.   IBM Auto LANStreamer MC 32 Adapter
  142.   ──────────────────────────────────
  143.   The IBM Auto LANStreamer MC 32 Adapter is supported for both bridging and
  144.   routing with RouteXpander/2 Version 2.0.2.  RouteXpander/2 can share this
  145.   high performance token-ring adapter with other programs such as the IBM
  146.   LAN Server.
  147.  
  148.   Frame Relay Data Compression
  149.   ────────────────────────────
  150.   RouteXpander/2 Version 2.0.2 supports data compression for point-to-point
  151.   leased lines and frame-relay networks.  (This is in addition to data
  152.   compression for X.25 traffic, which first became available with
  153.   RouteXpander/2 Version 2.0.)  See "Data Compression for Communications"
  154.   in chapter 18 of the RouteXpander/2 User's Guide and Reference
  155.   (SC30-3671-01) for an explanation of the data compression available for
  156.   RouteXpander/2.
  157.  
  158.   Remote Installation
  159.   ───────────────────
  160.   A remote installation feature has been added to the RouteXpander/2
  161.   install process which allows you to remotely install RouteXpander/2
  162.   on your work stations.  Any OS/2 workstation that has NTS/2 NetBIOS
  163.   support can be used as a data repository.  (Note that, contrary to what
  164.   is written in the "IBM RouteXpander/2 Version 2 Release 0.2 User's Guide
  165.   and Reference," you do NOT need to have IBM LAN Server installed.)
  166.  
  167.   Enhanced Bridge Filters
  168.   ───────────────────────
  169.   The filtering capabilities of the source-route bridge have been enhanced
  170.   with the addition of outbound filters and automatic filters.  Outbound
  171.   filters provide control of frame forwarding with respect to the
  172.   destination bridge port.  Automatic filters provide filtering of frames
  173.   used by certain protocol routers, when those routers are present in the
  174.   same node as the source-route bridge.  See the IBM RouteXpander/2 User's
  175.   Guide and Reference, Chapter 15, "RouteXpander/2 Bridge Filters" on page
  176.   15-1 for more information on this topic.
  177.  
  178.   Tools
  179.   ─────
  180.   Several useful software tools are located in the \GSD\TOOLS subdirectory.
  181.   These tools can provide real-time status information as well as assist in
  182.   troubleshooting network and machine problems.  These tools are provided
  183.   on an as-is basis.  See Chapter 3 of this README.TXT for a complete
  184.   description.
  185.  
  186. **************************************************************************
  187.   CHAPTER 2.  INSTALLATION AND USAGE
  188.  
  189.   Installing a New Release of RouteXpander/2
  190.   ──────────────────────────────────────────
  191.   Installing a new release of RouteXpander/2 is performed exactly like an
  192.   initial installation of RouteXpander/2.  Insert the RouteXpander/2, Disk
  193.   1, into the floppy drive, and type 'A:\INSTALL' from the 'C:\>' prompt.
  194.   After the main panel is displayed, select the 'INSTALL' button to install
  195.   the new release.  Ignore the 'SERVICE' button, this is used only for
  196.   installing Corrective Service Diskette (CSD) patches.  (RouteXpander/2
  197.   Version 2.0.2 is not considered a CSD of RouteXpander/2 Version 2.0.)
  198.   After the 'INSTALL' button is pressed, a message will then appear:
  199.  
  200.      "A previous copy of RouteXpander/2 Install and Configuration
  201.       initialization file was found.  Select 'Yes' to create a new
  202.       configuration file, or 'No' to use the existing file, or
  203.       'Cancel' to terminate the installation program."
  204.  
  205.   Unless you are changing the configuration of the RouteXpander/2, select
  206.   'No' (which is the button highlighted by default) to use the existing
  207.   initialization file.  If 'Yes' is selected, you will need to reset the
  208.   Console options before rebooting the workstation.
  209.  
  210.   After all of the installation process is complete, reboot the
  211.   workstation.
  212.  
  213.   Reconfiguration of RouteXpander/2 using LAPS, MPTS/2, or the X.25
  214.   configuration program is not required.
  215.  
  216.   On-line Help Messages
  217.   ─────────────────────
  218.   The RouteXpander/2 2.0.2 User's Guide and Reference's Chapter 17,
  219.   "RouteXpander/2 Messages and SNA Alerts" (under the first subsection,
  220.   "RouteXpander/2 Messages," starting on page 17-2), lists all of the
  221.   RouteXpander/2 help messages known at the time of the document's
  222.   production.  To receive the most up-to-date help for RouteXpander/2,
  223.   three on-line facilities exist.  These on-line facilities supplement and
  224.   provide alternatives to the hardcopy User's Guide and Reference that was
  225.   supplied with your product:
  226.  
  227.     (1) For messages found in the "Message Log" window of the
  228.         RouteXpander/2 Console, point to the displayed message for which
  229.         you want more information and double-click the left mouse button.
  230.         This will display a help window with information specific to the
  231.         message to which the mouse is pointing.
  232.  
  233.     (2) Use the OS/2 HELP command.  Thus, for instance, if in LANTRAN.LOG
  234.         or in the Console's Message Log you find a message with the message
  235.         number "GSD1046," you can go to any OS/2 command-line prompt (in
  236.         either an OS/2 full-screen session or an OS/2 window) and type:
  237.  
  238.                HELP GSD1046
  239.  
  240.         and information specific to the identified message will be
  241.         displayed.  Note that this only works for warnings and error
  242.         messages, not informational messages.
  243.  
  244.     (3) A list of all RouteXpander/2 messages has been provided and
  245.         supersedes messages documented in the RouteXpander/2 User's Guide
  246.         and Reference.  To view these message, you can double-click on
  247.         the "RouteXpander/2 Messages" icon in the "RouteXpander/2"
  248.         folder on your OS/2 Desktop (placed there during RouteXpander/2
  249.         installation), or, at an OS/2 prompt, type:
  250.  
  251.                VIEW \GSD\GSDMSG.INF
  252.  
  253.         Use can use your mouse or keyboard or both to navigate through this
  254.         RouteXpander/2 Message Reference.  The RouteXpander/2 Message
  255.         Reference supplies help for all RouteXpander/2 messages, including
  256.         informational, warning and error messages.
  257.  
  258.   Sample Bridge Filter Files
  259.   ──────────────────────────
  260.   In the User's Guide, Chapter 15, "RouteXpander/2 Bridge Filters", a
  261.   number of example filters are shown and discussed.  Additional bridge
  262.   filter files can be found in the subdirectory \GSD\SAMPLES\FILTER.  These
  263.   filters provide helpful examples for understanding the basic types of
  264.   bridge filters.
  265.  
  266.     GSDSRB.IP    IP filter (automatically installed if IP routing configured)
  267.     GSDSRB.IPX   IPX filter (automatically installed if IPX routing configured)
  268.     GSDSRB.MC1   Masking MAC addresses
  269.     GSDSRB.MC2   Multiple source MAC addresses
  270.     GSDSRB.MC3   Using the the same MAC address for source and destination
  271.     GSDSRB.NB    Requester communication with specific LAN Servers
  272.     GSDSRB.NB2   Generic NetBIOS names using wildcard '*'
  273.     GSDSRB.NB3   Requester to server only communication
  274.     GSDSRB.NB4   Only one requester allowed to cross bridge
  275.  
  276.   WAC Diagnostics Available on RouteXpander/2 3rd Base Diskette
  277.   ─────────────────────────────────────────────────────────────
  278.   For ease of access, the latest WAC Diagnostics have been placed on the
  279.   third diskette of the base RouteXpander/2 product.  If, after installing
  280.   a WAC adapter, your machine traps on power-up, it may be due to a bad
  281.   WAC card.  To check, insert the third RouteXpander/2 (WAC Diagnostics)
  282.   diskette into your machine and reboot.  See the "Diagnostics" section of
  283.   the "IBM Wide Area Connector: Installation and Testing Instructions"
  284.   manual, which came with your WAC adapter, for more information.
  285.  
  286.  
  287.   ***********************************************************
  288.   CHAPTER 4.  NEW TOOLS FOR PROBLEM DETERMINATION AND TRACING
  289.  
  290.   RouteXpander/2 comes with the following software programs that are useful
  291.   in displaying network status and problem determination.
  292.  
  293.      WACSTAT.EXE  - displays IBM WAC-adapter status in an OS/2 Window
  294.      NETSTATF.EXE - displays frame-relay status in an OS/2 Window
  295.      FRNOTEBK.EXE - displays frame-relay status in a PM Window
  296.      BDMPCNT.EXE  - displays bridge counters in an OS/2 Window
  297.      NETSTATX.EXE - displays IPX-router status in an OS/2 Window
  298.      OS2PING.EXE  - tests connectivity of a bridged network (OS/2 Window)
  299.      GSDTRACE.EXE - post-processor of OS/2 TRACEFMT output
  300.  
  301.   Aside:  These tools were found to be very useful during the development and
  302.   testing of RouteXpander/2.  Therefore the developers of RouteXpander/2 felt
  303.   that is was important to pass these applications onto you, the customer.
  304.   These tools are provided as is.  No documentation is provided for these
  305.   tools, except for the information contained within this README.TXT file.
  306.   Reported problems pertaining to any of the above tools will be fixed on a
  307.   "as time is available" basis.
  308.  
  309.   Tools that run in OS/2 Windows can be accessed from remote sites using
  310.   telnet.  (TCP/IP for OS/2's telnetd must be installed and configured on the
  311.   target RouteXpander/2 node for this capability.)
  312.  
  313.   When starting the following programs:  wacstat, netstatf, frnotebk, and
  314.   netstatx, RouteXpander/2's Network Management Agent must not be running.  If
  315.   the Network Managment Agent is running, one of the following messages will
  316.   be displayed:
  317.  
  318.   "WARNING!!!
  319.    The RouteXpander/2 Network Management Agent is currently running.
  320.    Network Management Agent must be stopped before running <program>.  If
  321.    you're running RouteXpander/2 V2.0, go to the 'Components' window and stop
  322.    the Network Management Agent.  If you're running RouteXpander/2 V1.0, find
  323.    the NMA window and stop it by typing Ctrl-C."
  324.  
  325.                      or if running a PM application
  326.  
  327.   "The WAN device driver has already been opened by another application."
  328.  
  329.   If either of these messages are displayed, stop the Network Management Agent
  330.   and retry the command.
  331.  
  332.   If you do not require SNMP management, then you can configure your
  333.   RouteXpander/2 node so that the RouteXpander/2 "Network Management Agent"
  334.   component is not automatically started when your RouteXpander/2 Console is
  335.   started.  (Disabling the automatic starting of the Network Management Agent
  336.   facilitates the execution of various tools described in this section.)
  337.   Double-click on the "RouteXpander/2 Configuration" icon located in the
  338.   RouteXpander/2 folder.  Click on the "Configuration" button and then the
  339.   "Console" button on the following screen.  A dialog window will appear with
  340.   three autostart console check boxes:
  341.  
  342.                _  Bridge Manager
  343.                _  X.25 Support
  344.                _  Network Management Agent
  345.  
  346.   Deselect the "Network Managment Agent" check box and then exit.  The next
  347.   time the RouteXpander/2 console is started, the Network Management Agent
  348.   will not be automatically started.  See "Chapter 11.  The RouteXpander/2
  349.   Console and Local Management" in the RouteXpander/2 User's Guide for more
  350.   information.
  351.  
  352.   Wide Area Connector Adapter Status Display (WACSTAT.EXE)
  353.   ────────────────────────────────────────────────────────
  354.   The Wide Area Connector (WAC) Adapter is the preferred adapter for
  355.   interconnecting RouteXpander/2 with other bridge/routers over frame-relay or
  356.   leased-line wide area networks.  WACSTAT provides a simple display of the
  357.   WAC control lines and frame errors.  This information can be especially
  358.   useful for diagnosing DSU/CSU or line quality related problems.  For
  359.   example, if the WAC is detecting a large number of Frame Check Sequence
  360.   packet errors ("FCS Errors"), this indicates that there could be a remote
  361.   line quality problem.  The following sample WACSTAT output shows what
  362.   information is available.
  363.  
  364. ───────────────────────────Sample WACSTAT output───────────────────────────────
  365.   @ Copyright IBM 1994, All rights reserved.
  366.   Networking Systems, Research Triangle Park, NC
  367.  
  368.   Number of WAC ports = 1
  369.  
  370.   Port Type  In Speed   Out Speed
  371.   ==== ===== ========== ==========
  372.    01  V35   0000065536 0000065536
  373.  
  374.   Port Clock FCS Errors Tx Underruns Rcv Overruns Int Frames Abort Frames
  375.   ==== ===== ========== ============ ============ ========== ============
  376.    01    Ext 0000000008   0000000000   0000000000 0000000000   0000000002
  377.  
  378.   Port Bits Stop  Parity Auto Baud Parity Errs Frame Errs Overrun Errs
  379.   ==== ==== ===== ====== ========= =========== ========== ============
  380.  
  381.   Port  RTS  CTS  DSR  DTR  RI   DCD  SQ   SRS  SRTS SCTS SDCD
  382.   ====  ==== ==== ==== ==== ==== ==== ==== ==== ==== ==== ====
  383.    01    On   On   On   On  ---   On  ---  ---  ---  Off  Off
  384. ─────────────────────────End sample WACSTAT output─────────────────────────────
  385.  
  386.   Transmit underruns, receive overruns, and interrupted frames are not
  387.   currently detected.  Therefore, Tx Underruns, Rcv Overruns, and Int Frames
  388.   counters are not updated.  Also, the output line showing "Port Bits Stop
  389.   Parity..."  is used for displaying asynchronous dial line status.  Since
  390.   asynchronous dial connections are currently not supported by RouteXpander/2,
  391.   there is generally no information to display.
  392.  
  393.   Frame Relay Status Display (NETSTATF.EXE and FRNOTEBK.EXE)
  394.   ──────────────────────────────────────────────────────────
  395.   Frame-relay status can be displayed using one of two tools:  NETSTATF or
  396.   FRNOTEBK.  NETSTATF is a character based application which dumps to the
  397.   screen various frame-relay MIB variables.  FRNOTEBK is an OS/2 Presentation
  398.   Manager program which provides the same information as NETSTATF plus
  399.   displays "real-time" frame-relay line utilization status.
  400.  
  401.   The following output is a sample generated fron NETSTATF.
  402.  
  403. ───────────────────────────Sample NETSTATF output──────────────────────────────
  404.   @ Copyright IBM 1994, All rights reserved.
  405.   Networking Systems, Research Triangle Park, NC
  406.  
  407.   LA LMI T391 N391 N392 N393 Max VCs Multicast
  408.   == === ==== ==== ==== ==== ======= =========
  409.   01   3 0010 0006 0003 0004    0050 Non-BCast
  410.  
  411.   LA LINK S Sent Pkts  Rcv Pkts   Sent Bytes Rcv Bytes  Rcv FECNs  RCV BECNs
  412.   == ==== = ========== ========== ========== ========== ========== ==========
  413.   01 0032 A 0000000071 0000000342 0000003479 0000011569 0000000000 0000000000
  414.  
  415.   LA Error Type     Frame Data (in Hex)
  416.   == ============== ===================
  417.   01 No Errors      No Frame Data
  418. ─────────────────────────End sample NETSTATF output───────────────────────────-
  419.  
  420.   LA = Logical Adapter
  421.   T391 = Polling Interval
  422.   N391 = Full Inquiry Interval
  423.   N392 = Error Threshold Timer
  424.   N393 = Monitored Events Timer
  425.   Max VCs = Maximum number of support DLCIs or Virtual Circuits
  426.   LINK = DLCI or Virtual Circuit Number
  427.  
  428.   When invoking NETSTATF, one of the following parameters must be passed.
  429.  
  430.   -i = interface statistics
  431.   -c = circuit statistics
  432.   -e = last error reported status
  433.   -a = all status information
  434.  
  435.   If no parameters are specified, a brief help screen will be displayed.
  436.  
  437.   FRNOTEBK provides most of the information NETSTATF displays, but in a more
  438.   user-friendly interface.  Online help is not provided, but if you're
  439.   familiar with frame-relay, the information displayed should be self
  440.   explanatory.  If not, the following overview will help.
  441.  
  442.   FRNOTEBK screen layout resembles the following text diagram.
  443.  
  444.  ┌────────────────────────────────────────────────────────────────────────┐
  445.  │ WAN Status Notebook                                                    │
  446.  ├────────────────────────────────────────────────────────────────────────┤
  447.  │  Main  Refresh                                                         │
  448.  ╔════════════════════════════════════════════════════════════════════════╗
  449.  ║┌─WAN LMI Type───────────────┐                                          ║
  450.  ║│ X LMI Rev1     X Annex D   │               Maximum VCs       50       ║
  451.  ║└────────────────────────────┘                                          ║
  452.  ║┌─WAN LMI Parameters───────────────────────────────────────────────────┐║
  453.  ║│ Polling Interval (T391)       10     Error Threshold (N392)    3     │║
  454.  ║│ Full Enqriry Interval (N391)   6     Monitored Events (N393)   4     │║
  455.  ║└──────────────────────────────────────────────────────────────────────┘║
  456.  ║┌─Bandwidth Utilization────────────────────────────────────────────────┐║
  457.  ║│                                    ┌─Line Utilization──────────────┐ │║
  458.  ║│ LineSpeed   64000  bps             │ Outbound:  4%   Inbound  23%  │ │║
  459.  ║│                                    └───────────────────────────────┘ │║
  460.  ║└──────────────────────────────────────────────────────────────────────┘║
  461.  ║┌──────────────────────────────────────────────────────────────────────┐║
  462.  ║│ Link Act Pckts Xmit Pckts Rcvd Bytes Xmit Bytes Rcvd Rcvd FECNs Rcvd │║
  463.  ║│ ---- --- ---------- ---------- ---------- ---------- ---------- -----│║
  464.  ║│   32 Yes        235        112      11515       4327          0      │║
  465.  ║└──────────────────────────────────────────────────────────────────────┘║
  466.  ║                                                         ┌─────────────┐║
  467.  ║ Time: 17:06:47      Date: 1/5/95                        │   Refresh   │║
  468.  ║                                                         └─────────────┘║
  469.  ╚═╤════════════╤═════════════════════════════════════════════════════════╝
  470.  │ │ Adapter 1  │                                                         │
  471.  │ └────────────┘                                                         │
  472.  └────────────────────────────────────────────────────────────────────────┘
  473.  
  474.   Each configured adapter will have its statistics displayed on a separate
  475.   notebook page.  In the above example, only one adapter is configured.  The
  476.   adapter number is not arbitrary, but can be used to determine exactly which
  477.   adapter is represented.  The adapter number displayed on the notebook page
  478.   can be compared with the adapter numbers configured in LAPS.  The displayed
  479.   frame-relay statistics represent the WAN Access for 802.5 Driver instance
  480.   which has the same adapter number displayed on the notebook tab.  The
  481.   corresponding physical port is then determined by viewing the WAC Device
  482.   Driver MAC parameters of the WAC driver instance which is bound to this WAN
  483.   Access for 802.5 Protocol Driver.  Please see "Chapter 7. Configuring Frame
  484.   Relay" for more information on understanding LAPs, frame-relay, and the IBM
  485.   Wide Area Connector Adapter.
  486.  
  487.   For the most part, FRNOTEBK is a "passive" status tool.  As of this release,
  488.   FRNOTEBK cannot be used to set parameters or change configuration.  But,
  489.   there are a few settings which can be customized for your particular
  490.   configuration.  These settings can be saved by selecting the "Save Settings"
  491.   menu item under the "Main" menu.  You'll hear a soft 'beep' after the
  492.   settings are successfully saved.
  493.  
  494.   Line Speed should be configured to match the speed of the DSU/CSU that is
  495.   attached to the RouteXpander/2.  The Line Speed setting is used to calculate
  496.   the line utilization.  FRNOTEBK assumes that the line is full-duplex.  That
  497.   is, if the line speed is 64kpbs, RouteXpander/2 can send 64 kbps and receive
  498.   64kbps simultaneously across the WAN.  Utilization over 400% will display as
  499.   "Err".
  500.  
  501.   The line utilization and frame and byte count statistics can be configured
  502.   to refresh automatically or manually.  To set, select either "Auto Refresh
  503.   On" or "Auto Refresh Off" under the "Refresh" menu.  If "Auto Refresh On" is
  504.   selected, you can also select the auto refresh interval in seconds by
  505.   selecting either 5, 10, 15, 30, or 60 from the cascaded menu "Refresh
  506.   Interval ->".
  507.  
  508.   For an explanation of the WAN LMI Type and WAN LMI Parameters, see "Chapter
  509.   20.  Frame Relay Concepts" in the RouteXpander/2 User's Guide.  The Maximum
  510.   VCs represents the maximum number of DLCIs supported or if the WAN Access
  511.   for 802.5 is bound to the X.25 MAC Driver represents the maximum number of
  512.   virtual circuits supported.  This value can be changed via LAPs up to a
  513.   maximum of 200.
  514.  
  515.   An icon is provided with FRNOTEBK but is not installed in the RouteXpander/2
  516.   folder.  To create the FRNOTEBK icon, drag the "Program" icon out of the
  517.   "Templates" folder (usually installed on the OS/2 desktop) into the
  518.   RouteXpander/2 Folder.  A generic settings notebook will become viewable.
  519.   On the "Program" page in the "Path and File name:"  entry field, type
  520.   'C:\GSD\TOOLS\FRNOTEBK.EXE' (use the drive letter that RouteXpander/2 was
  521.   installed).  Next, on the "General" page in the "Title:"  entry field, type
  522.   "Frame Relay Notebook".  Now close the settings window by double clicking on
  523.   the window's system icon or by selecting the window's system icon and then
  524.   selecting "Close" from the system menu.  If you want FRNOTEBK to
  525.   automatically start at system initialization, drag the Frame Relay Notebook
  526.   icon into the "Startup" folder located in the "OS/2 System" folder.
  527.  
  528.   Bridge Counter Display (BDMPCNT.EXE)
  529.   ────────────────────────────────────
  530.   Bridge counters can be displayed using BDMPCNT.EXE.  Bdmpcnt has one
  531.   parameter which specifies the number of bridge ports for which counter data
  532.   is to be displayed.  These counters basically provide the same information
  533.   that can be found on the port performance console screen.  This application
  534.   becomes more useful if you want to gather bridge counter information
  535.   remotely by telneting to the RouteXpander/2 PC.
  536.  
  537.   IPX Router Status Display (NETSTATX.EXE)
  538.   ─────────────────────────────────────────
  539.   IPX Router status can be displayed using NETSTATX.  NETSTATX is a character
  540.   based application which displays to the screen various IPX Router MIB
  541.   variables.
  542.  
  543. ───────────────────────────Sample NETSTATX output──────────────────────────────
  544.   @ Copyright IBM 1994, All rights reserved.
  545.   Networking Systems, Research Triangle Park, NC
  546.  
  547.   IPX System Statistics
  548.   =====================
  549.   Interface Name = IBM RouteXpander/2 IPX Router
  550.   Maximum Hops = 16
  551.   Packets Received = 14502
  552.   Receive Packets Filtered = 0
  553.   Receive Packet Errors = 0
  554.   Receive Processing Errors = 3
  555.   Packets Forwarded = 639
  556.   Packets Transmitted = 639
  557.   Transmit Packet Requests = 27152
  558.   Transmit Packets Filtered = 0
  559.   Transmit Packet Processing Errors = 0
  560.   Hops Exceeded = 0
  561.   No Destination Socket = 0
  562.   No Out Routes = 0
  563.   Resource Failures = 0
  564.   Known Circuits = 2
  565.   Known Destinations = 13
  566.   Known Services = 14
  567.  
  568.   Circuit Name   E O LA Net Num  MT Type       Size  Delay Changes Througput
  569.   ============   = = == ======== == ========== ===== ===== ======= =========
  570.   Adapter 0      Y Y 00 00000170 TR  Broadcast 16384 00000 0000000  16000000
  571.   Adapter 1      Y Y 01 0000ABCD TR  Broadcast 04516 00000 0000000  00009600
  572.  
  573.   Net Num   Next Net  NIC Address   Protocol  Type        Cost  HC  NI
  574.   ========  ========  ============  ========  =========== ====  ==  ==
  575.   0000000A  00000170  10005AACB908       RIP      Network   02  01  00
  576.   00000170  00000170  08005A480197     Local      Network   01  00  00
  577.   00001170  00000170  10005AACB908       RIP      Network   02  01  00
  578.   0000ABCD  0000ABCD  4000638402E0     Local      Network   01  00  01
  579.   95859585  0000ABCD  08005A22EC1E       RIP      Network   03  02  01
  580.  
  581.   Service Name                    Type Net Num  Node         Socket Protocol
  582.   ==============================  ==== ======== ============ ====== ========
  583.   8224-2-10005A79008B             0000 094323B4 000000000001   5050      SAP
  584.   IBM8235_428500                  056A 000000FF 0001CB428500   4003      SAP
  585.   LTLWCOM                         056B 0000ABCD 08005A1A026A   0452      SAP
  586.   SERVERA                         0024 0000000A 000000000001   0451      SAP
  587.   SVT-TREE______________________> 0004 2C03B845 000000000001   0040      SAP
  588.   SVT-TREE______________________> 026B 2C03B845 000000000001   4005      SAP
  589.  
  590.   LA  RS RIP in Pkts  RIP out Pkts Size  SS SAP in Pkts  SAP out Pkts Size
  591.   ==  == ============ ============ ====  == ============ ============ ====
  592.   00   Y 000000003874 000000004026 0432   Y 000000004275 000000004112 0480
  593.   01   Y 000000002396 000000002720 0432   Y 000000003318 000000002718 0480
  594.  
  595. ─────────────────────────End sample NETSTATX output────────────────────────────
  596.  
  597.   Token Ring Network Connectivity Test (OS2PING.EXE)
  598.   ──────────────────────────────────────────────────
  599.   OS2PING can be used to test connectivity of a bridged token-ring network.
  600.   OS2PING works by sending a TEST frame to the NULL SAP of one or more
  601.   token-ring attached devices.  Most, but not all token-ring attached
  602.   devices will respond to this test frame.  The following command will send
  603.   an all routes explorer test frame from LAN adapter 0 of an OS/2 work
  604.   station to the token-ring global address and record the routes to all the
  605.   stations that respond.
  606.  
  607.   OS2PING /a=C000FFFFFFFF /r /l=0
  608.  
  609.   You can examine the output of OS2PING to determine what bridges and LAN
  610.   segments can be reached from your work station.  Of course, if you have
  611.   installed bridge filters on your bridges, some devices may be
  612.   unreachable.
  613.  
  614.   OS2PING uses the IEEE802.2 software that is shipped with NTS/2.  You must
  615.   install NTS/2 and bind the 808.2 protocol layer to your Token Ring
  616.   Network Adapter or WAN Access for 802.5 Network Adapter prior to using
  617.   OS2PING.  In installations where 802.2 resources are already being used
  618.   (by CM/2 for example) you may need to increase the number of SAPs or
  619.   STATIONS supported by 802.2.
  620.  
  621.   Type OS2PING with no parameters to get more help for this tool.
  622.  
  623.   Tracing for Troubleshooting and Filter Development (GSDTRACE.EXE)
  624.   ─────────────────────────────────────────────────────────────────
  625.   RouteXpander/2 tracing can be used to troubleshoot RouteXpander/2 or
  626.   network-based problems and to help design bridge filters.  Below it is
  627.   described how to activate RouteXpander/2 tracing and then how to
  628.   interpret the trace information.
  629.  
  630.   A. Enabling RouteXpander/2 Tracing
  631.   ──────────────────────────────────
  632.   To enable RouteXpander/2 tracing, do the following:
  633.  
  634.     1. First make sure that you have the following OS/2 programs in the
  635.        \OS2 directory of your boot drive:
  636.  
  637.             TRACE.EXE    in \OS2
  638.             TRACEFMT.EXE in \OS2
  639.             TRACEFMT.DLL in \OS2\DLL
  640.             TRACEFMT.HLP in \OS2\HELP
  641.  
  642.        If you do not find these programs, then you will need to install them.
  643.        To do so, do the following:
  644.  
  645.             a. At an OS/2 prompt, type:  INSTALL
  646.             b. At the first panel ("System Configuration"), click on the "OK"
  647.                button.
  648.             c. On the next panel ("OS/2 Setup and Installation"), click on the
  649.                box, "Serviceability and Diagnostics Aids".  Then click on the
  650.                "Install" button to proceed with the installation.  (Note:
  651.                you may be asked to insert different OS/2 installation
  652.                diskettes into a diskette drive.)
  653.  
  654.        (These instructions are based on OS/2 V2.11's installation.  Other
  655.        versions of OS/2 may have a slightly different installation process.)
  656.  
  657.     2. Edit \CONFIG.SYS to include the following statements (anywhere):
  658.  
  659.             TRACEBUF=63
  660.             TRACE=ON 164
  661.  
  662.        For more information on these statements, you can use the OS/2 HELP
  663.        facility (for instance, type at an OS/2 prompt:  "HELP TRACEBUF" and
  664.        "HELP TRACE").
  665.  
  666.     3. If all you desire is frame tracing by the RouteXpander/2 IPX Router,
  667.        then you can skip to step (4) below.  For tracing by the RouteXpander/2
  668.        frame-relay component, continue with the next paragraph.
  669.  
  670.        Run LAPS and Edit (e.g., double-click on) an "RXR/2 WAN Access for
  671.        802.5 Protocol" entry in your Current Configuration window.  At the
  672.        very bottom of the list of parameters you will see:  "Allow tracing
  673.        for this port?"  This parameter defaults to "NO".  Change this
  674.        parameter's value to "YES" for each port (that is, in each "RXR/2 WAN
  675.        Access for 802.5 Protocol" entry) on which you desire tracing.  After
  676.        updating this parameter, exit LAPS.
  677.  
  678.     4. Reboot your RouteXpander/2 machine.  If you configured tracing for
  679.        the RouteXpander/2 frame-relay component (as in step (3) above), then
  680.        on your bootup display (and in \IBMCOM\LANTRAN.LOG), you may note the
  681.        following message:
  682.  
  683.             "FRP0097:  OS/2 Tracing is allowed for Network Adapter #"
  684.  
  685.        This message is to alert you that frame-relay tracing is active for
  686.        the configured port.  If at an OS/2 prompt you type "HELP FRP0097",
  687.        the help text will remind you that tracing is useful for debugging
  688.        but may impact performance and could present a security risk.
  689.  
  690.        You will now be tracing every frame sent through the frame-relay
  691.        device driver.  To turn tracing off at any time, use the following
  692.        OS/2 command:
  693.  
  694.             TRACE OFF
  695.  
  696.        To turn tracing (back) on, type:
  697.  
  698.             TRACE ON 164
  699.  
  700.        (The parameter "164" specifies that tracing should be turned on for
  701.        certain data communications device drivers, including RouteXpander/2's
  702.        frame-relay driver and RouteXpander/2's IPX router.)
  703.  
  704.        For more information on OS/2 Trace commands, type "HELP TRACE" at any
  705.        OS/2 prompt.
  706.  
  707.     5. When you want to gather and store trace data (for instance, after a
  708.        failure occurs that you want traced), type the following command at an
  709.        OS/2 prompt:
  710.  
  711.             TRACEFMT
  712.  
  713.        This will bring up a PM session filled with a variety of data.  An
  714.        example of the data you might see could be:
  715.  
  716. ─────────────────────────────Sample TRACEFMT Display───────────────────────────
  717.  
  718. OS/2 Version 2.0 System Trace Formatter Output
  719. Formatted Events
  720.  
  721. Buffer size = 63 K Bytes
  722.  
  723.  
  724. EVENT# [0001]  PID [000D]  MAJOR [A4]  MINOR [004B]  LENGTH [0020]  TIME:
  725. 08 00 12 56 0D 00 32 00 00 00 00 00 BA A6 01 00 08 09 0A 0B 0C 0D 0E 0F 10 11
  726. 12 13 14 15 16 17
  727.  
  728. EVENT# [0002]  PID [000D]  MAJOR [A4]  MINOR [004A]  LENGTH [0001]  TIME:
  729. CC
  730.  
  731. EVENT# [0003]  PID [000D]  MAJOR [A4]  MINOR [004A]  LENGTH [0003]  TIME:
  732. 08 01 03
  733. ───────────────────────────────────────────────────────────────────────────────
  734.  
  735.        You need to store this data for subsequent processing.  To store the
  736.        data, click on the "File" pulldown menu item (or type ALT-F), then
  737.        click on the "Save as ..." menu item (or type "S"), then click on
  738.        the submenu item "Save formatted trace data" (or type "F").  This will
  739.        present a popup menu which will allow you to specify a trace-file name.
  740.        Choose any name you want (e.g., RXR1.TRC) and "Save" this file.  When
  741.        the trace-file save has been completed (indicated by another popup),
  742.        exit the OS/2 TRACEFMT program.
  743.  
  744.     6. You now have two options.  You can try to analyze the trace data
  745.        yourself, or you contact IBM support to assist you in analyzing your
  746.        trace, or both.  If you choose to contact IBM support, send them the
  747.        formatted trace data you have just saved, as well as the following
  748.        files:
  749.  
  750.           \CONFIG.SYS
  751.           \IBMCOM\PROTOCOL.INI
  752.           \IBMCOM\LANTRAN.LOG
  753.           \GSD\GSDMSG.LOG
  754.           \GSD\GSDARCH.LOG
  755.  
  756.        If you choose to analyze the formatted trace data yourself, then copy
  757.        (or move) the formatted trace files to the \GSD\TOOLS directory (where
  758.        the RouteXpander/2 GSDTRACE.EXE program is) and issue one of the
  759.        following commands:
  760.  
  761.           GSDTRACE <filename>       - for a simplified ladder diagram
  762.               or
  763.           GSDTRACE <filename> /c    - for a more detailed ladder diagram
  764.  
  765.        where <filename> is the name of the file you created with the OS/2
  766.        TRACEFMT program in step (5).  (For instance, you can issue the
  767.        command "GSDTRACE RXR1.TRC /C".)
  768.  
  769.   B. Interpreting RouteXpander/2 Trace Output
  770.   ───────────────────────────────────────────
  771.   GSDTRACE will generate several output files.  The output files all use
  772.   the same base filename as the input filename, but have different filename
  773.   extensions.  The output files and their extensions are as follows:
  774.  
  775.     (1) The .ANA file protocol-ANALYZES each PDU.
  776.     (2) The .LDR file LADDER-diagrams each PDU.
  777.     (3) The .MAP file MAPS bridged routes with PDU statistics.
  778.  
  779.   The GSDTRACE output file that is most likely to be of use for
  780.   troubleshooting ends with the suffix .LDR.  The output file that might be
  781.   of most use in selecting Bridge Filters ends with the suffix .MAP.  In
  782.   addition, the .LDR file can be used in tandem with the .ANA file, since
  783.   the .LDR provides a high-level ladder diagram of network traffic whereas
  784.   the .ANA file provides a more low-level data analysis.  The .LDR frames
  785.   can be correlated to the appropriate .ANA frame by referencing their
  786.   common "PDU #".
  787.  
  788.   Below are sample snippets from .LDR (ladder diagram), .ANA (protocol
  789.   analysis), and .MAP (bridge mapping) files.
  790.  
  791. ────────────────────────────────Sample .LDR output─────────────────────────────
  792. RXR2IPX0.LDR
  793. Rudimentary Ladder Diagram based on RXR2IPX0.TRC 
  794.  
  795.          Remote Node                                  Local Node            PDU#
  796.         -------------                                -------------          ----
  797.                     │                                │
  798.                     │Spanning Tree BPDU              │                      0040
  799.         08005A48018E├------------------------------->│C00000000100
  800.                     │                                │
  801.    FF.FF.FF.FF.FF.FF│  IPX "RIP Response" [Broadcast]│40.00.63.84.01.20     0041
  802.         FFFFFFFFFFFF│<───────────────────────────────┤400063840120
  803.                     │                                │
  804.    FF.FF.FF.FF.FF.FF│  IPX "RIP Response" [Broadcast]│40.00.63.84.01.20     0042
  805.                     │<-------------------------------┤
  806.                     │                                │
  807.                     │  LMI(0) Status-Enq: Full-Status│                      0043
  808.                     │<-------------------------------┤
  809.                     │                                │
  810.                     │LMI(0) Status: 32              │                      0044
  811.                     ├------------------------------->│
  812. ───────────────────────────────────────────────────────────────────────────────
  813.  
  814.   Note in the above trace that those frames whose reception or transmission
  815.   are denoted by a dashed line (e.g., ---->) represent frames traced by the
  816.   RouteXpander/2 frame-relay component, whereas those denoted by a solid
  817.   line (e.g., ─────>) represent frames traced by the RouteXpander/2 IPX
  818.   Router.
  819.  
  820.   (The above trace was generated by GSDTRACE without using GSDTRACE's "/C"
  821.   option.  If the "/C" option had also been used, then control information
  822.   related to OS/2 NDIS** interfaces would be displayed.  This type of control
  823.   information is particularly useful if your trace indicates that you are
  824.   only transmitting frames but are not receiving any frames or if you
  825.   believe that there may be a problem between RouteXpander/2's frame-relay
  826.   component and the IBMWAC or RICDD device-drivers to which it is bound.)
  827.  
  828. ────────────────────────────────Sample .ANA output─────────────────────────────
  829. RXR2IPX0.ANA
  830. Frame-by-Frame Protocol-Specific Byte Counts based on RXR2IPX0.TRC
  831.  
  832.                                *** PDU #0042 ***
  833. ------------------------------Original Trace Data-------------------------------
  834.     08010380 00000081 37FFFF00 58000100 000931FF FFFFFFFF FF045300 00093140
  835.     00638401 20045300 02000001 70000100 02000000 0A000200 03000011 70000200
  836.     03000E11 70000200 03000E21 70000200 03000E31 70000200 03000E41 70000200
  837.     03
  838. ----------------------------------PDU Summary-----------------------------------
  839. 200.21  PDU #0042. IPX "RIP Response" [Broadcast] <==
  840.              Total bytes = 97
  841.              Analysis of protocol-specific overhead in bytes:
  842.                 Frame Relay    = 2   (DLCI = 32) [FCS bytes not included]
  843.                 RFC-1490       = 7   (RFC-1490 "Novell IPX")
  844.                 IPX            = 30  (Packet Length       = 0058 [hex])
  845.                                      (Transport Control   = 00)
  846.                                      (Packet Type         = 01)
  847.                                      (Destination Network = 0000 0931)
  848.                                      (Destination Node    = FFFF FFFF FFFF)
  849.                                      (Destination Socket  = 0453)
  850.                                      (Source Network      = 0000 0940)
  851.                                      (Source Node         = 4000 6384 0120)
  852.                                      (Source Socket       = 0453)
  853.                 Novell RIP     = 58  (Operation = 0002)
  854.                                      (Number of Entries = 4)
  855.                                      (Entry   Network   Hops  Ticks)
  856.                                      ( 001    00000170  0001  0002 )
  857.                                      ( 002    0000000A  0002  0003 )
  858.                                      ( 003    00001170  0002  0003 )
  859.                                      ( 004    000E1170  0002  0003 )
  860. ───────────────────────────────────────────────────────────────────────────────
  861.  
  862.   The above example gives some detailed protocol information about PDU
  863.   number 42 from the preceding .LDR ladder diagram.  (While all the frames
  864.   in the .LDR file are also in the .ANA file, this one PDU was excerpted
  865.   for illustration purposes.)
  866.  
  867. ────────────────────────────────Sample .MAP output─────────────────────────────
  868. RXR2IPX0.MAP
  869. Ring-Bridge mappings between nodes, based on RXR2IPX0.TRC 
  870.  
  871. Total  +-----Node1-----+ +-----Node2-----+
  872. Frames |MAC Address SAP| |MAC Address SAP|   Route Designators (Ring-Bridge)
  873. ------ ------------ ---- ------------ ---- ------------------------------------
  874.     99 4000FFFF0032  AA  400063840120  AA  011-3 018-0
  875. ------ ------------ ---- ------------ ---- ------------------------------------
  876.           Lower-Layer Protocols:
  877.              802.X bytes     =  1683 (23%)
  878.              SNAP bytes      =   495 ( 6%)
  879.           TCP/IP Protocols:
  880.              IP bytes        =    40 ( 0%)
  881.              UDP/IP bytes    =    16 ( 0%)
  882.              RIP/IP bytes    =    88 ( 1%)
  883.           Novell Protocols:
  884.              IPX bytes       =  2910 (41%)
  885.              RIP bytes       =    10 ( 0%)
  886.              NCP bytes       =  1832 (25%)
  887.           Total Bytes        =  7074
  888. ------ ------------ ---- ------------ ---- ------------------------------------
  889.     96 08005A48018E  E0  10005AACB908  E0  011-3 012-1 070-2 075-0
  890. ------ ------------ ---- ------------ ---- ------------------------------------
  891.           Lower-Layer Protocols:
  892.              802.X bytes     =  1632 (25%)
  893.           Novell Protocols:
  894.              IPX bytes       =  2880 (45%)
  895.              NCP bytes       =  1832 (28%)
  896.           Total Bytes        =  6344
  897. ------ ------------ ---- ------------ ---- ------------------------------------
  898.     26 4000FFFF0032  42  C00000000100  42
  899. ------ ------------ ---- ------------ ---- ------------------------------------
  900.           Lower-Layer Protocols:
  901.              802.X bytes     =   442 (32%)
  902.           Bridge-Related Protocols:
  903.              BPDU bytes      =   910 (67%)
  904.           Total Bytes        =  1352
  905. ───────────────────────────────────────────────────────────────────────────────
  906.  
  907.   The .MAP file provides information on:
  908.  
  909.       - which machines are sending bridged traffic to which machines
  910.       - how much traffic is being transferred between these machines
  911.       - the routes (ring-bridge pairs) this traffic is taking
  912.       - the type of protocols being used between these machines
  913.  
  914.   This information can help you determine what kind of bridge filters you
  915.   may need (if any).  For instance, looking at the above .MAP file, you may
  916.   decide that you need to filter out IPX traffic and all data from MAC
  917.   addresses 08005A48018E and 10005AACB908.  You may decide to put a "3-hop"
  918.   limit on your bridge or increase timers associated with your IPX RIP
  919.   broadcasts.  Careful analysis can lead to significant improvements in
  920.   your WAN utilization.  Sometimes users are even surprised to learn the
  921.   type of traffic their nodes are actually transferring.
  922.  
  923.   For related information on the output created by GSDTRACE, simply type at
  924.   an OS/2 command prompt:
  925.  
  926.       GSDTRACE
  927.  
  928.   in the directory in which GSDTRACE.EXE is stored.  (Note that
  929.   GSDTRACE.EXE's help message is formatted for a FULL-SCREEN OS/2 Session;
  930.   if GSDTRACE is invoked from an OS/2 Window, its screen output may be
  931.   displayed too quickly for user viewing.)
  932.  
  933. ************************************************************************
  934.   CHAPTER 5.  NOTES ON RELATED PRODUCTS
  935.  
  936.   PS/ValuePoint Flash PROM Levels
  937.   ───────────────────────────────
  938.   When RouteXpander/2 is installed on a PS/ValuePoint, you must make sure
  939.   that the PS/ValuePoint's Flash PROM's level is at L6ET58AUS or higher.
  940.   With backlevel PROMs, intermittent errors may be observed.
  941.  
  942.   To check the Flash PROM level of you PS/ValuePoint, when your machine
  943.   is powered on and is doing a memory check (indicated by the rapidly
  944.   incrementing numbers on the monitor's upper left corner), press F1.
  945.   This will display a configuration screen showing your current Flash
  946.   PROM level.
  947.  
  948.   IBM Token Ring 16/4 Shared RAM Adapter:  Use Size of 64K or 32K
  949.   ───────────────────────────────────────────────────────────────
  950.   It is strongly recommended that you set your Token Ring Shared RAM
  951.   adapter's RAM window size to 64K bytes, for maximum performance.  If
  952.   this is not possible due to configuration restraints of your system
  953.   setup, then a 32K byte window size is recommended.  Anything less that
  954.   32K bytes can lead to problems described in the following paragraphs.
  955.  
  956.   With a Shared RAM window size of 16K or fewer bytes, the Token Ring
  957.   Shared RAM adapter's device driver must "page" the Shared RAM window
  958.   in order to access all of the data and control buffers.  The mechanism
  959.   for paging has proven to be error-prone in certain systems, thus
  960.   leading to erroneous control and data processing.  Such behavior can
  961.   significantly impact the performance and reliability of your
  962.   RouteXpander/2.
  963.  
  964.   Only if you cannot set the shared RAM size to either 64K or 32K bytes,
  965.   then the following considerations must be kept in mind:  In order to
  966.   receive frames greater than 2K bytes in size, the minimum configured
  967.   Shared RAM size for the IBM Token Ring 16/4 Adapters must be at least
  968.   16K bytes;  that is, if 8K bytes of shared RAM are configured, the
  969.   adapter automatically sets the maximum received frame size to 2K bytes.
  970.  
  971.   IBM 16/4 ISA Token Ring Adapter Switch Settings
  972.   ───────────────────────────────────────────────
  973.   The switch settings for the 16/4 ISA-16 Adapter (short 16-bit ISA-bus
  974.   adapter with 1 2-bit switch block and 1 12-bit switch block) are the same as
  975.   those for the short 8-bit ISA-bus adapters.  The settings for the 2-bit
  976.   switch block are as follows:
  977.  
  978.   * S1  - Cable Type
  979.     ───
  980.     on  = Shielded Twisted Pair (STP; "IBM cabling")
  981.     off = Unshielded Twisted Pair (UTP; "telephone wire")
  982.  
  983.   * S2  - RPL (Remote Program Load)
  984.     ───
  985.     on  = Enabled
  986.     off = Disabled
  987.  
  988.   IBM 16/4 ISA Token Ring Network Adapter - Switch Settings
  989.   ─────────────────────────────────────────────────────────
  990.   The following switch settings are for the short Token-Ring Network PC
  991.   Adapter II and the Token-Ring Network 16/4 Adapter (the 8-bit ISA-bus
  992.   adapters with one 12-bit switch block).
  993.  
  994.   These are also the settings for the 12-bit switch block on 16/4 ISA-16
  995.   Adapter (16-bit ISA-bus).
  996.  
  997.   * S1  S2  S3  S4  S5  S6  - ROM Address
  998.     ─── ─── ─── ─── ─── ───
  999.     off on  on  off off on  = X'CC000' (typical for "Primary" adapter)
  1000.     off on  off off off on  = X'DC000' (typical for "Secondary" adapter)
  1001.  
  1002.   The settings above are typical; other ROM Address values may be set.
  1003.   The ROM address is defined as follows:
  1004.  
  1005.                           B'1xxx xxx0 0000 0000 0000'
  1006.                              │││ │││
  1007.          S1 ─────────────────┘││ │││  off=1, on=0
  1008.          S2 ──────────────────┘│ │││
  1009.          S3 ───────────────────┘ │││
  1010.          S4 ─────────────────────┘││
  1011.          S5 ──────────────────────┘│
  1012.          S6 ───────────────────────┘
  1013.  
  1014.   * S7  S8  - Interrupt Level
  1015.     ─── ───
  1016.     on  on  = 2 (first choice, conflicts with 3278/79 adapter)
  1017.     on  off = 3 (second choice, conflicts with COM2)
  1018.     off on  = 6 (do not use, conflicts with diskette adapter)
  1019.     off off = 7 (third choice, conflicts with some printer adapters)
  1020.  
  1021.   * S9  - I/O Address ("Primary/Secondary")
  1022.     ───
  1023.     off = X'0A20' ("Primary" adapter)
  1024.     on  = X'0A24' ("Secondary" adapter)
  1025.  
  1026.   * S10 S11 - RAM Size
  1027.     ─── ───
  1028.     on  on  =  8 KB
  1029.     off on  = 16 KB
  1030.     on  off = 32 KB (16/4 adapters only)
  1031.     off off = 64 KB (16/4 adapters only)
  1032.  
  1033.   * S12 - Ring Speed
  1034.     ───
  1035.     on  =  4 Mbps
  1036.     off = 16 Mbps (16/4 adapters only)
  1037.  
  1038.   IBM 16/4 ISA Token Ring Network Adapter - Example Configuration
  1039.   ───────────────────────────────────────────────────────────────
  1040.   The following configuration has been tested in a ValuePoint 466DX2/D:
  1041.  
  1042.   * S1  S2  S3  S4  S5  S6  - ROM Address
  1043.     ─── ─── ─── ─── ─── ───
  1044.     off on  on  off on  on  = X'C8000'
  1045.  
  1046.   * S7  S8  - Interrupt Level
  1047.     ─── ───
  1048.     off off = 7
  1049.  
  1050.   * S9  - I/O Address ("Primary/Secondary")
  1051.     ───
  1052.     off = X'0A20' ("Primary" adapter)
  1053.  
  1054.   * S10 S11 - RAM Size
  1055.     ─── ───
  1056.     on  off = 32 KB
  1057.  
  1058.   NTS/2 Adapter Device Driver Parameters - Example
  1059.  
  1060.     IBM Token Ring Adapter For Bridge (GSDTOK.OS2)
  1061.        Adapter Mode          PRIMARY
  1062.        Shared RAM Address    D800
  1063.  
  1064.   IBM Wide Area Connector for ISA Bus -  Switch Settings
  1065.   ──────────────────────────────────────────────────────
  1066.   The following switch settings are for the IBM Wide Area Connector Adapter
  1067.   for ISA Bus PCs.
  1068.  
  1069.   * S1  S2  S3   - IRQ used by the WAC Adapter
  1070.     ─── ─── ───
  1071.     on  on  on   = IRQ9
  1072.     off on  on   = IRQ5
  1073.     on  off on   = IRQ4
  1074.     off off on   = IRQ3
  1075.     on  on  off  = IRQ15
  1076.     off on  off  = IRQ14
  1077.     on  off off  = IRQ11
  1078.     off off off  = IRQ10
  1079.  
  1080.   * S4  S5  S6  S7   - I/O Address Range Used (in Hex)
  1081.     ─── ─── ─── ───
  1082.     on  on  on  on   = 0120h - 013Fh
  1083.     off on  on  on   = 0140h - 015Fh
  1084.     on  off on  on   = 0180h - 019Fh
  1085.     off off on  on   = 01A0h - 01BFh
  1086.     on  on  off on   = 0220h - 023Fh
  1087.     off on  off on   = 0240h - 025Fh
  1088.     X   off off on   = 0280h - 029Fh  ('X' = can be ON or OFF [don't care])
  1089.     on  on  on  off  = 0520h - 053Fh
  1090.     off on  on  off  = 0540h - 055Fh
  1091.     on  off on  off  = 0580h - 059Fh
  1092.     off off on  off  = 05A0h - 05BFh
  1093.     on  on  off off  = 0620h - 063Fh
  1094.     off on  off off  = 0640h - 065Fh
  1095.     X   off off off  = 0680h - 069Fh  ('X' = can be ON or OFF [don't care])
  1096.  
  1097.   See the discussion of ISA WAC example configuration for related information.
  1098.  
  1099.   IBM Wide Area Connector for ISA Bus -  Example Configuration
  1100.   ────────────────────────────────────────────────────────────
  1101.   The following configuration has been tested in a ValuePoint 466DX2/D.
  1102.   Below is a sample \IBMCOM\PROTOCOL.INI module configuration.  An example of
  1103.   WAC switch settings that can be associated with this PROTOCOL.INI listing
  1104.   are as follows:
  1105.  
  1106.                         IRQ11           I/O=0120-013fh
  1107.                     ┌─────┴─────┐     ┌───────┴────────┐
  1108.                      S1  S2  S3         S4  S5  S6  S7
  1109.                      on  off off        on  on  on  on
  1110.  
  1111.   Note in these switch settings that the I/O Address range is associated with
  1112.   four "on" bits, which can be represented as binary '1111'b or hexadecimal
  1113.   '0F'x or decimal 15.  For ISA WACs, these I/O Address bits are interpreted
  1114.   as a decimal value to be used in the PROTOCOL.INI "WACCARDNUM" value (see
  1115.   below).  The WACCARDNUM can be configured using LAPS when editing the "IBM
  1116.   Wide Area Connector" configuration's parameter:
  1117.  
  1118.             "Slot number (MC-A) [1..8] or Card Number (ISA) [0..15]"
  1119.  
  1120.   Also note that both the above set IRQ and I/O Address values cannot conflict
  1121.   with those used by any other PC equipment, including other WAN adapters, LAN
  1122.   adapters, serial ports or parallel ports.  For the values used by LAN
  1123.   adapters, see previous sections.  For values used by serial and parallel
  1124.   ports, depress the CTRL-ALT-INSERT keys when "cold-booting" your machine.
  1125.  
  1126. ────────────────────────────Sample ISA WAC PROTOCOL.INI──────────────────────
  1127. [IBMWAC_nif]
  1128.  
  1129.    DriverName = IBMWAC$
  1130.    WACCARDNUM = 15
  1131.    WACPORTNUM = 1
  1132.    RAMADDRESS = 0x0D0000
  1133.    RTS = 0
  1134.    NRZI = 0
  1135.    RS232MODE = 0
  1136.    X21MODE = 1
  1137.    LINESPEED = "1.5M"
  1138.    MAXDATA = 4486
  1139.    MACTYPE = "HDLC"
  1140.    MAXTRANSMITS = 8
  1141.    PCMSUPPORT = 0
  1142.    CONNTYPE = 0
  1143.    FLAGS = 1
  1144. ─────────────────────────────────────────────────────────────────────────────
  1145.  
  1146.   Note that the "RAMADDRESS" value (addressed by the LAPS parameter ""16KB
  1147.   Shared memory addr. [0C0000-FE0000]") must not conflict with the memory
  1148.   (RAM or ROM) addresses used by other PC devices, such as Token-Ring Network
  1149.   Adapters.
  1150.  
  1151.  
  1152. ************************************************************************
  1153.   CHAPTER 6.  RouteXpander/2 Known Problems
  1154.  
  1155.   This chapter contains information about known problems with either
  1156.   RouteXpander/2 or products associated with RouteXpander/2.  Over time, it
  1157.   is anticipated that many of these problems will be fixed with subsequent
  1158.   product releases or with Corrective Service Diskettes (CSDs).  (Some
  1159.   problems are expected to be fixed in early 1995.)  To obtain the latest
  1160.   information about product releases and CSDs, U.S.  customers should
  1161.   contact the "IBM Service Software Support Center" at 1-800-237-5511.
  1162.   When contacting the Support Center, your request will be expedited if you
  1163.   have the product number available for the product about which you are
  1164.   inquiring.
  1165.  
  1166.   OS/2 Warp
  1167.   ─────────
  1168.   At the time of this README.TXT's writing, OS/2 Warp has a certain problem
  1169.   with an application-level inter-process communication (IPC) device known
  1170.   as a "named pipe".  Some RouteXpander/2 applications use named pipes in a
  1171.   manner that subjects them to Warp's unexpected implementation.
  1172.  
  1173.   Because of this problem, RouteXpander/2's bridge support on OS/2 Warp
  1174.   cannot be started and managed from the Console.  Management (whether
  1175.   with a LAN Network Manager or with the RouteXpander/2 Console or with an
  1176.   SNMP based manager) does not work.  Bridging can be started
  1177.   independently of the console by issuing the following command in an OS/2
  1178.   Window:  "START C:\GSD\GSDBRMGR.EXE".  An OS/2 Warp problem (PMR) 3X339
  1179.   has been opened to track this incompatibility.  IPX routing works as
  1180.   documented.  X.25 support has not yet been tested.
  1181.  
  1182.   MPTS/2
  1183.   ──────
  1184.   IBM's latest release of LAPS has been integrated into its "Multi-Protocol
  1185.   Transport Services" (MPTS/2) program.  MPTS/2 is installed with IBM's LAN
  1186.   Server 4.0, LAN Distance, and AnyNet products.  The following problems
  1187.   should only arise if you load RouteXpander/2 on a machine that currently
  1188.   has MPTS/2 installed.
  1189.  
  1190.   LAPS is used by the aforementioned products and RouteXpander/2 to install
  1191.   OS/2 device drivers.  An integral part of the device-driver installation
  1192.   involves "Network Information Files," also known as NIF files.  At this
  1193.   time, the MPTS/2 version of LAPS has a limitation on the number of NIF
  1194.   files it can manipulate, and MPTS/2 fails to operate when this limit is
  1195.   reached.  Unfortunately, if you try to install RouteXpander/2 on a
  1196.   a machine that has MPTS installed, its NIF file limit is exceeded.
  1197.  
  1198.   To avoid this problem, prior to installing RouteXpander/2, examine the *.NIF
  1199.   files (either by checking the file names or by editing the files) in your
  1200.   \IBMCOM\MACS and \IBMCOM\PROTOCOLS directories.  Select the .NIF files for
  1201.   several (five or so) of the device drivers that you do NOT intend to use and
  1202.   rename these files with a file extension other than .NIF.  Then install
  1203.   RouteXpander/2 2.0.2.
  1204.  
  1205.   In addition, when RouteXpander/2 and MPTS/2 are loaded on the same machine
  1206.   you may see the following message appear one or more times on your boot-up
  1207.   screen:
  1208.  
  1209.        Cannot open LANMSG$$
  1210.  
  1211.   To avoid this message, edit your \CONFIG.SYS so that DEVICE statements for
  1212.   RouteXpander/2 device drivers (GSD*.200 and IBMWAC.OS2) precede the
  1213.   following MPTS/2 DEVICE statement:
  1214.  
  1215.       DEVICE=C:\MPTN\PROTOCOL\MPTN.SYS
  1216.  
  1217.   Similarly, for remote installations to work, your RouteXpander/2 remote
  1218.   service device drivers (SRVIFS.SYS and SRVIFSC.IFS) need to precede the
  1219.   MPTN.SYS DEVICE statement in \CONFIG.SYS.
  1220.  
  1221.   WAC
  1222.   ───
  1223.   Below is the latest Engineering Change (EC) information available on IBM
  1224.   Wide Area Connector (WAC) adapters:
  1225.  
  1226.   Failure symptoms:  Machine NMI or data corruption problems related to use
  1227.   with WAC adapters.
  1228.  
  1229.   The following Part Numbers (P/N) should have an EC level of C41821 or
  1230.   higher:
  1231.  
  1232.   33G8465, 33G8466, 33G8467, 33G8468, 33G8469, 33G8470, 33G8471, 33G8472
  1233.   33G9171, 33G9172, 33G9173, 33G9174, 33G9175, 33G9176, 33G9177 and 33G9178.
  1234.  
  1235.   The EC level should be on the P/N label on the back side of the base card.
  1236.  
  1237.   Fix:
  1238.  
  1239.   EC levels C41111 and C41618 should be replaced with Microchannel base cards
  1240.   for P/Ns 33G8465-33G8468 and 33G9171-33G9174 with FRU 33G8453.  ISA base
  1241.   cards for P/Ns 33G8469-33G8472 and 33G9175-33G9178 should be replaced with
  1242.   FRU 33G8454.  Daughter cards (EIBs) at the above EC levels do NOT need
  1243.   to be replaced.
  1244.  
  1245.   RouteXpander/2 Nodes with IPX Lockup using Novell Server 3.12
  1246.   ─────────────────────────────────────────────────────────────
  1247.   If your RouteXpander/2 node keyboard and mouse "lock up" (are unable to
  1248.   work) and your network contains a Novell 3.12 File Server, make sure all IPX
  1249.   Requesters have the Large Internet Packets (LIP) parameter turned off.
  1250.  
  1251.   RouteXpander/2 Remote Installs: SRVIFS Must Be LAST in CONFIG.SYS
  1252.   ─────────────────────────────────────────────────────────────────
  1253.   When you set up your RouteXpander/2 for remote installation the following
  1254.   statements are placed LAST in the \CONFIG.SYS file.
  1255.  
  1256.     DEVICE=C:\GSD\REMOTE\SRVIFS.SYS
  1257.     IFS=C:\GSD\REMOTE\SRVIFSC.IFS *
  1258.  
  1259.   With the exception of MPTS/2's MPTN.SYS driver (see "MPTS/2" above), these
  1260.   two statements must remain LAST for the system to work correctly.  If they
  1261.   are not last the system may hang during startup.  Unfortunately, when you
  1262.   modify your configuration using NTS/2 CSD WR07045 and earlier, other
  1263.   protocols or adapter device drivers may be added to CONFIG.SYS AFTER the
  1264.   SRVIFS statements.  Check your CONFIG.SYS each time after you modify your
  1265.   configuration using NTS/2.  NTS/2 CSD WR07060 will be available soon which
  1266.   should fix this problem.
  1267.  
  1268.   RouteXpander/2 Console's "Keys Help" Not Available
  1269.   ──────────────────────────────────────────────────
  1270.   When you click on the "Help" button on any RouteXpander/2 Console window,
  1271.   the "RouteXpander/2 Console Help" window will appear.  This latter window
  1272.   will have a "Help" pulldown menu.  This Help pulldown menu's "Keys Help"
  1273.   selection is unavailable at this time.
  1274.  
  1275.   RouteXpander/2 Console's Message Log's "Save as..." Unreliable
  1276.   ──────────────────────────────────────────────────────────────
  1277.   If you desire to save (backup) your RouteXpander/2 Message Log files
  1278.   (GSDMSG.LOG and GSDARCH.LOG), it is recommended that you do not use the
  1279.   "Save as..."  button available on the RouteXpander/2's Bridge Message Log
  1280.   window.  Instead, close the Console (ALT+F4) and then go into an OS/2 window
  1281.   and type the following command:
  1282.  
  1283.        COPY \GSD\GSDARCH.LOG /B + \GSD\GSDMSG.LOG BACKUP.LOG
  1284.  
  1285.   where the filename "BACKUP.LOG" can be any filename you desire.
  1286.  
  1287.   RouteXpander LNM Support/2 Extraneous Alert
  1288.   ───────────────────────────────────────────
  1289.   Under certain conditions, when a wire fault occurs, the RouteXpander
  1290.   LNM Support/2 program may send a NAUN Change alert, in addition to
  1291.   an alert indicating that frame forwarding has stopped.  This
  1292.   extraneous NAUN Change (which indicates that the affected node's
  1293.   NAUN is itself) should be ignored.
  1294.