Ref: 99980010
Title: Asynchronous and 3270 Server Configuration Parameters
Date: 8/1/86

Copyright 3Com Corporation, 1991.  All rights reserved.

The following is a list of all asynchronous and 3270 port
parameters.  Uppercase characters represent the minimum
unambiguous abbreviation of each parameter.  This option is
supported on all ports of a CS/1 with asynchronous or 3270
interface, CS/100 with asynchronous interface, and CS/200.  For
ports on TCP servers, all of the parameters apply except those
indicated.

.h1;Asynchronous and 3270 Port

This section describes the asynchronous and 3270 port
transmission parameters, usually set by the network manager for
each port.  The parameters and their permitted values are listed
below.

Descriptions of all parameters and parameter values follow the
table.  If the indicated default value is the value desired, the
parameter need not be set.

     ASYNCHRONOUS AND 3270 PORT TRANSMISSION PARAMETERS

Parameter                    Permitted Value

AccessGroup*    NoGroup|AllGroups| (1, 2, 3, 4, 5, 6, 7, 8, 9,
                10, 11, 12, 13, 14, 15, 16)
AccessWord*     NoGroup|AllGroups|(1, 2, 3, 4, 5, 6, 7, 8, 9, 10,
                11, 12, 13, 14, 15, 16)
AUToDisconnet   Disabled|<number>(1-16000 minutes)
AUtoLogoff      [OFF|ON]
BUffersize      <number> (1-512 bytes)
DeVice          (Host|Terminal,
                Paper|Glass)
InitMacro**     <string>(macro name)
InterAction     (Brief|Verbose,
                Echo|NoEcho,
                MacroEcho|NoMacroEcho,
                BroadcastON|BroadcastOFF,
                LFinsert|NoLFinset
                MacroBreak*|NoMacroBreak*)
MaxSessions     <number> (1-8 sessions)
Permanent VC*   ""|"<address>"
PRIvilege***    User|LocalNM|GlobalNM
       *  Not available on TCP servers.
      **  Can be set only with SETDefault, not SET.
     ***  Can be set only with SET, not SETDefault.

The AccessGroup and AccessWord parameters together determine
which ports can make conncections to which ports. When a
connection is requested, the system compares the AccessWord of
the requesting port with the AccessGroup of the destination port.
If at least one common number appears in both sets, the
connection is established.

If no common group numbers appear, the system prompts the user
for a password associated with the AccessGroup parameter for the
destination port.  If the AccessGroup has more than one value,
the password for any one of the values is accepted.  Each of the
two parameters can have the value NoGroup, AllGroups, or one or
more numbers from 1 to 16.  The default value for both
parameters is 1.

Bridge recommends setting AccessWord to NoGroup for any port to
which a dial-in modem is attached.  This requires entry of the
appropriate password before the user calling in can establish a
connection through that modem.

The AccessGroup and AccessWord parameters are not available on
TCP servers.

The AUToDisconnect parameter specifies an interval after which
the current sess.tion is disconnected if no activity occurs.  The
AUToDisconnect interval can be set to disabled or to a number in
the range 1 to 16000 (in minutes).  Setting a value other than
Disabled is appropriate only for host ports.  The default value
is 60 minutes for host ports and Disabled for terminal ports.

The AUtoLogoff parameter determines whether or not the string
defined by the LogoffStr parameter is transmitted to the
destination of a connection when the connectionis broken by the
DisConnect command or by the expiration of the AUToDisconnect
interval.  The string is not transmitted if the disconnection is
the result of a Listen command or if traffic to the destination
port is flow controlled and the logoff string cannot be
transmitted within six seconds.  Setting this parameter to ON is
appropriate only for host ports, because the logoff string
usually consists of a logoff command, which causes the host to
close the port in an efficient manner.

