xref: /original-bsd/old/dlmpcc/mpcctab.4 (revision 703f6d5d)
1.\" Copyright (c) 1987, 1991 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" This code is derived from software contributed to Berkeley by
5.\" Computer Consoles Inc.
6.\"
7.\"	%sccs.include.redist.roff%
8.\"
9.\"     @(#)mpcctab.4	6.5 (Berkeley) 05/10/91
10.\"
11.Dd
12.Dt MPCCTAB 4
13.Os
14.Sh NAME
15.Nm mpcctab
16.Nd
17.Tn MPCC
18configuration file
19.Sh DESCRIPTION
20The
21.Tn ASCII
22file
23.Nm mpcctab
24is used to configure
25.Tn CCI Ns 's
26Multi-Protocol
27Communication Controller
28.Pq Tn MPCC .
29The controller provides high-speed
30synchronous communications for the
31.Tn POWER
32family
33of computers.
34This file determines the
35.Tn MPCC
36board
37configurations. You can download either a synchronous , bisync or
38an asynchronous protocol to an
39.Tn MPCC
40board.
41(See
42.Xr dlmpcc 8
43for details.)
44.Pp
45A
46.Nm mpcctab
47file is supplied
48with each
49.Tn MPCC
50release; however,
51you can modify this file or create your own file.
52.Pp
53The contents of the file
54consists of entries that describe supported communication
55protocols and their unique attributes. The protocols supported are
56.Tn X Ns \&.25 ,
57.Tn SNA ,
58.Tn ASYNC ,
59and
60.Tn BISYNC .
61For
62.Tn ASYNC
63two different entries are possible in the
64.Em procol
65field - if 16 port
66.Tn MPCC
67async is configured, then
68.Tn ASYNC
69is
70entered; 32 port
71.Tn MPCC
72async is specified by entering
73.Pf \&32 Tn PORT .
74This file must reside in the directory
75.Pa /usr/libdata .
76.Sh Entry Line Format
77An entry line consists of an
78.Em item identifier
79followed by
80variable width arguments separated by colons. There are three
81item identifiers:
82.Tn MPCC ,
83.Tn PROTOCOL ,
84.Tn PORT .
85The
86.Tn MPCC
87line in this file
88identifies the board number. The
89.Tn PROTOCOL
90line identifies
91the specific communication protocol.
92The
93.Tn PORT
94line describes
95the port for the immediately preceding protocol. The number
96of arguments for the
97.Tn PROTOCOL
98and
99.Tn PORT
100lines,
101and the arguments themselves,
102are protocol dependent. See the individual
103argument descriptions for details.
104.Pp
105Notes: Use upper case letters for clarity when specifying the item
106identifier and the protocol name. Make sure that you enter
107the argument values in the order specified below. Also, use comments
108liberally, and indicate comment lines by placing a
109pound sign
110.Pq Sy #
111in column one.
112.Pp
113The item identifiers and their corresponding line
114formats, with valid argument values, follow:
115.Pp
116.Sy MPCC Line
117.Pp
118Format:
119.Bd -filled -offset indent
120.Sm off
121.Xo
122.Sy MPCC: Em bdno Sy \&:
123.Op Sy FCCS, Em portno , timer
124.Sy \&:
125.Op Sy SOC , Em portno
126.Xc
127.Sm on
128.Ed
129.Pp
130Argument Explanations:
131.Bl -tag -width indent -offset indent
132.It Em bdno
133Specifies the board number.
134.It Sy FCCS
135.Tn FCCS
136is a fault-tolerant support system that allows backup ports
137to assume the functions of failed ports.
138For example,
139if port 0 fails for any reason,
140another port may be configured to assume the duties of the failed port.
141The keyword
142.Sy FCCS
143identifies this feature and must be
144followed by the list of fail-safe port numbers and a time increment,
145described below.
146This feature is optional.
147.It Sy SOC
148An
149.Tn FCCS
150port can also be an
151.Tn SOC
152(Switch On Close) port,
153meaning that the port will switch when it is closed.
154And as with
155.Tn FCCS ,
156the port will switch if it fails.
157This feature is optional.
158.It Em portno
159.Em Portno
160is a list of port numbers,
161separated by commas,
162specifying the primary ports you want protected by backup ports.
163.Tn FCCS
164boards have either 4 primary and 4 backup ports,
165or 8 primary and 8 backup ports.
166The valid port numbers are
167.Sy 0
168through
169.Sy 3
170for the 4-port version,
171and
172.Sy 0
173through
174.Sy 7
175for the 8-port version.
176.Pp
177Each of the ports has a switched connector.
178If the board fails for any reason,
179the traffic on these ports is automatically routed
180through the switched connector.
181These connectors must be cabled to secondary ports on the other
182.Tn FCCS
183connector panels.
184The secondary ports are numbered 8 through 11 on the 4-port version and
1858 through 15 on the 8-port version.
186Only the primary ports need be designated in the
187.Tn FCCS
188configuration line,
189however all ports must be identified as described in the
190.Tn PORT
191Line section
192below.
193.It Em time
194Specifies the time period for the sentinel relay timer.
195Each board resets its sentinel timer after the specified
196time period. If the
197board fails, and therefore can't set the timer, then control
198is passed automatically to another board, which continues
199the current processing. This feature ensures
200.Dq PerpetualProcessing
201and is transparent to the user. The valid range of values
202in milliseconds is from
203.Sy 50
204to
205.Sy 5950
206in
20750 millisecond increments.
208.El
209.Pp
210.Sy PROTOCOL Line
211.Pp
212Format:
213.Pp
214.Bd -filled -offset indent
215.Sm off
216.Sy PROTOCOL: Em procol Sy \&: Em depargs
217.Sm on
218.Ed
219.Pp
220Argument Explanations:
221.Bd -filled -offset indent
222.Bl -tag -width indent
223.It Em procol
224Specifies the protocol you want associated with the
225board specified in the previous
226.Tn MPCC
227line.
228.It Em depargs
229Specifies the protocol-dependent protocol attributes.
230X.25
231and
232.Tn SNA
233have ten (10)
234arguments,
235.Tn ASYNC
236has just
237.Em one 1
238argument, and
239.Tn BISYNC
240has no arguments.
241.El
242.Pp
243.Em X.25 Dependent Attributes
244.Pp
245Note: You must be familiar with the
246X.25
247.Tn CCITT
248Yellow Book (1980)
249in order to understand the following values.
250.Bl -tag -width indent
251.It Em "N1"
252Specifies the maximum frame size in bytes.
253.It Em "N2"
254Specifies the retry count.
255.It Em "T1"
256Specifies the retry timer in milliseconds.
257.It Em "T2"
258Specifies the response delay timer in milliseconds.
259.It Em "T3"
260Specifies the inactive link timer in milliseconds.
261.It Em "T4"
262Specifies the idle channel timer in milliseconds.
263.It Em K
264Specifies the Level 2 window size.
265.It Em xid1
266Specifies the destination type in the
267.Tn XID
268command. It must be a number
269from 1-5:
270.Bd -unfilled -offset indent
2711 = AXE
2722 = CTSS
2733 = DEX
2744 = DMS
2755 = WESCOM
276.Ed
277.It Em xid2
278Specifies the destination identity in the
279.Tn XID
280command. It can be three to
281nine
282.Tn ASCII
283characters.
284.It Em xid3
285Specifies the additional information in the
286.Tn XID
287command. It can be any
288.Tn ASCII
289string up to 20 characters long.
290.El
291.Pp
292.Em ASYNC and 32PORT Dependent Attribute
293.Bl -tag -width indent
294.It Em bufsize
295Specifies the size of the transmit/receive buffers in bytes.
296.El
297.Ed
298.Pp
299.Sy PORT Line
300.Pp
301Format:
302.Bd -filled -offset indent
303.Sm off
304.Xo
305.Sy PORT: Em portno
306.Sy \&: Em procol
307.Sy \&: Em depargs
308.Xc
309.Sm on
310.Ed
311.Pp
312Argument Explanations:
313.Bd -filled -offset indent
314.Bl -tag -width indent
315.It Em portno
316Specifies the port number of the previously specified board.
317.It Em procol
318Specifies the protocol. You must state the same protocol
319as you stated in the preceding
320.Tn PROTOCOL
321line.
322.It Em depargs
323Specifies the protocol-dependent port attributes. X.25 has
324fourteen (14) arguments.
325.Tn ASYNC ,
326.Pf 32 Tn PORT
327and
328.Tn BISYNC
329have none.
330.Tn SNA
331has 14
332fixed arguments.
333.El
334.Pp
335.Em X.25 Dependent Arguments
336.Pp
337Note: You must be familiar with the X.25
338.Tn CCITT
339Yellow
340Book (1980) in order to understand the following values.
341.Bl -tag -width surecvbuf
342.It Em ixmitbuf
343Specifies the number of transmit buffers allocated
344for I frames.
345.It Em suxmitbuf
346Specifies the number of transmit buffers allocated for
347.Tn S/U
348frames.
349.It Em irecvbuf
350Specifies the number of receive buffers allocated for
351I frames.
352.It Em surecvbuf
353Specifies the number of receive buffers allocated for
354.Tn S/U
355frames.
356.It Em xmito
357Specifies the Level 1 transmit timeout.
358This argument should be
359.Sy 0
360so that Level 1 calculates timeout from
361the baud rate.
362.It Em rts
363Specifies the modem control value
364for rts. Valid values are
365.Sy 1
366which equals
367.Xr assert ,
368.Sy 2
369which equals
370.Sy drop ,
371and
372.Sy 3
373which equals
374.Sy auto .
375.It Em dtr
376Specifies the modem control value for dtr.
377Valid values are
378.Sy 1
379which equals
380.Xr assert ,
381and
382.Sy 2
383which equals
384.Sy drop .
385.It Em lineidle
386Specifies the line state between transmissions.
387Valid values are
388.Sy 0
389which specifies a flag
390fill, and
391.Sy 1
392which specifies a mark fill.
393.It Em rcvadr
394Specifies the port configuration. A
395.Sy 1
396makes the port
397a
398.Tn DCE ,
399while a
400.Sy 3
401makes the port a
402.Tn DTE .
403.It Em mask
404Specifies the data link receive mask. This argument must be
405.Sy 3 .
406.It Em xmtrty
407Specifies the number of data link retries after a transmit
408timeout. This argument should be zero since upper levels of X25 do retries.
409.It Em baud
410Specifies the baud rate of a transmission. All standard rates
411are supported. Some common rate values are
412.Sy 0
413equals a modem,
414.Sy 13
415equals 9600, and
416.Sy 26
417equals
418.Pf \&56 Tn KB .
419See the header file
420.Pa mp_port.h
421for other values.
422.It Em encode
423Specifies the physical data encoding. A
424.Sy 0
425indicates
426.Tn NRZ ,
427and a
428.Sy 1
429indicates
430.Tn NRZI.
431.It Em trace
432Specifies the data link receive trace mode. This argument must be
433.Sy 0 .
434.El
435.Ed
436.Sh EXAMPLES
437The following entry configures five
438.Tn MPCC
439boards: one for X.25,
440.Tn ASYNC ,
441.Pf 32 Tn PORT ,
442.Tn BISYNC
443and
444.Tn SNA .
445Each has two ports.
446.Bd -literal
447MPCC:0
448PROTOCOL:X25:272:2:6000:1000:30000:20000:8:2:ccice1:remote
449PORT:0:X25:8:16:8:16:0:1:1:0:1:3:0:0:0:0
450PORT:1:X25:8:16:8:16:0:1:1:0:3:3:0:0:0:0
451
452MPCC:1
453PROTOCOL:ASYNC:128
454PORT:0:ASYNC
455PORT:1:ASYNC
456
457MPCC:2
458PROTOCOL:32PORT:128
459PORT:0:32PORT
460PORT:1:32PORT
461
462MPCC:3
463PROTOCOL:BISYNC
464PORT:0:BISYNC
465PORT:1:BISYNC
466
467MPCC:4
468PROTOCOL:SNA:272:4:800:200:20000:20000:8:2:acey:deucy
469PORT:0:SNA:8:10:10:24:5:3:1:0:193:193:1:0:0:0
470PORT:1:SNA:8:10:10:24:5:3:1:0:193:193:1:0:0:0
471.Ed
472.Sh FILES
473.Bl -tag -width /usr/libdata/mpcctab -compact
474.It Pa /usr/libdata/mpcctab
475.It Pa /usr/libdata/mpcca
476.It Pa /usr/libdata/mpccb
477.It Pa /usr/libdata/mpcc32
478.It Pa /usr/libdata/mpccx
479.El
480.Sh SEE ALSO
481.Xr dlmpcc 8
482.Sh HISTORY
483The
484.Nm mpcc
485configuration file appeared in
486.Bx 4.3 tahoe .
487