Ref: 99980035
Title: Release Notes: CS/1 booting from diskette Ver 21000
Date: 7/1/87

Copyright 3Com Corporation, 1991.  All rights reserved.

Software Release

SW/1-TR Version 21000

July 1, 1987

Part Number: 86-0114-00
Revision 00


TO:          CS/1-TR Users

FROM:        Bridge Communications, Inc.

SUBJECT:     SW/1-TR Version 21000

DATE:        July 1, 1987

Enclosed is the SW/1-TR Version 21000 diskette.  This diskette is
your distribution copy of SW/1-TR Version 21000 and should be
used only to create a backup copy of the system software.

SW/1-TR is the software for the CS/1-TR, which is a CS/1 equipped
with a Token Ring Controller/Multibus (TRC/M) board.  This
release memo describes the procedure for backing up the
distribution diskette, the features, and the known problems of
SW/1-TR Version 21000.

Software Backup

Follow these steps to make a backup copy of SW/1-TR Version
21000:

1.  Connect your terminal to the console port of the CS/1-TR.

2.  Press the Reset switch.

3.  Make a backup copy of the distribution diskette using the
following command: > co <n> <CR> where n is the number of
copies to be made.

4.  The following message appears on the screen: insert master
and hit return key Insert the SW/1-TR Version 21000
diskette in the disk drive.  After you press the return
key, the following messages appear on the screen if the
read completes successfully: reading ...  OK insert copy #n
and hit return key If the message "read error" appears
instead of the message "OK", contact an authorized Bridge
service representative for assistance.

5.  Remove the SW/1-TR Version 21000 diskette from the disk
drive. Insert a blank, 48 TPI, double-sided, double-density
diskette in the disk drive, then press the return key.

6.  If the copy completes successfully, the following messages
appear on the screen: formatting ... writing ... verifying
... OK copy completed Remove the diskette from the disk
drive, and label it "SW/1-TR Version 21000". Store the
distribution diskette in a safe place.



Compatibility

SW/1-TR Version 21000 can operate with TokenTerm Version 14000 or
later.

Table 1 illustrates the software and firmware compatibility for
SW/1-TR Version 21000.

''
__________________________________________________________
|         Table 1  Software/Firmware Compatibility        |
|_________________________________________________________|
| Product|  Software|               Firmware              |
|        |          |                                     |
|________|__________|_____________________________________|
|        |          |             |            |          |
| CS/1-TR|  SW/1-TR |  SIODL 14 or|  M1MMON 01K|  No PROMs|
|        |          |  later      |  or later  |          |
|        |          |  M0ASYN 15A |            |          |
|        |          |  or later   |            |          |
|________|__________|_____________|____________|__________|
If there are more than two SIO-16 boards in the CS/1-TR, the MCPU
board must be upgraded to 12 MHz.  If there are one or two SIO-16
boards, a 10 MHz MCPU board can be used.

Features

In addition to all the features of SW/1-A/BSC/SDLC Version 20060,
the  following  features have been implemented in SW/1-TR Version
21000:

1.  The SHow Version command displays  more  information  about
the  SIO-16  boards in the CS/1-TR and about the Token Ring
controller.  The following is  an  example  of  the  screen
display generated by the SHow Version command: PROMS:  MCPU
- M2 MMON rev. 01L
TR   - No Proms (TRC/M)         SIO1 - M0 ASYN rev.
17D          SIO2  - SIO16, sw ver. 11030         SIO3 - M0
ASYN rev. 17B         SIO4 - M0 ASYN rev. 17D

2.  The SHow STatistics command recognizes that  a  Token  Ring
controller  is  present,  and  gives  data  link statistics
relevant to the Token Ring.

3.  If the UseDTRin parameter is set to AsDTR and the UseDCDout
parameter  is set to OnConnect, the SIO-16 ports will enter
Command mode only when DTR is active.



In  addition,  if  a  port  is  in  Listen  mode,  it  will
immediately  return to Command mode after toggling DCD.  If
the UseDTR parameter is set  to  AsDTR  and  the  UseDCDout
parameter is set to AlwaysAssert, the port will change from
Listen mode to Command mode only on  the  first  data  byte
after  the  DTR  circuit becomes active.  In both cases, if
DTR drops, the session will be discontinued.

4.  When you  use  the  SET  command  to  change  the  EchoMask
parameter,  Command  mode  may  be  affected.   You can now
return Command mode to normal by resuming the session,  and
then entering the ECM character.