The BUffersize parameter specifies the size of the data buffer in
bytes.  It can be set to a value in the range 1 to 512.  The data
buffer accumulates data until the buffer becomes full, or until
the interval specified by the IdleTimer parameter elapses; then
the data is packetized and forwarded.  Depending on the value of
the DataForward parameter, data may also be forwarded when a data-
forwarding character is entered.  The default buffer size is 82,
unless it have been modified during the system generation
procedure.  Normally, a CS/1 with an asynchronous or 3270
interface can have up to four ports whose BUffersize is set to
512; the BUffersize for the remaining ports must not exceed 82
for each port.  A CS/100 with an asynchronous interface can have
up to two ports whose BUffersize is set to 512; the BUffersize
for the remaining ports must not exceed 82 for each port.  A CS/
200 can have up to 10 ports whose BUffersize is set to 512.
Setting this parameter to a smaller value than the server's
buffer size may be useful for PC-to-host file transfer
application.

The DeVice parameter specifies the local device type.  One of two
primary values can be specified:

.br;Host|Terminal

.br;Specifies whether the device is a host or a terminal

Setting DeVice to Host automatically resets the following
parameters: BReakAction is set to Ignore, AUToDisconnect is set
to 60, and ECMChar and BReakChar are disabled.  The InterAction
parameter is set to Verbose and Echo; BUffersize is set to the
buffer size specified at the time of system generation.

Setting DeVice to Terminal automatically resets the following
parameters: BReakAction is set to EscDTM and InterAction is set
to Verbose and Echo.  BUffersize is set to the buffer size
specified at the time of system generation.

On a CS/1 with an asynchronous, 3270, bisynchronous, or bit-
synchronous interface, the default DeVice parameter values are
Host for ports 0 through 3 of each SIO board and Terminal and
Glass for ports 4 through 7 of each SIO board.  On the CS/100
with an asynchronous or bisynchronous interface, the default
values are Terminal and Glass for ports 0 through 7, and Host for
ports 8 through 13.  On the CS/200, the default values are
Terminal and Glass for odd-numbered ports, and Host for even-
numbered ports.

If DeVice is set to Terminal, one of the following secondary
characteristics can also be specified:

.br;Paper|Glass

