Google
 

Trailing-Edge - PDP-10 Archives - k20v7b - 2-diagnostics/dfnib.hlp
There are 2 other files named dfnib.hlp in the archive. Click here to see a list.
!DFNIB.HLP	DFNIB NIA20 Exerciser Help File
!		Revised 10-Jun-85 by Gregory A. Scott
!
!Each DFNIB command has an entry in this file.  The entries must be in
!a logical order.  Each command name must be preceeded with an "*"  in
!column 1 with no trailing spaces, as an exact match with the  command
!name is searched for.
!
!Additional entries may be added to  this help file, but care must  be
!taken to follow the above.

Help for a specific command may  be obtained with the HELP command  as
follows:

        HELP command-name

For instance  if  you  wish additional  information  about  the  CLEAR
command you  would  enter "HELP  CLEAR".   Enter "?"  after  the  HELP
command to see what help is available.

!All of the test names here
*ALL-TESTS

"RUN ALL-TESTS" runs each of the  five tests, then prints the  overall
totals.  The overall totals are only printed on the last iteration  of
the test.  The five tests are:

	Basic Message Test
	Data Pattern Message Test
	Loop Assist Test
	Message Activity Test
	Node Communication Test

For more information  about these  tests, enter HELP  followed by  the
name of the test (e.g. HELP BASIC-MESSAGE-TEST).  For additional  help
with the RUN command, enter HELP RUN.

*BASIC-MESSAGE-TEST

The BASIC-MESSAGE-TEST does  a direct  loopback of a  100. byte  alpha
test pattern to each node in the node table.  The RUN command is  used
to run tests.  For help with the RUN command, enter HELP RUN.

*DATA-PATTERN-MESSAGE-TEST

The  "DATA-PATTERN-MESSAGE-TEST"  does  a  direct  loopback  of   test
pattern(s) to each node in the  node table. The test pattern  selected
by the user prior to test start up is used.  If "EVERY" was  selected,
all test patterns are used.  The  message length also selected by  the
user prior to test startup  is used.  The RUN  command is used to  run
tests.  For help with the RUN command, enter HELP RUN.

*MESSAGE-ACTIVITY-TEST

The "MESSAGE-ACTIVITY-TEST" sends a direct loopback message of a  test
pattern to a group of 10 or  less nodes selected from the node  table.
If there are more than 10 nodes  in the node table they are tested  in
groups of 10.   The test pattern  is selectable by  the user prior  to
test start up. If  "EVERY" was selected, all  test patterns are  used.
The message length is also selected by the user prior to test startup.
The RUN command is used to run tests.  For help with the RUN  command,
enter HELP RUN.

*LOOP-ASSIST-TEST

The "LOOP-ASSIST-TEST" tests the "loop  assisted" function of all  the
NI nodes that have been entered in the node table prior to test  start
up.  A minimum of two nodes are  required to run this test.  One  node
will be the target node and the  other node will be the loop  assisted
node.  The transmit assist, receive assist, and full assist operations
will be tested in that order. The size of the message and data pattern
are operator selectable  prior to  test startup.  The  RUN command  is
used to run tests.  For help with the RUN command, enter HELP RUN.

*NODE-COMMUNICATION-TEST

The "NODE-COMMUNICATION-TEST"  will  provide  the  most  comprehensive
testing of the NI.  Testing will be  performed two nodes at a time  by
attempting two-way communication with a  pair of nodes.  Testing  each
pair of nodes in a predetermined sequence will assure that testing  of
nodes  physically  positioned  at  opposite  ends  of  a  segment  has
occurred.

This test uses the loop-assisted function  for all the NI nodes.   Two
nodes will be required to run this test.  One node will be the  target
node and the other node will be  the loop assisted node.  The size  of
the message and  data pattern  are operator selectable  prior to  test
start up.  The RUN command  is used to run  tests.  For help with  the
RUN command, enter HELP RUN.

!Scripts
*DEFAULT