For example, if you want control characters to  be  echoed,
you should set the EchoMask parameter as follows: set echom
= co After this SET command has taken effect, the backspace
key may not work properly in Command mode.  To correct this
problem, type "res", and then enter the ECM character.  The
backspace key then works properly.

5.  Data General terminals are now supported on  SIO-16  ports.
A  new  option,  DataGeneral,  has been added to the DeVice
parameter.  Devices are now classified as Host or Terminal,
Paper  or  Glass, and Default or DataGeneral.  Data General
terminals are not  supported  on  SIO-8  boards;  they  are
supported  on  SIO-16  boards.   Data General hosts are not
supported on SIO-16 boards; they  are  supported  on  SIO-8
boards.    The  software  will  not  provide  warnings  for
incorrect hardware configuration.
The DataGeneral option puts the terminal in Data General mode, in
which both the Bridge User Interface and the Serial I/O module's
operations are altered. The DeVice parameter will control the
default parameter settings for the Data General environment.
Whenever it is set, the Bridge User Interface will configure the
port for a set of default Data General parameters.  Therefore,
you should set the DeVice parameter before you alter other
parameters.

Standard default parameters are not restored when DeVice is set
to Default.  The default parameter settings are made only when
the DeVice parameter is changed by the SETDefault command.
The parameter settings after the DeVice parameter is set to
DataGeneral Terminal are shown in Table 2.''


___________________________________________________
| Table 2  Data General Terminal Parameter Settings|
|__________________________________________________|
|                                                  |
| Parameter         Setting                        |
|                                                  |
| BreakAction       OutofBand                      |
| BreakChar         Disabled                       |
| DeVice            (Terminal, Glass, DataGeneral) |
| ECMChar           ^\                             |
| ERAse             ^?                             |
| FlowControlFrom   (None)                         |
| FlowControlTo     (XonXoff)                      |
| IdleTimer         1                              |
| LineErase         ^U                             |
| ReprintLine       ^A                             |
| UseDTRin          Ignore                         |
| UseDCDout         (AlwaysAssert, NoToggle)       |
| Verbatim          ^P                             |
| WordErase         ^B                             |
| XOFF              ^S                             |
| XON               ^Q                             |
|__________________________________________________|
Table 3 shows the parameter settings when DeVice is set to
DataGeneral Host. ''
______________________________________________
|                                             |
| Table 3 Data General Host Parameter Settings|
|_____________________________________________|
| Parameter         Setting                   |
|                                             |
| DeVice            (Host, Glass, DataGeneral)|
| FlowControlFrom   (CTSRTS)                  |
| FlowControlTo     (None)                    |
| IdleTimer         1                         |
| UseDTRin          AsDTR                     |
| UseDCDout         (OnConnect, NoToggle)     |
|_____________________________________________|
The new features specific to Data General terminals become
effective when you set DeVice to DataGeneral, and they are
supported on SIO-16 boards only.  These features are described
below:

1. For the terminal interface, Data General ^S/^Q will be used.
The ^S/^Q flow control method is used to control data going from
the host to the terminal.  The ^S and ^Q characters, which are
the flow control characters, can be embedded in terminal
responses.  As a result, the CS/1-TR and the host have to
determine, based on the context of the data stream, whether or
not the ^Q and ^S characters are XON/XOFF.



SW/1-TR supports Data General context sensitive ^S/^Q, which is
in force when DeVice is DataGeneral and FlowControlFrom is
XONXOFF, so that the flow control operates properly.

2. A link-level escape character, which is the ^P character, is
implemented to allow a Data General terminal to deliver the flow
control characters to a Data General host over the network on
which back-to-back servers are used.

Any character following ^P will be delivered to the network as
data.  A ^P not preceded by another ^P will be removed from the
data stream by the Communications Server.  Any ^ that follows ^P
will take precedence over the ^P deletion algorithm. Note that ^P
deletion is performed only when FlowControlFrom is ^Q and DeVice
is DataGeneral.

If you set the Verbatim character to ^P, you must supply spare
^Ps to allow the Bridge User Interface to complete its
transparency operation.  For instance, to send ^Q to the Bridge
User Interface, you must type ^P^P^P^Q.