Determines whether the terminal is a video display unit (Glass,
the default) or a hardcopy printer (Paper).  The setting affects
how backspacing is handled during local editing, for instance,
when the user erases a character or a word using the backspace
key or the local editing characters.  If DeVice is set to Glass,
the server moves the terminal cursor to the left one column for
each character erased.  If DeVice is set to Paper, the server
prints a crosshatch symbol (#) for each character erased instead
for attempting to move the print mechanism.

The InitMacro parameter specifies the name of a port
initialization macro to be executed automatically each time the
device makes a transition from Listening mode to Command mode.
The macro itself is defined with the DEFine command.

                       ** NOTE **

This parameter cannot be used to establish a system
initialization macro; a system initialization macro can be
established only by defining a macro whose name begins with the
letter "init".

The InterAction parameter describes the interaction between the
local device and the server.  This parameter has not effect on a
host port.  The possible values are:

.br;Verbose|Brief

Determines whether responses or error messages from the server to
the local device are sent in their short form (Brief) or full-
lenth form (Verbose, the default).  Brief responses are "OK" if
the requested action is successful, and "Err <n>" if an error is
encountered. (See "Connection Service Error Messages".)  This
pair of values also determine whether broadcast messages are
preceded by a header indicating the port number of the sender of
the message.  The value Brief is appropriate for a host or a
terminal emulator program; Verbose is appropriate for a terminal.

.br;Echo|NoEcho

Determines whether input from the local device, while the device
is in Command mode, is echoed back to the device.  The default is
Echo.

.br;MacroEcho|NoMacroEcho

Determines whether or not macros are echoed on the screen as they
are executed.  The default is MacroEcho.

.br;Broadcast ON|Broadcast OFF

Determines whether or not the port receives messages sent with
the Broadcase command when the port is in Command or Data
Transfer modes.  The default is Broadcast ON.

.br;LFinsert|NoLFinsert

Determines whether or not the server echoes a return and a
linefeed when the user enters a command.  This option is usefule
for terminals that perform local echo but do not generate a
linefeed echo when a return is entered.  The default is
NoLFinsert.

.br;MacroBreak|NoMacroBreak

Determines whether the <BREAK> key can be used to stop execution
of a macro.  In macros that raise the privilege to Local or
Global Network Manager, setting NoMacroBreak prevents the user
from breaking out of the macro and, as a results, being left in
network manager privilege level.  The default is MacroBreak.  The
MacroBreak/NoMacroBreak option is not available on TCP servers.

The MaxSessions parameter specifies the maximum number of open
sessions permitted on a single port.  The parameter can be set to
a number in the range 1 to 8.  The default value is 2.

The Permanent VC parameter specifies a permanent virtual circuit
from the current or specified port to the specified address or
clearinghouse name.  The default is the null string, which
indicates no permanent virtual circuit.  This parameter is
available on host ports only; however, the destination end of the
circuit may be a terminal or host port.  PermanentVC may be
defined on both ends of the circuit.

To disable an existing permanent virtual circuit, set the
parameter equal to the null string.  This removes the definition,
but does not disconnect any existing connection.

.br;The Permanent VC parameter is not available on TCP servers.

The PRIvilege parameter specifies the privilege level of the
local device.  This parameter affects all sessions, not just the
current or next session.  Privilege is not affected if a new
configuration table obtained via the ReaD command contains a
different privilege level.  The default value is User. The
PRIvilege parameter is the only parameter whose default value
cannot be changed with the SETDefault command.

.br;Three privilege levers are available:

.br;User

Specifies User privilege level.  User privilege permits the user
to display or set characteristics for the local device port.

.br;LocalNM

SPecifies Local Network Manager privilege level.  This level
permits the user to set characteristics and control the status of
any port on the local server and to define the setup of the local
server.

.br;GlobalNM

Represents Global Network Manager privilege level.  This
privilege level permits the user to set characteristics and
control the status of any port on the network and to define the
setup of either the local or a remote server.

.h1;Asynchronous Physical Parameters

This section describes the asynchronous port physical parameters,
which are usually set by the network manager for all ports.  The
parameters and their possible values are summarized in the
following table.

Physical parameters do not apply to Communications Server ports
on an SIO-3270 interface.

           ASYNCHRONOUS PORT PHYSICAL PARAMETERS

Parameter          Permitted Values
-----------
BAud            AutoBaud | Low_AutoBaud | Hi_AutoBaud | 50 |75
                | 110 | 134.5 | 150 | 200 | 300 | 600 | 1200 |
                1800 | 2400 | 3600 | 4800 | 7200 | 9600 | 19.2K |
                38.4K*
BSDelay/        None|<number>(1-127 sixtieths of a second)
CRDelay/
FFDelay/
LFDelay/
TabDelay/
BSPad/          None|<number>(1-127 nulls of padding)
CRPad
FFPad/
LFPad/
TabPad
DataBits        5|6|7|8
Duplex          Half|Full
LinePRotocol**  ASynchronous|BYTESynchronous|BITSynchronous
PARIty          None|Odd|Even|1|0|AutoPariy
StopBits        1|1.5|2
UseDCDout**     (AlwaysAsset|OneConnection,
                ToggleonDisc|NoToggle)
UseDTRin**      Ignore | AsDTR | AsDCD

    *   AutoBaud is available on CS/200 only.
        Hi_AutoBaud and Low_AutoBaud are available on
        CS/1 and CS/100 only.  The value 38.4K is
        unavailable on CS/100.

   **   Can be set only with SETDefault, not SET.

The BAus parameter specified the local device baud rate.  The
default for all ports is 9600.  The availability and effect of
AutoBaud, Low_AutoBaud, or Hi_AutoBaud depends on the type of
server:

*  On a CS/1 port on an SIO-16 interface: When the BAud parameter
is set to Low_AutoBaud or Hi_AutoBaud, the SIO-16 automatically
selects the appropriate device baud rate from one of the numberic
values listed in the previous table.

If the SIO-16 sets the baud rate to 300 or higher, a <RETURN>
must be entered immediately after the device is powered on or
reset.  If it sets the baud rate to 200 or lower, the first
sequence typed after the device is powered on or reset must be
<RETURN><RETURN>, with no delay between the keystrokes.

*  On the CS/1 (with all other interface types) and CS/100:  When
the BAud parameter is set to Hi_AutoBaud, the server
automatically selects the appropriate device baud rate of 2400,
4800, 9600.  If the BAud parameter is set to Low_AutoBaud, the
server automatically selects the appropriate device baud rate of
300 or 1200.

If either Hi_AutoBaud or Low_AutoBaud is selected, a <RETURN>
must be the first character enetered after the device is powered
on or reset.

*  On the CS/200: When the BAud parameter is set to AutoBaud, the
server automatically selects the appropriate device baud rate
from one of the numeric values listed in the previous table.

If Autobaud sets the server's baud rate to 300 or higher, a
<RETURN> must be entered immediately after the device is powered
on or reset.  If AutoBaud sets the server's baud rate to 200 or
lower, the first sequence typed after the device is powered on or
reset must be <RETURN><RETURN>, with no delay between the
keystrokes.


The xxDelay parameters specify the length of the delay (in
sixtieths of a second) following the echo or transmission of the
specified character before the server echoes or transmits another
character.  The default value is None (i.e.,no delay).  This
parameter is designed for use with terminals with a moving print-
head mechanism.  The delay allows the mechanism to complete its
motion before subsequent characters are received.

The xxPad parameters specify the number of nulls the server
inserts between the specified character and the next character.
The default value is None (i.e., no nulls inserted).  These
parameters are alternate forms of the xxDelay parameters.

The DataBits parameter specifies the number of databits per byte.
The value can be set to 5,6,7 or 8.  The default is 8 for all
host ports, for one of the terminal ports on the CS/100, and for
one of the terminal ports on each CS/1 SIO board.  With DataBits
set to 8, PARIty should be set to None, Odd, or Even; 0 and 1 are
meaningless.  The default for most terminal ports is 7.

The DUplex parameter specifies whether the local device transmits
and receives in half-duplex mode or full-duplex mode.  The
default value is Full; half-duplex mode is not currently
implemented.

The LinePRotocol parameter specifies the type of line protocol
used by the port.  For ports attached to the asynchronous
interface of a CS/1 or CS/100, any value other than ASynchronous
is illegal.  The server automatically sets the value based on the
SIO firmware present on the board.

The PARIty parameter specifies the local device parity.  The
possible values are None, Odd, Even, 1 (mark), 0 (space), or
AutoParity.

*  On the CS/1 and CS/100, the default value is None for hosts
ports (ports 0 through 3 on each synchronous CS/1 SIO board and
ports 8 and 9 on the CS/100 with an aynchronous interface).

The default value varies for each terminal port.

The value AutoParity is valid only if the BAud parameter is set
to Lo_AutoBaud or Hi_AutoBaud.  If AutoParity is in effect, the
first sequence entered after the device is powered on or reset
must be <RETURN>.<RETURN>.

*  On the CS/200, the default value is Even for ports 0 and 1,
mark for ports 4 and 5, Odd for ports 6 and 7, and None for
ports 2, 3, 8, and 9.  (Ports 0, 2, 4, 6, and 8 are host ports;
ports 1, 3, 5, 7, and 9 are terminal ports.)

The value AutoParity is valid only if the BAud parameter is set
to AutoBaud.  If the baud rate is set to 300 or higher, the first
sequence entered after the device is powered on or reset must be
<RETURN>.<RETURN>.  If the baud rate is set to 200 or lower, the
first sequence entered after the device is powered on or reset
must be <RETURN><RETURN><RETURN>, with no delay between the first
two keystrokes.

The StopBits parameter specifies the number of stopbits per byte.
The value can be set to 1, 1.5, or 2.  The default is 1.

The UseDout paramters specifies how the server supplies the Data
Carrier Detect (DCD) signal to the attached device.  This option
is supported on all ports of a CS/1 with asynchronous interface,
CS/100 with asynchronous interface, CS/200, and IVECS.  Only some
ports on other Communications Server types support, this option.
Refer to the appropriate Installation Guide for mapping between
DCD, DTR, and the EIA connector prins.  One each of two sets of
parameter values can be specified:

.br;AlwaysAssert|OnConnection

.br;Determines when the DCD output signal is asserted.

AlwaysAssert causes the DCD output signal to be asserted at all
times.

OnConnection causes the DCD output signal to be deasserted at all
times as long as no connection is established to the device and
asserted when a connection is made.

.br;ToggleDisc|NoToggle

Determines whether or not the DCD output signal toggles when a
connection is broken.

ToggleonDisc causes the DCD output signal to be deasserted for at
least 65 milliseconds within 150 microseconds after
disconnection.  Depending on the the other UseDCDout parameter
setting, the signal than either remains deasserted or returns to
asserted.  This value is used when the server is connect to
certain data switch devices.

NoToggle suppresses the toggle upon disconnection.  The signal
either stays asserted or changes cleanly to deasserted, depending
on the other UseDCDout parameter setting.

The default value of UseDCDout is AlwaysAssert, NoToggle for all
terminal ports and OnConnection, NoToggle for all host ports.
The interaction between these sets of values is illustrated in
subtitle "Figure-Effect".

The UseDTRin parameter specifies the server's response to the
value of the Data Terminal Read (DTR) input signal received from
the attached device.  This option is supported on all ports of a
CS/1 with asynchronous interface,  CS/100 with asynchronous
interface, CS/200, and IVECS.  Only some ports on other CS/1
types support this option; refer to the appropriate Installation
Guide for mapping between DCD, DTR, and the EIA connector pins.
One of three parameter values can be specified:

.br;Ignore

Specifies that the server does not check the state of the DTR or
DSR input signal when a connection is made and takes no action
when the signal changes value.

This value should never be specified if the FlowControlTo and
FlowControlFrom parameters are set to CTS_RTS.

When the FlowControlFrom/To parameters are set to CTS_RTS, the
SIO firmware uses DTR to enable and disable the SIO receiver; the
UseDTRin parameter must not be set to Ignore or the SIO receiver
is never enabled, and the port appears to hang.  If the
application requires that the DTR signal be ignored, the customer
must build a special cable that holds the DTR signal high.

This value is the default for terminal ports.

.br;AsDTR

Specifies that the server checks the state of the DTR input
signal before establishing a connection to a port.  If the DTR
input is deasserted, the server rejects any connection requests
to the port.  If the DTR input changes from asseted to
deasserted, all connections to the port are terminated and the
port enters Listening mode.  If the device is a terminal and the
input signal changes from deasserted to asserted, a Connection
Service process is started for the port (i.e., the WelcomeString
is transmitted to the terminal and the InitMacro, if any, is
executed).

.br;This value is the default for host ports.

.br;AsDCD

Specifies that the Communications Server does not reject a
connection request to the port based on the value of the DTR
input.  However, if the DTR input changes from asserted to
deasserted, all connections to the port are terminaled and the
port enters Listening mode.  If the device is a terminal and the
input signal is changed form deasserted to asserted, a Connection
Service process is started for the port.

.h1;Asynchronous and 3270 Session Transmission Parameters

The following table lists the session transmission parameters.  A
description of each parameter, an explanation of each possible
value, and an indication of the default follows the table.  If
the default is acceptable, the parameter does not have to be set.

These parameters can be set with either SET or SETDefault unless
otherwise indicated in the table.

Asynch and 3270 Session Transmission Parameters

Parameter           Permitted Values
BReakAction         IGnore|(OutofBand, FlushVC, InBand, EscDTM)
BReakChar           Disables | <char>
DataForward         None|(AlphNum, CR, ESC, EDiting, Term,
                    FormEf, COntrol, Punct)
DIsconnectAction    None|SendLongBreak
ECHOData            OFF|ON
ECHOMask            None|(AlphaNum, CR, ESC< EDiting, Term,
                    FormEf, COntrol, Punct)
ECMChar             Disabled|<char>
EOM                 Disabled|<char>
FlowControlFrom/    None | CTS_RTS | XON_XOFF | ENQ_ACK
FlowControl To*
FlushVC**           OFF | ON
IdleTimer           Disabled | <number> (1-255 sixtieths of a
                    second)
LFInsertion         None | (OutputCrlf, EchoCrlf)
LongBReakAction     Ignore | (Listen, OutofBand, InBand)
MOde                Transparent | Scroll
XOFF*               Disabled | <char>
XON*                Disabled | <char>
* Not applicable to servers with an SIO-3270 interface
** Can be set only with SET, not SETDefault

The BReakAction parameter specifies the action taken by the
server when a break (or the alternative character specified by
the BReakChar parameter) is detected.  THe value IGnore is
mutually exclusive with any other value; more than one the
remaining values can be specified.  The default value is InBand
for terminal ports and IGnore for host ports.  There are five
possible values:

.br;IGnore

.br;Specifies no action.

.br;OutofBand

Specifies that an out-of-band break is transmitted to the remove
device.

.br;FlushVC

Specifies that all packets for this session currently in the
circuit are flushed when a break is detected.

For servers running XNS protocols, this value implements X.3
parameter 7 and operates in conjunction with the FlushVC
parameter (X.3 parameter 8). This value must not be specified
unless the destination host support X.3 parameters 7 and 8 or
equivalent functions.

For servers running TCP protocols, this parameter uses the Telnet
DO TIMING option.  This value must not be specified if the remote
host does not respond to a DO TIMING command.  Either a negative
or a positive response is acceptable, but not response as all
makes the port appear to hang.

Refer to the FlushVC parameter in this section for a description
of how this BReakAction value operations, and to Section 4.2.6
for a discussion of the X.3 parameters.

.br;InBand

Specifies that an in-band break in transmitted to the remote
device (default).

.br;EscDTM

Specificies that the user port will change from Data Transfer
mode to Command mode.

The BReakChar parameter specifies the character that is
interpreted by the server as a break signal.  This parameter is
useful for terminals that do not have a break key.  Since most
terminals have a break key, the default is Disabled.

The DataForward parameter specifies the events that cause data to
be packetized and forwarded in Data Transfer mode.  Some events
are predetermined DataForward conditions; these including the
elapsing of the IdleTimer (if enabled), the End of Message (EOM)
signal, and the ATTN or break signal.  One or more of the events
listed below can also be specified.  The default DataForward
value is None, which is mutually exclusive with any other value.

.br;None

Specifies that data is forwarded if the data buffer (sixe
specified by the BUffersize parameter) becomes full or the
IdleTimer elapses (if set).  This is the default value.

.br;AlphaNum

Specifies that a packet is created and forwarded as soon as any
upper- or lowercase alphabetic character or numberic character is
detected.

.br;CR
Specifies that a packet is created and forwarded as soon as a
return is detected.

.br;ESC

Specifies that a packet is created and forwarded as soon as an
escape (ESC, BEL, ENQ, or ACK) signal is detected.

.br;EDiting

Specifies thta a packet is created and forwarded as soon as ny
editing character is detected.  Alternative editing characters
can be specified.

.br;Term

Specifies that a packet is created and forwarded as soon as any
termnator ETX or EOT signal is detected.

.br;FormEf

Specifies that a packet is created and forwarded as soon as any
"Form Effector" character is detected.  Form Effectors are the
linefeed, tab, and formfeed characters.

COntrol

Specifies that a packet is created and forwarded as soon as any
control character is detected.

.br;Punct

Specifies that a packet is created and forwarded as soon as any
"punctuation" character is detected (includes all the
nonalphanumeric "graphics" characters, i.e., ! @ # $ % ^ & * ( )
_ - + = ~ ` | \ [ ] { } : ; " ' < > , . ? / and space).

The DIsconnect Action parameter specifies the action taken by the
server when a session is disconnected.  This parameter applies
only to hos ports, and only to hosts that distinguish between the
break signal (approximately 150 milliseconds) and the long break
signal (approximately 3 seconds).  There are two possible values:

.br;None

Specifies that no long break is sent on disconnection.

.br;SendLongBreak

Specifies that the server sends a long break to the host when a
session is disconnected.

The ECHOData parameter specifies whether or not the server will
echo input data back to the device while the device is in Data
Transfer mode.  The default value is OFF.

The ECHOMask parameter specifies which characters are echoed if
ECHOData is enabled.  The character classes are the same as those
listed for the DataForward parameter.  If ECHOData is enabled,
then all characters that fit the ECHOMask descriptions are echoes
when typed.  The default ECHOMask values are AlphaNum, CR, Term,
and Punct.

The ECMCHar parameter specifies a character that is interpreted
by the server as a request to change from Data Transfer mode to
Command mode.  The default value is "^^" (representing the
character <CTRL-caret>).