The "DEFAULT" script sets the message  length to random, set the  data
pattern to  EVERY, runs  ALL-TESTS  and then  prints out  the  overall
totals.  The RUN command  is used to run  scripts.  For help with  the
RUN command, enter HELP RUN.

*LONG-PACKETS

The "Long-Packets" script sets the message length to 1486.  bytes, the
data pattern to  EVERY and then  runs ALL-TESTS.  The  RUN command  is
used to run utilities.  For help with the RUN command, enter HELP RUN.

*QUICK-VERIFY

The "QUICK-VERIFY" script sets  the message length  to 64. bytes,  the
data pattern to CCITT and then runs the Message Activity Test and  the
Node Communication Test.   The overall totals  are printed after  each
pass.  The RUN command is used to run scripts.  For help with the  RUN
command, enter HELP RUN.

*SHORT-PACKETS

The "Short-Packets" script sets the message length to 64.  bytes,  the
data pattern to  EVERY and then  runs ALL-TESTS.  The  RUN command  is
used to run utilities.  For help with the RUN command, enter HELP RUN.

!Utilities
*OVERALL-TOTALS

The "OVERALL-TOTALS" utility  is functionally equivilent  to the  SHOW
OVERALL-TOTALS command.   It is  used  in a  list  of tests  to  print
occasional summaries.  For example,

	NIB>RUN /PASSES:10 BA/ITER:5,DAT/I:3,OVERA

This would  run  the BASIC-MESSAGE-TEST  for  5 iterations,  then  the
DATA-PATTERN-MESSAGE-TEST for 3 iterations, then print overall totals.
This would be repeated for 10 passes.  The RUN command is used to  run
utilities.  For help with the RUN command, enter HELP RUN.

*TOTALS

The "TOTALS" utility  is functionally  equivilent to  the SHOW  TOTALS
command.  It is used in a list of tests to print occasional summaries.
For example,

	NIB>RUN /PASSES:10 LOOP/ITER:5,DATA/ITER:3,TOTALS

This would  run  the  LOOP-ASSIST-TEST  for  5  iterations,  then  the
DATA-PATTERN-MESSAGE-TEST for 3 iterations,  then print totals  broken
down by node.  This would be repeated for 10 passes.  The RUN  command
is used to run utilities.  For  help with the RUN command, enter  HELP
RUN.

*SHORT-PACKETS

The "Short-Packets" script sets the  message length to 64. bytes,  the
data pattern to  CCITT and then  runs ALL-TESTS.  The  RUN command  is
used to run utilities.  For help with the RUN command, enter HELP RUN.

!Commands
*CLEAR

The "CLEAR" command is used  to reset program variables and  switches.
Additional help is available by entering HELP CLEAR, followed by:

 NODE-TABLE    SWITCH    TOTALS

*CLEAR NODE-TABLE

"CLEAR NODE-TABLE" clears the table of nodes to be tested.  Nodes  are
selected for test by using the SELECT NODE command.

*CLEAR SWITCH

"CLEAR SWITCH swit,swit" clears one or more of the following switches:

	HALT  - Print error then stop
	DING  - Ring bell on error
	ITXT  - Inhibit the comment part of the error message
	PALL  - Print all errors
	TRACE - Trace program

The SET SWITCH command is used to set the switches.

*CLEAR TOTALS

"CLEAR TOTALS" zeroes the statistic totals for the runs so far.   SHOW
TOTALS displays the totals.

*DESELECT

The "DESELECT NODE"  command is used  to remove a  selected node  from
further testing.  Nodes are selected by using the SELECT NODE command.

*DISABLE

The "DISABLE" command is the complement of the DISABLE command.

"DISABLE LOGGING" turns off logging  of diagnostic output into a  file
called DFNIB.LOG in  your default directory.   When the diagnostic  is
started SPEAR reporting is off.

"DISABLE SPEAR-REPORTING" is used to start reporting to SPEAR of  test
results.  When the diagnostic is started SPEAR reporting is off.

*ENABLE

The "ENABLE" command is the complement of the DISABLE command.