3. You may need to pass a ^Q forward to the application program
despite the fact that ^S/^Q flow control is in effect.  The
CS/1-TR can perform spare ^Q forwarding when it is in Data
General mode and FlowControlFrom is XON/XOFF, so that the ^Q can
be forwarded properly.

All ^S characters not preceded by ^^, ^, or ^P will be removed
from the data stream and will begin flow control of data from the
server.  The first ^Q character received after any number of ^S
characters will be removed from the data stream.  This will cause
the pending flow control condition to stop.

If a ^Q is not preceded by ^^, ^, or ^P, and is not the first ^Q
character received after a ^S character, it will be forwarded as
data.
If you are in a Data General environment, the BreakChar
parameter must be set to Disabled.  Otherwise, it may cause
problems with flow control operations.  Also, if the
terminal's parity and the server's parity do not match,
line editing may not work properly.

6.  LF is now treated as a command delimiter for the Bridge
User Interface.  Therefore, both CR and LF will be
recognized as the end of the command line.

7.  The BAud parameter now includes an option called AutobaudLF
to allow autobaud on the LF character.  All baud rates that
can be set on the CS/1-TR from 75 bps to 19.2 Kbps may be
detected.  This feature is supported on SIO-boards only.



8.  Data is usually folded modulo 128 for control character
detection.  However, on some eight-bit extended ASCII
terminals, control characters such as XON and XOFF have
unique representations within the 256-character repertoire.
They should not be folded before being sent to the User
Interface or being recognized by the SIO processor.

You can override the data folding by setting PARIty to a
new option called DoNotFold.  You can select this option in
conjunction with None, Even, or Odd parity.  For example,
you can type: setd PARIty = Even DoNotFold



Because of this new option, it is now possible to use
eight-bit control characters with or without parity.  The
DoNotFold option, however, should be used only when the
DataBits parameter is set to 8.  To reset the special
PARIty option, type: setd PARIty = 0 When the DoNotFold
option is set, the control characters sent over the network
from the CS/1-TR are taken to be eight bits long.  Only a
single character is recognized as ECM, BREAK, XON, XOFF, or
EDIT.

For example, with the DoNotFold option, the character
encoded as 00010001 will be recognized as XON, and the
character encoded as 10010001 will be passed as data.
Without the DoNotFold option, both bit patterns will be
interpreted as an XON character, because the uppermost bit
is ignored.

This feature is supported on SIO-16 boards only.

Known Problems

The following is a list of current problems in SW/1-TR Version
21000:

1.  If the FlowControlTo and FlowControlFrom parameters are
both set to None, resetting one of the parameters to
XonXoff or ENQACK causes the other to be automatically set
to XonXoff or ENQACK. Note that this problem does not occur
for the other two options (None and CTSRTS).

2.  Due to a memory limitation, the SHow CONFiguration and SHow
MACro commands do not display output in alphabetical order.

3.  On the SIO-16's ports, the help menu of the BAud parameter
displays LowAutoBaud and HiAutoBaud as options of this
parameter.  However, the SIO-16 supports only single-range
autobaud.  Whether you set the BAud parameter to HiAutoBaud
or LowAutoBaud will not affect the baud rate, which will
range from 50 to 38.4K to match the terminal's baud rate.

4.  There are no Clear to Send (CTS) and Request to Send (RTS)
lines for the SIO-16.  However, on the SIO-16's ports, the
help menu of the FlowControlTo and FlowControlFrom
parameters displays CTSRTS as an option of these
parameters.

Procedure to Sysgen SW/1-TR Version 21000

For information on the Sysgen program, menu displays, and
parameters, refer to the Configuration Guide.  System generation



is not required before installing the software.  It is used to
alter the values of certain parameters.  Bridge does not
recommend altering those values by sysgen without a specific
need.



Documentation

The current versions of the manuals for the CS/1 are listed
below:

+ Series/1 Installation Guide (11/86)
.br;(Part number: 09-0022-05)

+ Connection Service User's Guide (8/86)
.br;(Part number: 09-0063-01)

+ Connection Service User's Quick Reference Guide (12/85)
.br;(Part number: 09-0062-00)

+ Network Management Guide (1/87)
.br;(Part number: 09-0067-01)

+ Configuration Guide (1/87)
.br;(Part number: 09-0093-00)

+ Getting Started Guide (1/87)
.br;(Part number: 09-0043-01)

If you have any questions, contact an authorized Bridge service
representative for assistance.




