Annotation of 43BSDTahoe/man/man4/tahoe/mpcctab.4, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1987 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)mpcctab.4   6.2 (Berkeley) 5/4/88
                      6: .\"
                      7: .TH MPCCTAB 4 "May 4, 1988"
                      8: .UC 7
                      9: .SH NAME
                     10: mpcctab \- MPCC configuration file
                     11: .SH DESCRIPTION
                     12: The file \fBmpcctab\fR is used to configure CCI's Multi-Protocol 
                     13: Communication Controller (MPCC).
                     14: The controller provides high-speed
                     15: synchronous communications for the \s-1POWER 6\s+1 family
                     16: of computers.
                     17: This file determines the MPCC board 
                     18: configurations. You can download either a synchronous , bisync or
                     19: an asynchronous protocol to an MPCC board.
                     20: See \fIdlmpcc\fR(8)
                     21: for details.
                     22: .LP
                     23: A \fBmpcctab\fR file is supplied
                     24: with each MPCC release; however, 
                     25: you can modify this file or create your own file 
                     26: by using one of the \s-1UNIX\s+1 text editors.
                     27: .LP
                     28: The contents of the file 
                     29: consists of entries that describe supported communication 
                     30: protocols and their unique attributes. The protocols supported are
                     31: X.25, SNA,  ASYNC, and BISYNC.
                     32: For ASYNC two different entries are possible in the 
                     33: \fIprocol\fR field - if 16 port MPCC async is configured, then ASYNC is 
                     34: entered; 32 port MPCC async is specified by entering 32PORT.
                     35: This file must reside in the directory
                     36: \fB/etc/mpcc\fR. 
                     37: .SH Entry Line Format
                     38: An entry line consists of an \fIitem identifier\fR followed by 
                     39: variable width arguments separated by colons. There are three 
                     40: item identifiers: MPCC, PROTOCOL, PORT. The MPCC line in this file
                     41: identifies the board number. The PROTOCOL line identifies
                     42: the specific communication protocol.
                     43: The PORT line describes
                     44: the port for the immediately preceding protocol. The number
                     45: of arguments  for the PROTOCOL and PORT lines,
                     46: and the arguments themselves, 
                     47: are protocol dependent. See the individual
                     48: argument descriptions for details.
                     49: .LP
                     50: Notes: Use upper case letters for clarity when specifying the item 
                     51: identifier and the protocol name. Make sure that you enter
                     52: the argument values in the order specified below. Also, use comments 
                     53: liberally, and indicate comment lines by placing a 
                     54: pound sign (\fB#\fR) in column one. 
                     55: .LP
                     56: The item identifiers and their corresponding line
                     57: formats, with valid argument values, follow:
                     58: .LP
                     59: \fBMPCC Line\fR
                     60: .LP
                     61: Format:
                     62: .RS
                     63: .LP
                     64: \fBMPCC:\fIbdno\fB:\fR[\fBFCCS,\fIportno\fR\fB,\fItimer\fR]\fB:\fR[\fBSOC,\fIportno\fR]
                     65: .RE 
                     66: .LP 
                     67: Argument Explanations: 
                     68: .RS
                     69: .IP \fIbdno\fR 8
                     70: Specifies the board number.
                     71: .IP \fBFCCS\fR 8
                     72: FCCS is a fault-tolerant support system that allows backup ports
                     73: to assume the functions of failed ports.
                     74: For example,
                     75: if port 0 fails for any reason,
                     76: another port may be configured to assume the duties of the failed port.
                     77: The keyword \fBFCCS\fR identifies this feature and must be
                     78: followed by the list of fail-safe port numbers and a time increment,
                     79: described below.
                     80: This feature is optional.
                     81: .IP \fBSOC\fR 8
                     82: An FCCS port can also be an SOC (Switch On Close) port,
                     83: meaning that the port will switch when it is closed.
                     84: And as with FCCS, the port will switch if it fails.
                     85: This feature is optional.
                     86: .IP \fIportno\fR 8
                     87: Portno is a list of port numbers,
                     88: separated by commas,
                     89: specifying the primary ports you want protected by backup ports.
                     90: FCCS boards have either 4 primary and 4 backup ports,
                     91: or 8 primary and 8 backup ports.
                     92: The valid port numbers are
                     93: .B 0
                     94: through
                     95: .B 3
                     96: for the 4-port version,
                     97: and
                     98: .B 0
                     99: through
                    100: .B 7
                    101: for the 8-port version.
                    102: .IP
                    103: Each of the ports has a switched connector.
                    104: If the board fails for any reason,
                    105: the traffic on these ports is automatically routed
                    106: through the switched connector.
                    107: These connectors must be cabled to secondary ports on the other FCCS
                    108: connector panels.
                    109: The secondary ports are numbered 8 through 11 on the 4-port version and
                    110: 8 through 15 on the 8-port version.
                    111: Only the primary ports need be designated in the FCCS configuration line,
                    112: however all ports must be identified as described in the PORT Line section
                    113: below.
                    114: .if n .bp
                    115: .IP \fItime\fR 8
                    116: Specifies the time period for the sentinel relay timer. 
                    117: Each board resets its sentinel timer after the specified
                    118: time period. If the
                    119: board fails, and therefore can't set the timer, then control
                    120: is passed automatically to another board, which continues 
                    121: the current processing. This feature ensures PerpetualProcessing
                    122: and is transparent to the user. The valid range of values
                    123: in milliseconds is from \fB50\fR to \fB5950\fR in 
                    124: 50 millisecond increments.
                    125: .LP
                    126: .RE
                    127: \fBPROTOCOL Line\fR 
                    128: .LP
                    129: Format:
                    130: .LP
                    131: .RS
                    132: \fBPROTOCOL:\fIprocol\fB:\fIdepargs\fR
                    133: .LP
                    134: .RE
                    135: Argument Explanations:
                    136: .RS
                    137: .IP \fIprocol\fR 10
                    138: Specifies the protocol you want associated with the 
                    139: board specified in the previous \fBMPCC\fR line. 
                    140: .IP \fIdepargs\fR 10
                    141: Specifies the protocol-dependent protocol attributes. X.25  and SNA have ten (10)
                    142: arguments,
                    143: ASYNC has just one (1) argument, and BISYNC has no arguments.
                    144: .LP
                    145: .cu
                    146: X.25 Dependent Attributes
                    147: .LP
                    148: Note: You must be familiar with the 
                    149: X.25 CCITT Yellow Book (1980) 
                    150: in order to understand the following values.
                    151: .IP \fIN1\fR 8
                    152: Specifies the maximum frame size in bytes.
                    153: .IP \fIN2\fR 8
                    154: Specifies the retry count.
                    155: .IP \fIT1\fR 8
                    156: Specifies the retry timer in milliseconds.
                    157: .IP \fIT2\fR 8
                    158: Specifies the response delay timer in milliseconds.
                    159: .IP \fIT3\fR 8
                    160: Specifies the inactive link timer in milliseconds.
                    161: .IP \fIT4\fR 8
                    162: Specifies the idle channel timer in milliseconds.
                    163: .IP \fIK\fR 8
                    164: Specifies the Level 2 window size.
                    165: .if n .bp
                    166: .IP \fIxid1\fR 8
                    167: Specifies the destination type in the XID command. It must be a number
                    168: from 1-5:
                    169: .nf
                    170: 
                    171:         1 = AXE
                    172:         2 = CTSS
                    173:         3 = DEX
                    174:         4 = DMS
                    175:         5 = WESCOM
                    176: .fi
                    177: .IP \fIxid2\fR 8
                    178: Specifies the destination identity in the XID command. It can be three to 
                    179: nine ASCII characters.
                    180: .IP \fIxid3\fR 8
                    181: Specifies the additional information in the XID command. It can be any
                    182: ASCII string up to 20 characters long.
                    183: .LP
                    184: .cu
                    185: ASYNC and 32PORT Dependent Attribute
                    186: .IP \fIbufsize\fR 10
                    187: Specifies the size of the transmit/receive buffers in bytes.
                    188: .RE
                    189: .LP
                    190: \fBPORT Line\fR
                    191: .LP
                    192: Format:
                    193: .LP
                    194: .RS
                    195: \fBPORT:\fIportno\fB:\fIprocol\fB:\fIdepargs\fR
                    196: .RE
                    197: .LP
                    198: Argument Explanations:
                    199: .RS
                    200: .IP \fIportno\fR 10
                    201: Specifies the port number of the previously specified board.
                    202: .IP \fIprocol\fR 10
                    203: Specifies the protocol. You must state the same protocol
                    204: as you stated in the preceding PROTOCOL line.
                    205: .IP \fIdepargs\fR 10
                    206: Specifies the protocol-dependent port attributes. X.25 has
                    207: fourteen (14) arguments. ASYNC, 32PORT and BISYNC have none. SNA has 14
                    208: fixed arguments.
                    209: .LP
                    210: .cu
                    211: X.25 Dependent Arguments
                    212: .LP
                    213: Note: You must be familiar with the X.25 CCITT Yellow
                    214: Book (1980) in order to understand the following values.
                    215: .IP \fIixmitbuf\fR 12
                    216: Specifies the number of transmit buffers allocated
                    217: for I frames.
                    218: .IP \fIsuxmitbuf\fR 12
                    219: Specifies the number of transmit buffers allocated for
                    220: S/U frames.
                    221: .IP \fIirecvbuf\fR 12
                    222: Specifies the number of receive buffers allocated for
                    223: I frames.
                    224: .IP \fIsurecvbuf\fR 12
                    225: Specifies the number of receive buffers allocated for
                    226: S/U frames.
                    227: .IP \fIxmito\fR 12
                    228: Specifies the Level 1 transmit timeout.
                    229: This argument should be \fB0\fR so that Level 1 calculates timeout from
                    230: the baud rate.
                    231: .IP \fIrts\fR 12
                    232: Specifies the modem control value
                    233: for rts. Valid values are \fB1\fR which equals 
                    234: \fBassert\fR, \fB2\fR which equals \fBdrop\fR, and \fB3\fR 
                    235: which equals \fBauto\fR.
                    236: .IP \fIdtr\fR 12
                    237: Specifies the modem control value for dtr. 
                    238: Valid values are \fB1\fR which equals
                    239: \fBassert\fR, and \fB2\fR which equals \fBdrop\fR.
                    240: .IP \fIlineidle\fR 12
                    241: Specifies the line state between transmissions. 
                    242: Valid values are \fB0\fR which specifies a flag
                    243: fill, and \fB1\fR which specifies a mark fill.
                    244: .IP \fIrcvadr\fR 12
                    245: Specifies the port configuration. A \fB1\fR makes the port
                    246: a DCE, while a \fB3\fR makes the port a DTE.
                    247: .IP \fImask\fR 12
                    248: Specifies the data link receive mask. This argument must be
                    249: \fB3\fR.
                    250: .IP \fIxmtrty\fR 12
                    251: Specifies the number of data link retries after a transmit
                    252: timeout. This argument should be zero since upper levels of X25 do retries.
                    253: .IP \fIbaud\fR 12
                    254: Specifies the baud rate of a transmission. All standard rates
                    255: are supported. Some common rate values are \fB0\fR equals a modem,
                    256: \fB13\fR equals 9600, and \fB26\fR equals 56KB. See the header file
                    257: \fBmp_port.h\fR for other values.
                    258: .IP \fIencode\fR 12
                    259: Specifies the physical data encoding. A \fB0\fR indicates NRZ, and a \fB1\fR
                    260: indicates NRZI.
                    261: .IP \fItrace\fR 12
                    262: Specifies the data link receive trace mode. This argument must be \fB0\fR.
                    263: .RE
                    264: .if n .bp
                    265: .SH EXAMPLE
                    266: The following entry configures five MPCC boards: one for X.25,
                    267: ASYNC, 32PORT, BISYNC and SNA. Each has two ports.
                    268: .nf
                    269: 
                    270: MPCC:0
                    271: PROTOCOL:X25:272:2:6000:1000:30000:20000:8:2:ccice1:remote
                    272: PORT:0:X25:8:16:8:16:0:1:1:0:1:3:0:0:0:0
                    273: PORT:1:X25:8:16:8:16:0:1:1:0:3:3:0:0:0:0
                    274: 
                    275: MPCC:1
                    276: PROTOCOL:ASYNC:128
                    277: PORT:0:ASYNC
                    278: PORT:1:ASYNC
                    279: 
                    280: MPCC:2
                    281: PROTOCOL:32PORT:128
                    282: PORT:0:32PORT
                    283: PORT:1:32PORT
                    284: 
                    285: MPCC:3
                    286: PROTOCOL:BISYNC
                    287: PORT:0:BISYNC
                    288: PORT:1:BISYNC
                    289: 
                    290: MPCC:4
                    291: PROTOCOL:SNA:272:4:800:200:20000:20000:8:2:acey:deucy
                    292: PORT:0:SNA:8:10:10:24:5:3:1:0:193:193:1:0:0:0
                    293: PORT:1:SNA:8:10:10:24:5:3:1:0:193:193:1:0:0:0
                    294: .fi
                    295: .SH FILES
                    296: /etc/mpcctab
                    297: /etc/mpcca
                    298: /etc/mpccb
                    299: /etc/mpcc32
                    300: /etc/mpccx
                    301: .SH SEE ALSO
                    302: dlmpcc(8)

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.