"ENABLE LOGGING  logfile" turns  on  logging of  the output  from  the
diagnostic into a  file.  If you  don't specify a  file, DFNIB.LOG  in
your default  directory  is  used.  When  the  diagnostic  is  started
logging is off.

"ENABLE SPEAR-REPORTING" is used to inhibit reporting to SPEAR of test
results.  When the diagnostic is started SPEAR reporting is off.

*HELP

The "HELP" command  followed by  question mark (?)   will provide  the
user with a  list of the  entries in the  diagnostic help file.   HELP
followed by  the subject  will  provide the  user  with a  short  help
message on the selected subject.  HELP with no subject specified  will
provide the user with a help message on using the "HELP" command.

*IDENTIFY

The "IDENTIFY" command will cause a  request id message to be sent  to
the node address supplied as part of the command. Any resulting system
id message will be displayed.

WARNING: Not all NI  nodes support the  request id protocol.  Failures
therefore will require  verifying the NI  maintenance features of  the
node.

*RUN

The "RUN" command is used to start the execution of a test or group of
tests.  The format of the RUN command is:

	RUN /PASSES:n test/ITERATIONS:n , test/ITERATIONS:n

The optional /PASSES switch must be specifed before any test name, and
sepcifies how many passes of the  test to run.  The default number  of
passes if /PASSES isn't specified is 1.

A test name,  test script,  or utility  name come  next, seperated  by
commas.  Each  test  may  be  execute a  number  of  times  using  the
optional /ITERATIONS switch.

A RUN command with no arguments is used to rerun the last successfully
entered RUN command.  The tests are  stored in the "run table",  which
can be displayed using the SHOW RUN-TABLE command.

An example run command would be

NIB>RUN /PASSES:100 BASIC/ITER:100, NODE/ITER:5, OVERALL-TOTALS

This would  run 100  passes,  where each  pass  would consist  of  100
iternations of  the  Basic Message  Test,  5 iterations  of  the  Node
Communication Test, followed  by one iteration  of the Overall  Totals
utility.

During the test run, the following characters may be typed:

	D	to display current totals, pass count, and test
	H	for run time help
	S	synonym for "D" to display run time status
	escape	to abort testing

More information is available on the tests, enter HELP followed by

 All-Tests		     Basic-Message-Test
 Data-Pattern-Message-Test   Loop-Assist-Test
 Message-Activity-Test	     Node-Communication-Test

More information is available on test scripts, enter HELP followed by

 DEFAULT	QUICK-VERIFY	QV

More information is available on the utilities, enter HELP followed by:

 OVERALL-TOTALS   TOTALS	  U1		    U2

*SELECT

The "SELECT  PORT n"  command is  used to  select NIA20  port "n"  for
running tests.  The SHOW SELECTED-PORT command is used to display this
information.

The "SELECT NODE address" command is used to select/deselect nodes for
testing.   The  hexidecimal  address(s)  of  the  nodes  must   follow
separated by a comma.   There are two formats  allowed for typing  the
address field:  12 hex  digits (e.g.  "123456789012") and  six  fields
separated by minus signs (e.g. AA-00-03-00-01-01).

Example: SELECT NODE 12-34-56-78-90-AB,AACDEFABCDEF

Multicast addresses are not  allowed.  The assigned multicast  address
for Digital is  CF0000000000.  A  multicast is address  is an  address
where the second digit  is odd.  Examples  of multicast addresses  are
010000000000 and ABCDEFEDCBAB.   Examples of  non multicast  addresses
are 000000000000 and AA-00-04-00-98-1C.

The SHOW  CONFIGURATION command  will display  the currently  selected
nodes.

*SET

The "SET" command is used to set various program parameters.  For more
information, enter HELP SET followed by one of:

 DATA-PATTERN		  ERROR-REPORT-THRESHOLD    MESSAGE-LENGTH
 SPEAR-REPORT-THRESHOLD	  SWITCH

*SET DATA-PATTERN

"SET DATA-PATTERN" sets the data pattern to any of the following:

Pattern Name         Pattern Description

