4.4BSD/usr/src/old/dlmpcc/mpcctab.4

.\" Copyright (c) 1987, 1991 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" This code is derived from software contributed to Berkeley by
.\" Computer Consoles Inc.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. All advertising materials mentioning features or use of this software
.\"    must display the following acknowledgement:
.\"	This product includes software developed by the University of
.\"	California, Berkeley and its contributors.
.\" 4. Neither the name of the University nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"     @(#)mpcctab.4	6.5 (Berkeley) 5/10/91
.\"
.Dd May 10, 1991
.Dt MPCCTAB 4
.Os
.Sh NAME
.Nm mpcctab
.Nd
.Tn MPCC
configuration file
.Sh DESCRIPTION
The
.Tn ASCII
file
.Nm mpcctab
is used to configure
.Tn CCI Ns 's
Multi-Protocol 
Communication Controller
.Pq Tn MPCC . 
The controller provides high-speed
synchronous communications for the
.Tn POWER
family
of computers.
This file determines the
.Tn MPCC
board 
configurations. You can download either a synchronous , bisync or
an asynchronous protocol to an
.Tn MPCC
board.
(See
.Xr dlmpcc 8
for details.)
.Pp
A
.Nm mpcctab
file is supplied
with each
.Tn MPCC
release; however, 
you can modify this file or create your own file.
.Pp
The contents of the file 
consists of entries that describe supported communication 
protocols and their unique attributes. The protocols supported are
.Tn X Ns \&.25 ,
.Tn SNA ,
.Tn ASYNC ,
and
.Tn BISYNC .
For
.Tn ASYNC
two different entries are possible in the 
.Em procol
field - if 16 port
.Tn MPCC
async is configured, then
.Tn ASYNC
is 
entered; 32 port
.Tn MPCC
async is specified by entering
.Pf \&32 Tn PORT .
This file must reside in the directory
.Pa /usr/libdata .
.Sh Entry Line Format
An entry line consists of an
.Em item identifier
followed by 
variable width arguments separated by colons. There are three 
item identifiers:
.Tn MPCC , 
.Tn PROTOCOL ,
.Tn PORT .
The
.Tn MPCC
line in this file
identifies the board number. The
.Tn PROTOCOL
line identifies
the specific communication protocol.
The
.Tn PORT
line describes
the port for the immediately preceding protocol. The number
of arguments for the
.Tn PROTOCOL
and
.Tn PORT
lines,
and the arguments themselves, 
are protocol dependent. See the individual
argument descriptions for details.
.Pp
Notes: Use upper case letters for clarity when specifying the item 
identifier and the protocol name. Make sure that you enter
the argument values in the order specified below. Also, use comments 
liberally, and indicate comment lines by placing a 
pound sign
.Pq Sy #
in column one. 
.Pp
The item identifiers and their corresponding line
formats, with valid argument values, follow:
.Pp
.Sy MPCC Line
.Pp
Format:
.Bd -filled -offset indent
.Sm off
.Xo
.Sy MPCC: Em bdno Sy \&:
.Op Sy FCCS, Em portno , timer
.Sy \&:
.Op Sy SOC , Em portno
.Xc
.Sm on
.Ed
.Pp 
Argument Explanations: 
.Bl -tag -width indent -offset indent
.It Em bdno 
Specifies the board number.
.It Sy FCCS 
.Tn FCCS
is a fault-tolerant support system that allows backup ports
to assume the functions of failed ports.
For example,
if port 0 fails for any reason,
another port may be configured to assume the duties of the failed port.
The keyword
.Sy FCCS
identifies this feature and must be
followed by the list of fail-safe port numbers and a time increment,
described below.
This feature is optional.
.It Sy SOC 
An
.Tn FCCS
port can also be an
.Tn SOC
(Switch On Close) port,
meaning that the port will switch when it is closed.
And as with
.Tn FCCS ,
the port will switch if it fails.
This feature is optional.
.It Em portno 
.Em Portno
is a list of port numbers,
separated by commas,
specifying the primary ports you want protected by backup ports.
.Tn FCCS
boards have either 4 primary and 4 backup ports,
or 8 primary and 8 backup ports.
The valid port numbers are
.Sy 0
through
.Sy 3
for the 4-port version,
and
.Sy 0
through
.Sy 7
for the 8-port version.
.Pp
Each of the ports has a switched connector.
If the board fails for any reason,
the traffic on these ports is automatically routed
through the switched connector.
These connectors must be cabled to secondary ports on the other
.Tn FCCS
connector panels.
The secondary ports are numbered 8 through 11 on the 4-port version and
8 through 15 on the 8-port version.
Only the primary ports need be designated in the
.Tn FCCS
configuration line,
however all ports must be identified as described in the
.Tn PORT
Line section
below.
.It Em time 
Specifies the time period for the sentinel relay timer. 
Each board resets its sentinel timer after the specified
time period. If the
board fails, and therefore can't set the timer, then control
is passed automatically to another board, which continues 
the current processing. This feature ensures
.Dq PerpetualProcessing
and is transparent to the user. The valid range of values
in milliseconds is from
.Sy 50
to
.Sy 5950
in 
50 millisecond increments.
.El
.Pp
.Sy PROTOCOL Line
.Pp
Format:
.Pp
.Bd -filled -offset indent
.Sm off
.Sy PROTOCOL: Em procol Sy \&: Em depargs
.Sm on
.Ed
.Pp
Argument Explanations:
.Bd -filled -offset indent
.Bl -tag -width indent
.It Em procol 
Specifies the protocol you want associated with the 
board specified in the previous
.Tn MPCC
line. 
.It Em depargs 
Specifies the protocol-dependent protocol attributes.
X.25
and
.Tn SNA
have ten (10)
arguments,
.Tn ASYNC
has just
.Em one 1
argument, and
.Tn BISYNC
has no arguments.
.El
.Pp
.Em X.25 Dependent Attributes
.Pp
Note: You must be familiar with the 
X.25
.Tn CCITT
Yellow Book (1980) 
in order to understand the following values.
.Bl -tag -width indent
.It Em "N1"
Specifies the maximum frame size in bytes.
.It Em "N2"
Specifies the retry count.
.It Em "T1"
Specifies the retry timer in milliseconds.
.It Em "T2" 
Specifies the response delay timer in milliseconds.
.It Em "T3" 
Specifies the inactive link timer in milliseconds.
.It Em "T4"
Specifies the idle channel timer in milliseconds.
.It Em K 
Specifies the Level 2 window size.
.It Em xid1 
Specifies the destination type in the
.Tn XID
command. It must be a number
from 1-5:
.Bd -unfilled -offset indent
1 = AXE
2 = CTSS
3 = DEX
4 = DMS
5 = WESCOM
.Ed
.It Em xid2 
Specifies the destination identity in the
.Tn XID
command. It can be three to 
nine
.Tn ASCII
characters.
.It Em xid3 
Specifies the additional information in the
.Tn XID
command. It can be any
.Tn ASCII
string up to 20 characters long.
.El
.Pp
.Em ASYNC and 32PORT Dependent Attribute
.Bl -tag -width indent
.It Em bufsize 
Specifies the size of the transmit/receive buffers in bytes.
.El
.Ed
.Pp
.Sy PORT Line
.Pp
Format:
.Bd -filled -offset indent
.Sm off
.Xo
.Sy PORT: Em portno
.Sy \&: Em procol
.Sy \&: Em depargs
.Xc
.Sm on
.Ed
.Pp
Argument Explanations:
.Bd -filled -offset indent
.Bl -tag -width indent
.It Em portno
Specifies the port number of the previously specified board.
.It Em procol
Specifies the protocol. You must state the same protocol
as you stated in the preceding
.Tn PROTOCOL
line.
.It Em depargs
Specifies the protocol-dependent port attributes. X.25 has
fourteen (14) arguments.
.Tn ASYNC ,
.Pf 32 Tn PORT
and
.Tn BISYNC
have none.
.Tn SNA
has 14
fixed arguments.
.El
.Pp
.Em X.25 Dependent Arguments
.Pp
Note: You must be familiar with the X.25
.Tn CCITT
Yellow
Book (1980) in order to understand the following values.
.Bl -tag -width surecvbuf
.It Em ixmitbuf
Specifies the number of transmit buffers allocated
for I frames.
.It Em suxmitbuf
Specifies the number of transmit buffers allocated for
.Tn S/U
frames.
.It Em irecvbuf
Specifies the number of receive buffers allocated for
I frames.
.It Em surecvbuf
Specifies the number of receive buffers allocated for
.Tn S/U
frames.
.It Em xmito
Specifies the Level 1 transmit timeout.
This argument should be
.Sy 0
so that Level 1 calculates timeout from
the baud rate.
.It Em rts 
Specifies the modem control value
for rts. Valid values are
.Sy 1
which equals 
.Xr assert ,
.Sy 2
which equals
.Sy drop ,
and
.Sy 3
which equals
.Sy auto .
.It Em dtr 
Specifies the modem control value for dtr. 
Valid values are
.Sy 1
which equals
.Xr assert ,
and
.Sy 2
which equals
.Sy drop .
.It Em lineidle 
Specifies the line state between transmissions. 
Valid values are
.Sy 0
which specifies a flag
fill, and
.Sy 1
which specifies a mark fill.
.It Em rcvadr 
Specifies the port configuration. A
.Sy 1
makes the port
a
.Tn DCE ,
while a
.Sy 3
makes the port a
.Tn DTE .
.It Em mask 
Specifies the data link receive mask. This argument must be
.Sy 3 .
.It Em xmtrty 
Specifies the number of data link retries after a transmit
timeout. This argument should be zero since upper levels of X25 do retries.
.It Em baud 
Specifies the baud rate of a transmission. All standard rates
are supported. Some common rate values are
.Sy 0
equals a modem,
.Sy 13
equals 9600, and
.Sy 26
equals
.Pf \&56 Tn KB .
See the header file
.Pa mp_port.h
for other values.
.It Em encode 
Specifies the physical data encoding. A
.Sy 0
indicates
.Tn NRZ ,
and a
.Sy 1
indicates
.Tn NRZI.
.It Em trace 
Specifies the data link receive trace mode. This argument must be
.Sy 0 .
.El
.Ed
.Sh EXAMPLES
The following entry configures five
.Tn MPCC
boards: one for X.25,
.Tn ASYNC ,
.Pf 32 Tn PORT ,
.Tn BISYNC
and
.Tn SNA .
Each has two ports.
.Bd -literal
MPCC:0
PROTOCOL:X25:272:2:6000:1000:30000:20000:8:2:ccice1:remote
PORT:0:X25:8:16:8:16:0:1:1:0:1:3:0:0:0:0
PORT:1:X25:8:16:8:16:0:1:1:0:3:3:0:0:0:0

MPCC:1
PROTOCOL:ASYNC:128
PORT:0:ASYNC
PORT:1:ASYNC

MPCC:2
PROTOCOL:32PORT:128
PORT:0:32PORT
PORT:1:32PORT

MPCC:3
PROTOCOL:BISYNC
PORT:0:BISYNC
PORT:1:BISYNC

MPCC:4
PROTOCOL:SNA:272:4:800:200:20000:20000:8:2:acey:deucy
PORT:0:SNA:8:10:10:24:5:3:1:0:193:193:1:0:0:0
PORT:1:SNA:8:10:10:24:5:3:1:0:193:193:1:0:0:0
.Ed
.Sh FILES
.Bl -tag -width /usr/libdata/mpcctab -compact
.It Pa /usr/libdata/mpcctab
.It Pa /usr/libdata/mpcca
.It Pa /usr/libdata/mpccb
.It Pa /usr/libdata/mpcc32
.It Pa /usr/libdata/mpccx
.El
.Sh SEE ALSO
.Xr dlmpcc 8
.Sh HISTORY
The
.Nm mpcc
configuration file appeared in
.Bx 4.3 tahoe .