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