ALPHANUMERIC		!"#$%&'()*+,-./0123456789:;<=>?\abc etc.
ONES			Message of all 1s (111111111111111.....)
ZEROS			Message of all 0s (000000000000000.....)
1ALT			Message of alternating 1s and 0s (1010101010..)
0ALT			Message of alternating 0s and 1s (0101010101..)
CCITT			CCITT pusedo-random test pattern
EVERY			All of the above patterns.
OPERATOR-SELECTED	The operator choses the data pattern using ASCII
			A-Z, 0-9, spaces.

*SET ERROR-REPORT-THRESHOLD

The "SET ERROR-REPORT-THRESHOLD"  command is used  to set the  maximum
number of entries to be  made to the log  if logging is enabled.   The
number of entries set is any number between 1 and 100. The default  is
10.

*SET MESSAGE-LENGTH

"SET MESSAGE-LENGTH" allows the selection of a fixed or random message
length.  The "SET MESSAGE-LENGTH FIXED n" command sets the message  to
the number  n which  must be  between  1 and  1486. bytes.   The  "SET
MESSAGE-LENGTH RANDOM" command  sets the  message to  a random  number
which is changed on each iteration of a test.

The largest amount of data that can be sent via a loop direct function
is 1486 bytes.  For a transmit assist or receive assist loop  assisted
function the maximum data byte size is 1478 bytes.  For a full  assist
loop assisted function the maximum data  byte size is 1470 bytes.  The
diagnostic will adjust  automatically to  these maximums  if a  larger
message length has been selected.

The current message length may be displayed by the SHOW MESSAGE-LENGTH
command.

*SET SPEAR-REPORT-THRESHOLD

The "SET SPEAR-REPORT-THRESHOLD"  command is used  to set the  maximum
number of entries  to be made  to the  SPEAR log if  SPEAR logging  is
enabled. The number of  entries set is any  number between 1 and  100.
The default is 10.

*SET SWITCH

The "SET  SWITCH" command  is used  to set  the program  switches.   A
number of  switch names  to set  can follow  the command.   The  CLEAR
SWITCH command is used to clear the set switches.  Switch summary:

	HALT  - Print error then stop
	DING  - Ring bell on error
	ITXT  - Inhibit the comment part of the error message
	PALL  - Print all errors
	TRACE - Trace program

*SHOW

The "SHOW"  command  is  used to  display  various  configuration  and
statistic information.   For  further  information,  enter  HELP  SHOW
followed by one of:

 ALL			  CONFIGURATION		    DATA-PATTERN
 ERROR-REPORT-THRESHOLD	  LOGGING		    MESSAGE-LENGTH
 OVERALL-TOTALS		  REMOTE-NODES-ON-NET	    RUN-TABLE
 SELECTED-PORT		  SPEAR-REPORTING	    SWITCHES
 TOTALS
	
*SHOW ALL

"SHOW ALL" will show selected  data pattern, message length,  logging,
spear reporting,  error  report threshold,  switches,  known  Ethernet
nodes, current node configuration  for testing, statistic totals,  and
the contents of the run table.

*SHOW CONFIGURATION

"SHOW CONFIGURATION"  displays all  nodes  in the  node  configuration
table as well as the nodes selected for test.  Nodes are selected  for
test by using the SELECT NODE command.

*SHOW DATA-PATTERN

"SHOW DATA-PATTERN"  shows  the  current  selected  data  pattern  for
testing.  The data pattern is  set with the SET DATA-PATTERN  command.
The data patterns are:

Pattern Name			Pattern Description

ALPHANUMERIC		!"#$%&'()*+,-./0123456789:;<=>?\abc etc.
ONES			Message of all 1s (111111111111111.....)
ZEROS			Message of all 0s (000000000000000.....)
1ALT			Message of alternating 1s and 0s (1010101010..)
0ALT			Message of alternating 0s and 1s (0101010101..)
CCITT			CCITT pusedo-random test pattern
EVERY			All of the above patterns.
OPERATOR-SELECTED	The operator choses the data pattern using ASCII
			A-Z, 0-9, spaces.

*SHOW ERROR-REPORT-THRESHOLD

