Avaya Using Technician Interface Scripts Users Manual

2015-06-01

: Avaya Avaya-Using-Technician-Interface-Scripts-Users-Manual-734540 avaya-using-technician-interface-scripts-users-manual-734540 avaya pdf

Open the PDF directly: View PDF PDF.
Page Count: 805

DownloadAvaya Avaya-Using-Technician-Interface-Scripts-Users-Manual- Using Technician Interface Scripts  Avaya-using-technician-interface-scripts-users-manual
Open PDF In BrowserView PDF
Using Technician
Interface Scripts

Router Software Version 11.0
Site Manager Software Version 5.0

Part No. 114087 Rev. A
August 1996

4401 Great America Parkway
Santa Clara, CA 95054

8 Federal Street
Billerica, MA 01821

Copyright © 1988–1996 Bay Networks, Inc.
All rights reserved. Printed in the USA. August 1996.
The information in this document is subject to change without notice. The statements, configurations, technical data,
and recommendations in this document are believed to be accurate and reliable, but are presented without express or
implied warranty. Users must take full responsibility for their applications of any products specified in this document.
The information in this document is proprietary to Bay Networks, Inc.
The software described in this document is furnished under a license agreement and may only be used in accordance
with the terms of that license. A summary of the Software License is included in this document.

Restricted Rights Legend
Use, duplication, or disclosure by the United States Government is subject to restrictions as set forth in subparagraph
(c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013.

Notice for All Other Executive Agencies
Notwithstanding any other license agreement that may pertain to, or accompany the delivery of, this computer
software, the rights of the United States Government regarding its use, reproduction, and disclosure are as set forth in
the Commercial Computer Software-Restricted Rights clause at FAR 52.227-19.

Trademarks of Bay Networks, Inc.
ACE, AFN, AN, BCN, BLN, BN, BNX, CN, FN, FRE, GAME, LN, Optivity, PPX, SynOptics, SynOptics
Communications, Wellfleet and the Wellfleet logo are registered trademarks and ANH, ASN, Bay•SIS, BCNX,
BLNX, EZ Install, EZ Internetwork, EZ LAN, PathMan, PhonePlus, Quick2Config, RouterMan, SPEX,
Bay Networks, Bay Networks Press, the Bay Networks logo and the SynOptics logo are trademarks of
Bay Networks, Inc.

Third-Party Trademarks
All other trademarks and registered trademarks are the property of their respective owners.

Statement of Conditions
In the interest of improving internal design, operational function, and/or reliability, Bay Networks, Inc. reserves the
right to make changes to the products described in this document without notice.
Bay Networks, Inc. does not assume any liability that may occur due to the use or application of the product(s) or
circuit layout(s) described herein.
Portions of the code in this software product are Copyright © 1988, Regents of the University of California. All rights
reserved. Redistribution and use in source and binary forms of such portions are permitted, provided that the above
copyright notice and this paragraph are duplicated in all such forms and that any documentation, advertising materials,
and other materials related to such distribution and use acknowledge that such portions of the software were
developed by the University of California, Berkeley. The name of the University may not be used to endorse or
promote products derived from such portions of the software without specific prior written permission.
SUCH PORTIONS OF THE SOFTWARE ARE PROVIDED “AS IS” AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
In addition, the program and information contained herein are licensed only pursuant to a license agreement that
contains restrictions on use and disclosure (that may incorporate by reference certain limitations and notices imposed
by third parties).

ii

114087 Rev. A

Bay Networks Software License
Note: This is Bay Networks basic license document. In the absence of a
software license agreement specifying varying terms, this license -- or the
license included with the particular product -- shall govern licensee’s use of
Bay Networks software.
This Software License shall govern the licensing of all software provided to licensee by Bay Networks (“Software”).
Bay Networks will provide licensee with Software in machine-readable form and related documentation
(“Documentation”). The Software provided under this license is proprietary to Bay Networks and to third parties from
whom Bay Networks has acquired license rights. Bay Networks will not grant any Software license whatsoever, either
explicitly or implicitly, except by acceptance of an order for either Software or for a Bay Networks product
(“Equipment”) that is packaged with Software. Each such license is subject to the following restrictions:
1.

Upon delivery of the Software, Bay Networks grants to licensee a personal, nontransferable, nonexclusive license
to use the Software with the Equipment with which or for which it was originally acquired, including use at any
of licensee’s facilities to which the Equipment may be transferred, for the useful life of the Equipment unless
earlier terminated by default or cancellation. Use of the Software shall be limited to such Equipment and to such
facility. Software which is licensed for use on hardware not offered by Bay Networks is not subject to restricted
use on any Equipment, however, unless otherwise specified on the Documentation, each licensed copy of such
Software may only be installed on one hardware item at any time.

2.

Licensee may use the Software with backup Equipment only if the Equipment with which or for which it was
acquired is inoperative.

3.

Licensee may make a single copy of the Software (but not firmware) for safekeeping (archives) or backup
purposes.

4.

Licensee may modify Software (but not firmware), or combine it with other software, subject to the provision
that those portions of the resulting software which incorporate Software are subject to the restrictions of this
license. Licensee shall not make the resulting software available for use by any third party.

5.

Neither title nor ownership to Software passes to licensee.

6.

Licensee shall not provide, or otherwise make available, any Software, in whole or in part, in any form, to any
third party. Third parties do not include consultants, subcontractors, or agents of licensee who have licensee’s
permission to use the Software at licensee’s facility, and who have agreed in writing to use the Software only in
accordance with the restrictions of this license.

7.

Third-party owners from whom Bay Networks has acquired license rights to software that is incorporated into
Bay Networks products shall have the right to enforce the provisions of this license against licensee.

8.

Licensee shall not remove or obscure any copyright, patent, trademark, trade secret, or similar intellectual
property or restricted rights notice within or affixed to any Software and shall reproduce and affix such notice on
any backup copy of Software or copies of software resulting from modification or combination performed by
licensee as permitted by this license.

114087 Rev. A

iii

Bay Networks Software License (continued)
9.

Licensee shall not reverse assemble, reverse compile, or in any way reverse engineer the Software. [Note: For
licensees in the European Community, the Software Directive dated 14 May 1991 (as may be amended from time
to time) shall apply for interoperability purposes. Licensee must notify Bay Networks in writing of any such
intended examination of the Software and Bay Networks may provide review and assistance.]

10. Notwithstanding any foregoing terms to the contrary, if licensee licenses the Bay Networks product “Site
Manager,” licensee may duplicate and install the Site Manager product as specified in the Documentation. This
right is granted solely as necessary for use of Site Manager on hardware installed with licensee’s network.
11. This license will automatically terminate upon improper handling of Software, such as by disclosure, or Bay
Networks may terminate this license by written notice to licensee if licensee fails to comply with any of the
material provisions of this license and fails to cure such failure within thirty (30) days after the receipt of written
notice from Bay Networks. Upon termination of this license, licensee shall discontinue all use of the Software
and return the Software and Documentation, including all copies, to Bay Networks.
12. Licensee’s obligations under this license shall survive expiration or termination of this license.

iv

114087 Rev. A

Contents

About This Guide
Audience ........................................................................................................................... xi
Before You Begin ..............................................................................................................xii
Conventions .....................................................................................................................xiii
Acronyms .........................................................................................................................xiv
Ordering Bay Networks Publications ..............................................................................xvii
Technical Support and Online Services
Bay Networks Customer Service ..................................................................................... xx
Bay Networks Information Services .................................................................................xxi
World Wide Web ........................................................................................................xxi
Customer Service FTP ..............................................................................................xxi
Support Source CD ..................................................................................................xxii
CompuServe ............................................................................................................xxii
InfoFACTS ............................................................................................................... xxiii
How to Get Help ...................................................................................................... xxiii
Chapter 1
Introducing Technician Interface Scripts
What Are Technician Interface Scripts? ..........................................................................1-2
Script Types ..............................................................................................................1-2
Script Command Categories ....................................................................................1-3
Installing .bat and .mnu Files ..........................................................................................1-5
Setting Up Scripts ...........................................................................................................1-6
Using Script Commands .................................................................................................1-8
Using the show Command .......................................................................................1-8
Using the enable and disable Commands .............................................................1-14

114087 Rev. A

v

Using the Menu Utility ...................................................................................................1-16
Displaying Menus ...................................................................................................1-16
Configuring Menus .................................................................................................1-19
Adding a Command .........................................................................................1-20
Deleting a Command .......................................................................................1-20
Clearing All Commands ...................................................................................1-20
Editing a Command .........................................................................................1-21
Editing a Menu Title .........................................................................................1-21
Loading a New Menu .......................................................................................1-21
Toggling Menu Titles and Commands .............................................................1-22
Saving Changes Made to Menus .....................................................................1-24
Chapter 2
Using the show Command
show appn ......................................................................................................................2-2
show at .........................................................................................................................2-43
show atm ......................................................................................................................2-59
show atmarp .................................................................................................................2-69
show atmdxi ..................................................................................................................2-76
show atmsig ..................................................................................................................2-85
show atm line ................................................................................................................2-90
show aurp ...................................................................................................................2-102
show autoneg .............................................................................................................2-112
show bgp ....................................................................................................................2-117
show bisync ................................................................................................................2-126
show bootp .................................................................................................................2-136
show bot .....................................................................................................................2-141
show bridge ................................................................................................................2-148
show circuits ...............................................................................................................2-154
show console ..............................................................................................................2-165
show csmacd ..............................................................................................................2-172
show dcmmw ..............................................................................................................2-185
show decnet ...............................................................................................................2-188
show dls ......................................................................................................................2-202
show ds1e1 ................................................................................................................2-213
show dsx3 ...................................................................................................................2-238
vi

114087 Rev. A

show dvmrp ................................................................................................................2-251
show e1 ......................................................................................................................2-261
show egp ....................................................................................................................2-268
show fddi ....................................................................................................................2-271
show fr ........................................................................................................................2-287
show ftp ......................................................................................................................2-296
show hardware ...........................................................................................................2-298
show hssi ....................................................................................................................2-305
show igmp ..................................................................................................................2-314
show ip .......................................................................................................................2-318
show ipx ......................................................................................................................2-342
show iredund ..............................................................................................................2-376
show isdn ....................................................................................................................2-379
show isdn bri ...............................................................................................................2-388
show lane ...................................................................................................................2-395
show lapb ...................................................................................................................2-405
show lnm ....................................................................................................................2-410
show nbip ...................................................................................................................2-420
show nml ....................................................................................................................2-423
show ntp .....................................................................................................................2-427
show osi ......................................................................................................................2-431
show ospf ...................................................................................................................2-439
show packet ................................................................................................................2-447
show ping ...................................................................................................................2-456
show ppp ....................................................................................................................2-461
show process ..............................................................................................................2-488
show protopri ..............................................................................................................2-493
show rarp ....................................................................................................................2-497
show rptr .....................................................................................................................2-500
show rredund ..............................................................................................................2-509
show rsc .....................................................................................................................2-517
show sdlc ....................................................................................................................2-521
show smds ..................................................................................................................2-525
show snmp .................................................................................................................2-530
show span ..................................................................................................................2-538

114087 Rev. A

vii

show sr .......................................................................................................................2-545
show srspan ...............................................................................................................2-557
show st2 .....................................................................................................................2-564
show sta .....................................................................................................................2-568
show state ..................................................................................................................2-571
show sws ....................................................................................................................2-574
show sync ...................................................................................................................2-592
show system ...............................................................................................................2-602
show t1 .......................................................................................................................2-607
show tcp .....................................................................................................................2-615
show telnet .................................................................................................................2-618
show tftp .....................................................................................................................2-620
show token ..................................................................................................................2-621
show vines ..................................................................................................................2-633
show wcp ....................................................................................................................2-644
show x25 ....................................................................................................................2-651
show xb ......................................................................................................................2-660
show xns .....................................................................................................................2-670
Chapter 3
Using enable/disable Commands
enable/disable appn ........................................................................................................3-2
enable/disable at .............................................................................................................3-5
enable/disable atm ..........................................................................................................3-6
enable/disable atmdxi .....................................................................................................3-8
enable/disable aurp ........................................................................................................3-9
enable/disable autoneg .................................................................................................3-10
enable/disable bootp .....................................................................................................3-11
enable/disable bridge ...................................................................................................3-12
enable/disable circuits ..................................................................................................3-13
enable/disable csmacd .................................................................................................3-14
enable/disable dcmmw .................................................................................................3-15
enable/disable decnet ...................................................................................................3-16
enable/disable dls .........................................................................................................3-17
enable/disable ds1e1 ....................................................................................................3-18
enable/disable dvmrp ...................................................................................................3-19
viii

114087 Rev. A

enable/disable e1 ..........................................................................................................3-20
enable/disable fddi ........................................................................................................3-21
enable/disable fr ...........................................................................................................3-22
enable/disable ftp ..........................................................................................................3-23
enable/disable hssi .......................................................................................................3-24
enable/disable igmp ......................................................................................................3-25
enable/disable ip ...........................................................................................................3-26
enable/disable ipx .........................................................................................................3-27
enable/disable iredund ..................................................................................................3-28
enable/disable isdn .......................................................................................................3-29
enable/disable isdn bri ..................................................................................................3-31
enable/disable lapb .......................................................................................................3-32
enable/disable lnm ........................................................................................................3-33
enable/disable nbip .......................................................................................................3-34
enable/disable nml ........................................................................................................3-35
enable/disable osi .........................................................................................................3-36
enable/disable ospf .......................................................................................................3-37
enable/disable packet ...................................................................................................3-38
enable/disable ppp ........................................................................................................3-39
enable/disable rarp .......................................................................................................3-40
enable/disable rptr ........................................................................................................3-41
enable/disable rredund .................................................................................................3-42
enable/disable sdlc .......................................................................................................3-43
disable/enable snmp .....................................................................................................3-44
enable/disable span ......................................................................................................3-45
enable/disable sr ...........................................................................................................3-46
enable/disable srspan ...................................................................................................3-47
enable/disable sta .........................................................................................................3-48
enable/disable sws .......................................................................................................3-49
enable/disable sync ......................................................................................................3-50
enable/disable t1 ...........................................................................................................3-51
enable/disable tcp .........................................................................................................3-52
enable/disable telnet .....................................................................................................3-53
enable/disable tftp .........................................................................................................3-54
enable/disable token .....................................................................................................3-55
enable/disable vines .....................................................................................................3-56
114087 Rev. A

ix

enable/disable wcp .......................................................................................................3-57
enable/disable x25 ........................................................................................................3-58
enable/disable xb ..........................................................................................................3-59
enable/disable xns ........................................................................................................3-60
Index

x

114087 Rev. A

About This Guide

Use this guide if you are responsible for monitoring and maintaining the
performance of Bay Networks™ routers and BNX® platforms using the Bay
Networks Technician Interface. Refer to this guide for
•

An overview of Technician Interface scripts

•

Instructions on how to
-- Load scripts
-- Set up scripts
-- Use script commands
-- Use the menu utility

•

Instructions on how to display (show a snapshot, or monitor via periodic
polling) statistical and configuration information about router services

•

Instructions on how to enable or disable router or BNX services

•

Instructions on how to configure the Packet Capture utility on the router or
BNX platform

Audience
Written for network managers and router technicians, this guide assumes that you
have a working knowledge of TCP/IP networking, and have some familiarity with
network management principles concerning the MIB, SNMP, configuration and
statistics management.

114087 Rev. A

xi

Using Technician Interface Scripts

Before You Begin
Before using this guide to run Technician Interface commands on a router or BNX
platform, you must
•

Install the router or BNX platform

•

Use one of the following methods to establish a connection to the router or
BNX platform:
-- Connect the serial port of an ASCII terminal device (for example, a DEC
VT100) directly to the console port of the router or BNX platform
-- Connect the serial port of a workstation or PC directly to the console port
of the router or BNX platform. (Run ASCII terminal emulation software
on the workstation or PC.)
-- Dial in to the console port of the router or BNX platform from a
workstation or PC running ASCII terminal emulation software. (This
alternative requires one modem locally attached to your workstation or
PC, and another modem locally attached to the console port of the router
or BNX platform you want to access.)
-- Establish a Telnet (in-band) connection to the router or BNX platform

Note: Before you can access the Technician Interface using Telnet, the router
or BNX platform must have at least one assigned IP address. Although there is
no limit to the number of Telnet connections that you can make to the
Technician Interface, we recommend that you establish no more than one
Telnet session per router or BNX platform.

xii

114087 Rev. A

About This Guide

Conventions
angle brackets (< >)

Indicate that you choose the text to enter based on the
description inside the brackets. Do not type the
brackets when entering the command.
Example: if command syntax is ping ,
you enter ping 192.32.10.12

bold text

Indicates text that you need to enter, command names,
and buttons in menu paths.
Example: Enter wfsm &
Example: Use the dinfo command.
Example: ATM DXI > Interfaces > PVCs identifies the
PVCs button in the window that appears when you
select the Interfaces option from the ATM DXI menu.

brackets ([ ])
ellipsis points

Indicate optional elements. You can choose none, one,
or all of the options.
.
Horizontal (. . .) and vertical ( .. ) ellipsis points indicate
omitted information.

italic text

Indicates variable values in command syntax
descriptions, new terms, file and directory names, and
book titles.

quotation marks (“ ”)

Indicate the title of a chapter or section within a book.

screen text

Indicates data that appears on the screen.
Example: Set Bay Networks Trap Monitor Filters

separator ( > )

Separates menu and option names in instructions and
internal pin-to-pin wire connections.
Example: Protocols > AppleTalk identifies the
AppleTalk option in the Protocols menu.
Example: Pin 7 > 19 > 20

vertical line (|)

Indicates that you enter only one of the parts of the
command. The vertical line separates choices. Do not
type the vertical line when entering the command.
Example: If the command syntax is
show at routes | nets, you enter either
show at routes or show at nets, but not both.

114087 Rev. A

xiii

Using Technician Interface Scripts

Acronyms

xiv

ACE

Advanced Communications Engine

AFN

Access Feeder Node

ALN

Access Link Node

AN

Access Node

ANH

Access Node Hub

APING

APPN Ping

APPN

Advanced Peer-to-Peer Routing

ARP

Address Resolution Protocol

ASCII

American Standard Code for Information Interchange

ASN

Access Stack Node

ASN.1

Abstract Syntax Notation

AT

AppleTalk Protocol

ATM

Asynchronous Transfer Mode

AURP

Appletalk Update-based Routing Protocol

BCN

Backbone Concentrator Node

BGP

Border Gateway Protocol

BLN

Backbone Link Node

BLN-2

Backbone Link Node (2 power supplies)

BOOTP

Bootstrap Protocol

CLNP

Connectionless Network Protocol

CN

Concentrator Node

CPU

Central Processing Unit

CRC

Cyclic Redundancy Check

CSMA/CD

Carrier Sense Multiple Access with Collision Detection

DCM

Data Collection Module

DLCMI

Data Link Control Management Interface

DLSw

Data Link Switch

DOS

Disk Operating System

DRAM

Dynamic RAM

DSAP

Destination Service Access Point

DVMRP

Distance Vector Multicast Routing Protocol

114087 Rev. A

About This Guide

114087 Rev. A

EOF

End of File

EGP

Exterior Gateway Protocol

FAT

File Allocation Table

FDDI

Fiber Distributed Data Interface

FIFO

First In First Out

FRSW

Frame Relay Switch

FTP

File Transfer Protocol

FN

Feeder Node

FR

Frame Relay

FRE

Fast Routing Engine

GAME

Gate Access Management Entity

GMT

Greenwich Mean Time

HDLC

High-level Data Link Control

HSSI

High Speed Serial Interface

ICMP

Internet Control Message Protocol

IGMP

Internet Group Membership Protocol

IN

Integrated Node

IP

Internet Protocol

IPX

Internet Packet Exchange

ISDN

Integrated Services Digital Network

LAN

Local Area Network

LAPB

Link Access Procedure Balanced

LED

Light Emitting Diode

LLC

Logical Link Control

LMI

Local Management Interface

LN

Link Node

LNM

LAN Network Manager

LSP

Link State Packet

MAC

Media Access Control

MCT1

Multichannel T1

MIB

Management Information Base

MOSY

Managed Object Syntax

NML

Native Mode LAN
xv

Using Technician Interface Scripts

xvi

NSAP

Network Service Access Point

NVFS

Non-Volatile File System

OSI

Open Systems Interconnection

OSPF

Open Shortest Path First

PCMCIA

Personal Computer Memory Card International Association

PPP

Point-to-Point Protocol

PPX

Parallel Packet Express

PROM

Programmable Read-Only Memory

QENET

Quad Ethernet

RAM

Random Access Memory

RARP

Reverse Address Resolution Protocol

RIF

Routing Information Field

RFC

Request for Comment

SAP

Service Access Point

SDLC

Synchronous Data Link Control

SIMM

Single In-line Memory Module

SMDS

Switched Multimegabit Data Services

SNAP

SubNetwork Access Protocol

SNMP

Simple Network Management Protocol

SR

Source Routing

SRM-L

System Resources Link Module

STA

Statistics, Thresholds, and Alarms

SYSCON

System Controller board

SWS

Switched Services

TCP

Transport Control Protocol

TFTP

Trivial File Transfer Protocol

TIP

Terminal Interface Program

TP

Transaction Program

VC

Virtual Circuit

VINES

Virtual Networking System

WAN

Wide Area Network

XB

Translation Bridge

XNS

Xerox Networking Systems
114087 Rev. A

About This Guide

Ordering Bay Networks Publications
To purchase additional copies of this document or other Bay Networks
publications, order by part number from the Bay Networks Press™ at the following
telephone or fax numbers:
• Telephone - U.S./Canada
• Telephone - International
• Fax

1-888-4BAYPRESS
1-510-490-4752
1-510-498-2609

You can also use these numbers to request a free catalog of Bay Networks Press
product publications.

114087 Rev. A

xvii

Technical Support and Online Services

To ensure comprehensive network support to our customers and partners
worldwide, Bay Networks Customer Service has Technical Response Centers
in key locations around the globe:
•
•
•
•
•

Billerica, Massachusetts
Santa Clara, California
Sydney, Australia
Tokyo, Japan
Valbonne, France

The Technical Response Centers are connected via a redundant Frame Relay
Network to a Common Problem Resolution system, enabling them to transmit and
share information, and to provide live, around-the-clock support 365 days a year.
Bay Networks Information Services complement the Bay Networks Service
program portfolio by giving customers and partners access to the most current
technical and support information through a choice of access/retrieval means.
These include the World Wide Web, CompuServe, Support Source CD, Customer
Support FTP, and InfoFACTS document fax service.

114087 Rev. A

xix

Using Technician Interface Scripts

Bay Networks Customer Service
If you purchased your Bay Networks product from a distributor or authorized
reseller, contact that distributor’s or reseller’s technical support staff for assistance
with installation, configuration, troubleshooting, or integration issues.
Customers can also purchase direct support from Bay Networks through a variety
of service programs. As part of our PhonePlus™ program, Bay Networks Service
sets the industry standard, with 24-hour, 7-days-a-week telephone support
available worldwide at no extra cost. Our complete range of contract and
noncontract services also includes equipment staging and integration, installation
support, on-site services, and replacement parts delivery -- within approximately
4 hours.
To purchase any of the Bay Networks support programs, or if you have questions
on program features, use the following numbers:
Region

Telephone Number

Fax Number

United States and
Canada

1-800-2LANWAN; enter Express Routing
Code (ERC) 290 when prompted

(508) 670-8766

(508) 436-8880 (direct)
Europe

(33) 92-968-300

(33) 92-968-301

Asia/Pacific Region

(612) 9927-8800

(612) 9927-8811

Latin America

(407) 997-1713

(407) 997-1714

In addition, you can receive information on support programs from your local
Bay Networks field sales office, or purchase Bay Networks support directly
from your authorized partner.

xx

114087 Rev. A

Technical Support and Online Services

Bay Networks Information Services
Bay Networks Information Services provide up-to-date support information as a
first-line resource for network administration, expansion, and maintenance. This
information is available from a variety of sources.

World Wide Web
The Bay Networks Customer Support Web Server offers a diverse library of
technical documents, software agents, and other important technical information
to Bay Networks customers and partners.
A special benefit for contracted customers and resellers is the ability to access the
Web Server to perform Case Management. This feature enables your support staff
to interact directly with the network experts in our worldwide Technical Response
Centers. A registered contact with a valid Site ID can
•

View a listing of support cases and determine the current status of any open
case. Case history data includes severity designation, and telephone, e-mail,
or other logs associated with the case.

•

Customize the listing of cases according to a variety of criteria, including
date, severity, status, and case ID.

•

Log notes to existing open cases.

•

Create new cases for rapid, efficient handling of noncritical network
situations.

•

Communicate directly via e-mail with the specific technical resources
assigned to your case.

The Bay Networks URL is http://www.baynetworks.com. Customer Service is a
menu item on that home page.

Customer Service FTP
Accessible via URL ftp://support.baynetworks.com (134.177.3.26), this site
combines and organizes support files and documentation from across the
Bay Networks product suite, including switching products from our Centillion™
and Xylogics® business units. Central management and sponsorship of this FTP
site lets you quickly locate information on any of your Bay Networks products.

114087 Rev. A

xxi

Using Technician Interface Scripts

Support Source CD
This CD-ROM -- sent quarterly to all contracted customers -- is a complete Bay
Networks Service troubleshooting knowledge database with an intelligent text
search engine.
The Support Source CD contains extracts from our problem-tracking database;
information from the Bay Networks Forum on CompuServe; comprehensive
technical documentation, such as Customer Support Bulletins, Release Notes,
software patches and fixes; and complete information on all Bay Networks
Service programs.
You can run a single version on Macintosh Windows 3.1, Windows 95,
Windows NT, DOS, or UNIX computing platforms. A Web links feature enables
you to go directly from the CD to various Bay Networks Web pages.

CompuServe
For assistance with noncritical network support issues, Bay Networks Information
Services maintain an active forum on CompuServe, a global bulletin-board
system. This forum provides file services, technology conferences, and a message
section to get assistance from other users.
The message section is monitored by Bay Networks engineers, who provide
assistance wherever possible. Customers and resellers holding Bay Networks
service contracts also have access to special libraries for advanced levels of
support documentation and software. To take advantage of CompuServe’s recently
enhanced menu options, the Bay Networks Forum has been re-engineered to allow
links to our Web sites and FTP sites.
We recommend the use of CompuServe Information Manager software to access
these Bay Networks Information Services resources. To open an account and
receive a local dial-up number in the United States, call CompuServe at
1-800-524-3388. Outside the United States, call 1-614-529-1349, or your nearest
CompuServe office. Ask for Representative No. 591. When you are on line with
your CompuServe account, you can reach us with the command GO BAYNET.

xxii

114087 Rev. A

Technical Support and Online Services

InfoFACTS
InfoFACTS is the Bay Networks free 24-hour fax-on-demand service. This
automated system has libraries of technical and product documents designed to
help you manage and troubleshoot your Bay Networks products. The system
responds to a fax from the caller or to a third party within minutes of being
accessed.
To use InfoFACTS in the United States or Canada, call toll-free 1-800-786-3228.
Outside North America, toll calls can be made to 1-408-764-1002. In Europe,
toll-free numbers are also available for contacting both InfoFACTS and
CompuServe. Please check our Web page for the listing in your country.

How to Get Help
Use the following numbers to reach your Bay Networks Technical Response
Center:

114087 Rev. A

Technical Response Center Telephone Number

Fax Number

Billerica, MA

1-800-2LANWAN

(508) 670-8765

Santa Clara, CA

1-800-2LANWAN

(408) 764-1188

Valbonne, France

(33) 92-968-968

(33) 92-966-998

Sydney, Australia

(612) 9927-8800

(612) 9927-8811

Tokyo, Japan

(81) 3-5402-0180

(81) 3-5402-0173

xxiii

Chapter 1
Introducing Technician Interface Scripts

This chapter provides an overview of the Technician Interface scripts and explains
how to run them. It also describes how to
•

Load scripts

•

Set up scripts

•

Use script commands

•

Use the menu utility

This manual assumes that you have a working knowledge of the Bay Networks
Technician Interface. For complete information about this router management
tool, refer to Using Technician Interface Software. For information on how to
write your own Technician Interface scripts, refer to Writing Technician Interface
Scripts.

114087 Rev. A

1-1

Using Technician Interface Scripts

What Are Technician Interface Scripts?
The Technician Interface show/monitor and enable/disable scripts are programs
that enable you to view and use information stored in the Bay Networks
Management Information Base (MIB). You use scripts to display statistical and
configuration information about various router services, and to enable or disable
those services.

Script Types
Most Technician Interface scripts run from a .bat (batch) file.
The system loads a specific .bat file into active memory when you enter a scripts
command such as show appn directory statistics. The system software supports
one .bat file for each router protocol or service. Each .bat file contains the routines
for all script subcommand options for a protocol or service. The routine called by
each subcommand generates and prints (to the router console) statistics that reveal
a particular view of that protocol or service.
As an alternative to entering show/enable/disable commands at the Technician
Interface prompt, you can also access protocol-specific menus from the scripts
main menu. You enter (choose by number) a protocol/service submenu from the
scripts main menu. From a submenu, you can access all scripts options for a
protocol or service without entering commands. All scripts menus exist as *.mnu
files you install during initial configuration of each router. To save file space,
install only the .bat and .mnu files that pertain to the protocols or services you
want to support on each router.
Other Technician Interface scripts are programs embedded within the router
software image. The router software currently includes embedded scripts for the
following services:
• CSMACD

• TFTP

• IP

• SNMP

• FR

• SYNC

• FTP

• TELNET

• TCP

1-2

114087 Rev. A

Introducing Technician Interface Scripts

These scripts run more efficiently than their batch file counterparts. You enter at
the Technician Interface prompt the command for any script, regardless of type
(batch or embedded) in the same way, as follows:
{show|enable|disable} {} {}

Script Command Categories
The system software supports scripts in the following command categories:
show

Displays configuration, state, and statistical information
about a router service. This command helps you isolate
problems such as circuits that are not working, packets that
are not being forwarded, and so on. It uses the show.bat file.

monitor

Displays the same information as the show command but
refreshes the display periodically so you can observe trends
and changes. Since you can use monitor in place of show,
this manual does not describe syntax for the monitor
command. This command uses the monitor.bat file.

enable/disable

Enables or disables system features, protocols, drivers, or
individual circuits. These commands use the enable.bat and
disable.bat files.

menu

Provides a menu interface to the scripts. Also provides a
menu-building feature that enables you to create custom
menus. This command uses menu.bat and various .mnu files.

Each show command supports a subset of commands that display statistical and
configuration information about a particular service or driver running on the
router.

114087 Rev. A

1-3

Using Technician Interface Scripts

Some show commands present a broad or collective view of router status and
resources. For example,
show circuits

Displays information about all drivers running on the
router. You can use this command to display information
about all circuits without needing to know the driver that
runs on each circuit.

show drivers

Displays information about the configuration of all link
modules in the router.

show hardware

Displays backplane, configuration file, image, memory,
PROM, and slot information about the router’s hardware.

show protocols

Displays information about the protocols configured on
every slot in the router.

show state

Displays information about the current state of services
running on the router.

show system

Displays information about router memory, buffers, drivers,
and configured protocols.

Note: You can abbreviate command names, using the first three characters of
the command name, as long as the abbreviation uniquely identifies the
command.

To establish the search path used to find the script files, use the run setpath
command. It defines the aliases that integrate scripts into the Technician Interface
command set. The section “Setting Up Scripts” explains the run setpath
command, which uses the setpath.bat script.

1-4

114087 Rev. A

Introducing Technician Interface Scripts

Installing .bat and .mnu Files
You can use the Bay Networks implementation of File Transfer Protocol (FTP) to
install .bat version scripts and .mnu script menu files on a memory card in the
router. FTP enables you to install more than one script at a time.
Before installing any scripts on a router:
•

Log in to the router. (Refer to Chapter 1 of Using Technician Interface
Software if you need more information on login procedures.)

•

Enable the FTP service on the router.

•

Run the dir command to verify that you have sufficient contiguous freespace
on the NVFS volume reserved for scripts and their associated menu files.
(Refer to Chapter 4 of Using Technician Interface Software if you need more
information on how to run the dir command.)

•

Run the compact command on the NVFS volume reserved for scripts and
their associated menu files. (Refer to Chapter 8 of Using Technician Interface
Software if you need more information on how to run the compact
command.)

To install all the .bat scripts and .mnu menu files located in a directory on a UNIX
workstation, change to that directory using the cd command. Then enter the
following commands at the UNIX command line prompt:
$: ftp 
Name: Manager
Password: 
ftp> cd :
ftp> bin
ftp> prompt
ftp> mput *.bat
ftp> mput *.mnu

The prompt command disables the prompt that asks whether you want to transfer
each file.
114087 Rev. A

1-5

Using Technician Interface Scripts

Note: You must have Manager access to write to an NVFS volume using the
Bay Networks implementation of FTP.

This procedure installs all of the .bat and .mnu files on a file system volume in the
router. To conserve space on a router’s local file system, load only scripts for the
protocols and drivers you need to run on that router.
If you want to use the Trivial File Transfer Protocol (TFTP) to install .bat and
.mnu files one at a time, refer to Chapters 4 and 5 of Using Technician Interface
Software.

Setting Up Scripts
Once you log in to a Technician Interface session on a router, you can enter any
embedded script commands at the command line prompt without any additional
preparations. However, before you run any .bat version scripts, designate a default
file system volume, as shown in the following example:
dir 2:

Next, define the search path and alias definitions for your .bat and .mnu version
script files by using the run setpath command. The search path is a list of volume
IDs you want the system to search for any script file. There are two ways to
specify a search path, as shown in the following examples.
Example 1 -- Entering the volume IDs on the command line
run setpath "2:;3:;4:"

1-6

114087 Rev. A

Introducing Technician Interface Scripts

Example 2 -- Letting the setpath command prompt you for input
run setpath
NVFS File System:
VOL
STATE
TOTAL SIZE
FREE SPACE
CONTIG FREE SPACE
--------------------------------------------------------------3:
FORMATTED
2097152
1218683
1017067
2:
FORMATTED
2097152
431128
431128
Please enter the volume ID that contains the script files.
More than one volume may be entered; each separated by a semi-colon.
Format: :[;: ...]
Example: 2:;3:;4:
Enter volume(s)[2:]: 3:

You can also use the Manager or User autoscript features to automatically run the
setpath.bat script (the run setpath command). Specify a file system search path,
Manager or User script file, and logout mechanism using following
wfSerialPortEntry (router serial port) attributes:
•

Login Script Search Path

•

Manager’s Login Script

•

User’s Login Script

•

Force User Logout

You can set up separate Manager and User autoscript files for login. The User
autoscript contains a switch that enables you to lock the user into the script. With
the switch enabled, the autoscript automatically logs out a user that tries to break
out of the script. For more information on the autoscript feature, see Chapter 2 of
Using Technician Interface Software.

114087 Rev. A

1-7

Using Technician Interface Scripts

Using Script Commands
This section provides an overview of the show/monitor and enable/disable
commands.

Using the show Command
After you set up scripts with the run setpath command, you can use the show