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