"SHOW ERROR-REPORT-THRESHOLD" is  used to show  the maximum number  of
entries to  be  made to  the  log if  loggging  is enabled.   The  SET
ERROR-REPORT-THRESHOLD command  is used  to change  this value,  which
defaults to 10.

*SHOW LOGGING

"SHOW LOGGING" displays the terminal output logging flag.  The  ENABLE
LOGGING and DISABLE LOGGING commands are used to control this feature.

*SHOW MESSAGE-LENGTH

"SHOW MESSAGE-LENGTH" is used to show the length of messages that will
be sent for testing.  The SET MESSAGE-LENGTH command is used to change
the message length.

*SHOW OVERALL-TOTALS

"SHOW OVERALL-TOTALS"  displays the  statistics for  this run  of  the
program.  The  following counters  are displayed:  bytes  transmitted,
bytes received, messages transmitted,  messages received, messages  in
error, bytes in  error, messages  lost (timed  out), transmit  failed,
channel communication  errors, messages  aborted, and  message  length
errors.  If a particular counter is zero it is not displayed.

*SHOW REMOTE-NODES-ON-NET

The  "SHOW  REMOTE-NODES-ON-NET"  command  causes  a  message  to   be
broadcast to  address CF-00-00-00-00-00,  which should  result in  all
nodes on the Ethernet to respond with their node address.  Because  of
a restriction in  TOPS-20 only  three of the  responding remote  nodes
will be displayed.

*SHOW RUN-TABLE

"SHOW RUN-TABLE" displays the contents of the run table.  The contents
of the  run table  are modified  when a  RUN command  is entered  that
specifies a test that is  to be run.  A  blank RUN command causes  the
tests in the run table to be rerun.

*SHOW SELECTED-PORT

"SHOW SELECTED-PORT" displays which NIA port is selected to be tested.
The port is selected with the SELECT PORT command.  This command  also
shows the selected NIA20's hardware address and physical address.  The
physical address is the one that is used for traffic.

*SHOW SPEAR-REPORTING

"SHOW SPEAR-REPORTING" is  used to  tell if the  program is  reporting
test  results  to  SPEAR.   The  ENABLE  SPEAR-REPORTING  and  DISABLE
SPEAR-REPORTING commands cotnrol  this feature.   The SPEAR  reporting
threshold  is   also   displayed   with   this   command.    The   SET
SPEAR-REPORT-THRESHOLD command controls this feature.

*SHOW SWITCHES

"SHOW SWITCHES" is  used to  display the program  switches.  For  more
information on switches, see the SET SWITCH and CLEAR SWITCH commands.

*SHOW TOTALS

"SHOW TOTALS" displays the statistics  kept on a per-node basis,  such
as total reads, writes, and errors.   If a particular counter is  zero
it is  not displayed.   The  CLEAR TOTALS  command clears  all  totals
accumulated so  far.   The SHOW  TOTALS  command displays  all  totals
accumulated so far.

*TAKE

The "TAKE" command takes commands from a file. The filename can either
be typed in or will default  to DFNIB.CMD.  The user can create  files
with their favorite  editor that  contains commands. As  an example  a
file named XYX.ABC exists that contains:

CLEAR TOTALS
CLEAR NOD
SELECT NODE 1234567890AB
SELECT N AACDEFABCDEF
SET DA CCITT

By  typing  "TAKE  XYX.ABC"  will:   clear  totals,  clear  the   node
configuration table, select  nodes 1234567890AB  and AACDEFABCDEF  and
sets the selected data pattern to CCITT.

*TRANSLATE

The "TRANSLATE"  command  is used  to  translate an  Ethernet  address
expressed a three  16 bit  PDP-11/Pluto words  into hexadecimal.   The
three octal numbers are given after the translate command seperated by
spaces (e.g. "TRANS 12675 10 33").

*QUIT

The "QUIT" command is the proper command to terminate testing with the
diagnostic. It will return the user  to monitor level.  All files  are
closed.  The user may reenter the diagnostic with the START command.

!End of DFNIB.HLP