- HELP
The Network Interconnect Exerciser (EVDWC) provides a VAX level 2R
diagnostic exerciser for Ethernet networks. EVDWC determines the
ability of nodes on the network to communicate with each other and
provides the operator with analysis of errors obtained while running
the NIE. Node installation verification and problem isolation can
be performed using the NIE.
This version of EVDWC includes support for the DEBNT, which is a dual
function adapter. This BI adapter contains an Ethernet port as well as
a TK50 Streaming tape drive port. The TK50 is not used during this
diagnostic and is covered by EVMDA. The Ethernet hardware is implemeted
using the Lance Chip Set.
- SYSGEN_CONNECT
It may be possible that the VMS driver used by the NIE is not loaded.
To ascertain this information execute the following SYSGEN command:
$ MCR SYSGEN SHOW /DEV=XEDRIVER
If a message indicating that the driver is not loaded is displayed then
the following steps must be taken:
$MC SYSGEN
SYSGEN>CON XEA0/DRIVER=XEDRIVER/ADAP=UB0/CSR=%O774510/VEC=%O120/NUMVEC=1
This command builds the necessary data structures(DDB,CRB,IDB,UCB).
SYSGEN> SHOW/DEVICE=XE"
This command shows the Start and End addresses for each of these data
structures as well as a device name and unit number. The format of the
SYSGEN output will be:
__Driver_____Start____End____Dev___DDB______CRB______IDB_____Unit__UCB__
XEDRIVER 800781B0 80079FF0
XEA 80085AE0 80085BA0 80079FF0
0 8007A410
- NAMES
XEa (a=A,B,C..) correspond directly to the physical DEUNA/DELUAs.
- PARAMETERS
In order to have EVDWC.EXE run successfully one system parameter
must be changed. The VMS SYSGEN parameter (user) BYTLM must be 30000.
This parameter can be changed by the system manager or software
specialist. Required system privileges are (SYSPRV,OPER).
- BYTLM
NOTE: underlined items are those to be input by the user.
To change <user> BYTLM parameter:
$ SET DEF SYS$SYSROOT:[SYSEXE]
----------------------------
$ RUN AUTHORIZE
-------------
UAF> MODIFY <user accn't name>/BYTLM = 30000
---------------------------------------
UAF> EXIT
----
$ LO (user must logout to write BYTLM quota)
- ATTACH
A sample of attaching a DEUNA/DELUA on a VAX 11/780:
DS> ATTACH DW780 SBI DW0 3 4 ;Attaches the UNA to the SBI
DS> ATTACH UNA11 DW0 XEA0 774510 120 5 ;Attach XEx (x=A,b,..) to UBA
LUA11
DS> SELECT XEx ;Select the attached DEUNA/DELUA
A sample of attaching a DEUNA/DELUA on a VAX 11/750:
DS> ATTACH DW750 HUB DW0
DS> ATTACH UNA11 DW0 XEA0 774510 120 5
LUA11
DS> SEL XEx
VAX 11/730 example:
DS> ATTACH DW730 HUB DW0
DS> ATTACH UNA11 DW0 XEA0 774510 120 5
LUA11
DS> SEL XEx
VAX 8200/8300 example:
DS> ATT DWBUA HUB DW0 n 4 ; n = BUA node ID
DS> ATTACH UNA11 DW0 XEA0 774510 120 5
LUA11
DS> SEL XEx
VAX 8600 example:
DS> ATTACH SBIA HUB SI0
DS> ATTACH DW780 SI0 DW0 3 4
DS> ATTACH UNA11 DW0 XEA0 774510 120 5
LUA11
DS> SEL XEx
VAX 8800 example:
DS>ATTACH NBIA HUB NBIAn ! where n 0 or 1
DS>LOGICAL ADAPTER # ? N ! 0 or 1
DS>ATTACH NBIB NBIAn
DS>Device Name ? NBIBn ! where n 0 to 3
DS>BI # ? n ! 0 or 1
DS>BI Node Number (HEX) ? n ! n 0 to F
DS>ATT DWBUA NBIBn DW0 x 4 ! where x = BI node # 0-F
DS>ATTACH UNA11 DW0 XEA0 774510 120 5
LUA11
The following is an example of the attach sequence for the DEBNT:
For the 82xx,83xx:
ATTACH DEBNT HUB ETa node_number
ATTACH LANCE ETa ETAn
Where:
a = controller designator (e.g. ETA, ETB, ETC)
node_number = BI node number of DEBNT module
n = unit number of Lance
For the 86xx:
ATTACH SBIA HUB SIn
ATTACH DEBNT SIn ETa BIn
ATTACH LANCE ETa ETAn
where: (SI)n = unit number 0-1
(BI)n = BI # 0-F
For the 88xx and 85xx:
ATTACH NBIA HUB NBIAn LAn
ATTACH NBIB NBIAn NBIBn BIn BINn
ATTACH DEBNT NBIBn ETa BIn
ATTACH LANCE ETa ETAn
where: (NBIA)n = unit number 0-1
(LA)n = logical adapter number 0-1
(NBIB)n = unit number 0-3
(BI)n = BI # 0-1
(BIN)n = BI node # 0-F
SELECT ETAn
- selects the unit for testing. The unit number must be the
same as what was used in the ATTACH.
- SECTIONS
There is only one section to the NIE which contains the executable code
for the "TEST" commands. These are the following three commands:
RUN DIRECT
LOOP
ALL
- DEVICE
EVDWC supports connectivity testing of a DEUNA or DELUA on a VAX to any
device supporting low level maintenance features as described in Rev. 2
of the three company Ethernet Specification.
- CONTROL_C
Control-C handling differs depending on what is transpiring during NIE
testing. If one of the following commands is in progress then a control-C
will result in control being passed to the NIE: BUILD, LISTEN, RUN, BOUNCE,
or IDENTIFY. Otherwise, control is returned to the Diagnostic Supervisor.
- QUICK
This program does not implement the QUICK feature.
- SUMMARY
The summary command will display the type and count of the errors
encountered by the NIE.
- NIE
NIE is the acronym for Network Interconnect Exerciser.
- COMMANDS
Once the NIE program is started, the initialization code is executed.
After that a NIE> prompt will appear at which time the operator can
enter any of the NIE commands. It is only necessary to enter enough
of the command to uniquely identify the command. For a brief summary of
commands type HELP EVDWC BRIEF.
- HELP
Help or ?
Prints out a brief description of NIE commands.
- SHOW
Display information about NIE data structures and operating
parameters.
- NODES
Prints out the contents of the node table.
- MESSAGE
Prints out the current message parameters for size,
type, copies, and print status
- COUNTERS
Prints out the contents of the host node DEUNA/DELUA
internal counters.
- LISTEN
Prints out the contents of the two listen logs.
- REMOTE/adr
Prince out the contents of a remote node's internal
counters.
- NODE/adr
The node command allows the operator to enter nodes into
the node table. A list of Ethernet addresses, separated
by commas, may be specified to be entered into the node
table.
- MESSAGE
Modifies the NIE's operating parameters. If no qualifiers
are specified then the parameters are set to there default
values. The default values are: /TYPE=ALPHA, /SIZE=512,
and /COPIES=1.
MESSAGE may take one of the following qualifiers
/TYPE=type
Modify the default type that will be used as data
while running tests.
'type' may be one of:
Alpha -- !"#$%&'()*+,-./0123456789;:=?abcdefg etc.
Ones -- message of all ones (11111111....)
Zeros -- message of all zeros (0000000....)
1Alt -- alternating 1's and 0's (10101010...)
0Alt -- alternating 0's and 1's (01010101...)
CCITT -- "CCITT" pseudo-random test pattern
TEXT -- selects the user specified data pattern
/SIZE=n
Sets the length of the data field for packets used in
running tests (used in either the RUN command or BOUNCE
command).
/COPIES=n
Sets the default copies count to 'n'. If, when issuing
the RUN command, the /PASS qualifier is not specified then
the 'COPIES' value will be used as a pass count.
/TEXT=string
Defines the user specified text message that may be
selected by the /TYPE qualifier. 'string' may be one of
the following two formats:
%'hexstring' - sets the text type to the hexadecimal string
specified by 'hexstring'
"'charstring'- sets the text type to the character string
specified by 'charstring'
- RUN
RUN TEST/PASS=NN
Causes execution of the specified test for nn number of
passes. A /COPIES count specified in the MESSAGE command
is used for the pass count if it is not included in the
command line. A value of nn=-1 will cause the test to be
run indefinitely.
There are three tests to choose from, DIRECT,LOOP, and ALL
- DIRECT
The direct test sends a loop direct message to all of the
nodes contained in the node table and waits for a response.
The integrity of the returned data is checked and any errors
are reported to the operator.
- LOOPPAIR
The LOOPPAIR test sends a full assist loop message to each
logically adjacent pair of nodes in the node table. The
last node in the node table is considered logically adjacent
to the first. A sample test path for a three node node table
is shown below:
NIE to N1 to N2 to N1 to NIE
NIE to N2 to N3 to N2 to NIE
NIE to N3 to N1 to N3 to NIE
- ALL
The all node test performs the most extensive check of the
network and is composed of two parts. First a loop direct
message is sent to each node in the table. If this is
successful, the exerciser builds an array of node pairs
from the table and sends a transmit and receive assist message
to each pair in the array. A sample array of pairs for a
table with 7 nodes is shown below.
1-2 2-3 3-4 4-5 5-6 6-7
1-3 2-4 3-5 4-6 5-7
1-4 2-5 3-6 4-7
1-5 2-6 3-7
1-6 2-7
1-7
- IDENTIFY/adr
A request ID message is sent to the node specified by adr
and the responded system ID parameters are printed.
- BUILD
The build command causes the NIE to listen for system
ID messages that are broadcast by all nodes on the Ethernet
that conform to the three company Ethernet specification.
These nodes will identify themselves approximately every
ten minutes. When the NIE hears from a node it will make
an entry into the node table for that node.
- CLEAR
Clears the NIE's data structures or operating parameters.
- NODE/adr
The Clear node command clears the specified node from
the node table. The node can be specified by either
its 12 digit physical address of its logical name
(as assigned by node table). 'adr' can be a comma
separated list of nodes.
- NODE/ALL
This command clears the node table.
- MESSAGE
This command sets the message parameters back to their
default values. See the MESSAGE command for the default
values
- SUMMARY
This command clears the summary table.
- SUMMARY
The summary command prints out the summary table.
The NIE maintains the following information for
nodes who have been sent messages:
Receives not complete Receives complete
Length errors Data compare errors
Bytes compared Bytes transferred
- SAVE
The Save command saves the contents of the node table.
The table is saved in a file NIE.TBL. This file will reside
in [SYSMAINT] and can be edited to add or remove node
names.
- UNSAVE
The UNSAVE command restores the contents of the node table.
The most recent copy of NIE.TBL is loaded into the diagnostic
node table.
- EXIT
Returns control to the diagnostic supervisor
- PRINT
This command enables the printing of all messages displayed
by the NIE. The opposite of this command, NOPRINT, will
only allow the NIE to report the first three ERRORs that
it encounters.
- LISTEN
This command invokes the NIE's Ethernet monitor. When
issued it causes the NIE to put the DEUNA/DELUA into
promiscuous mode and then filter incoming packets against
user-specified filters. The user may specify a source
address, destination address, protocol type, or any combination
of the three to be used as filters that an incoming packet
must match. If a packet passes these filters then its source,
destination, protocol type, and length are logged in the listen
log. For each entry a count is maintained for the number of
times a packet has been received with the exact same
characteristics. The log may hold up to thirty unique packet
descriptions. In addition to the listen log, the NIE also
maintains a list of source addresses of packets that have
passed the specified filters. This log may also contain
thirty entries.
- SOURCE/adr
Specifies a source address filter for the LISTEN
command. Only one address may be used for this
filter.
- DESTINATION/adr
Specifies a destination address filter for the LISTEN
command. Only one address may be used for this
filter.
- PROTOCOL/protype
Specifies a protocol type filter for the LISTEN
command. Only one protocol type may be used for
this filter.
- BRIEF
COMMAND SUMMARY FOR THE NETWORK INTERCONNECT EXERCISER (NIE)
(it is only necessary to type the letters in brackets)
[H]elp or ? - type this help text.
[E]xit - return to the supervisor.
[SH]ow [N]odes - prints information in current node
table.
[SH]ow [M]essage - prints selected message type, size,
copies and error print status.
[SH]ow [C]ounters - prints the low level counters of
the HOST NODE.
[S]how [L]isten - print listen data
[S]how [R]emote/<addr> - prints the error counters in the
remote node
[R]un [L]ooppair/[P]ass=nn - runs the looppair test, pass
defaults to 1
[R]un [A]ll/[P]ass=nn - runs the node-to-node test
[R]un [D]irect/[P]ass=nn - runs the direct loop test
[BO]unce /<addr list> - allows the operator to select a
path for loopforwarding a packet.
[L]isten - listen for all packets on the NI.
[L]isten [P]rotocol/nnnn - listen to the NI for packets using
protocol type nnnn and display those
packets.
[L]isten [S]ource/<addr> - listen to the NI for packets which
have the source address indicated.
[L]isten [D]estination/<addr> - listen to the NI for packets which
have the destination address indicated.
[L]isten [S]ource/<addr>/[D]estination/<addr>/[P]rotocol/nnnn -
listen to the NI for packets which
have source and destination addresses
and the protocol type as indicated.
[P]rint - print all error messages
[NOP]rint - print only the 1st 3 error messages.
[M]essage/[TY]pe=a/[S]ize=n/[C]opies=m - allows the operator to
modify the default message type, size
and copy count
Notes: 1) adr is the physical address of a node on the NI.
2) Pass count is a decimal number between 1 and 65534.
A default value of 1 is assumed. Specifying -1
causes the test to be run indefinately.
- SCRIPT
Indirect command files can contain commands appropriate to the NIE>
or DS> command level and are invoked by a "@file-spec" at the DS> level
a sample command file may look something like:
DS> START
NIE> UNSAVE
NIE> BUILD
NIE> RUN DIRECT/P=5