Inter-Office MemorandumToGateway AdministratorsDateFebruary 28, 1979FromDavid BoggsLocationPalo AltoSubjectGateControlOrganizationParcXEROX Filed on: [Ivy]GateControl.bravoThis memo describes GateControl, a program which allows you to remotely control and monitorPup gateways.OperationGateControl opens five windows on the Alto screen. The top window displays the release date ofthe program. While monitoring a gateway, the next window displays the gateway's name andaddress, version text, server summaries, and transit matrix, updated every few seconds. The nextwindow contains a command menu. The window below that simulates a teletype. The bottomwindow displays error messages, blinking once before each message to get your attention.GateControl obtains much of its information from the normal servers in the gateway. Mostcommands use simple 'connectionless' protocols which do not perturb the gateway very much andpermit several people to run GateControl and monitor the same gateway.CommandsA command is triggered by clicking the RED mouse button over its name in the menu window.The command lights up when the button is depressed, and takes effect when the button is released.If you change your mind, move the cursor off the command before letting up on the button. Forcommands that require confirmation, YELLOW as well as the traditional keyboard keys work.DELETE aborts any command if it is expecting you to type something. Most of these commandsapply to the 'current gateway' whose statistics are being displayed in the top window. Somecommands replace the current menu with a subsidiary menu of specialized commands. One ofthese special commands is always 'TopLevel', which returns to the main menu.QuitReturns to the Alto Executive. Requires confirmation.GatewayPrompts you for an address and sets the current gateway to it. Since gateways bydefinition have more than one address, you can influence (though not totallycontrol) the route of GateControl's packets by your choice of address. Commandsthat only make sense when talking to a gateway aren't included in the menu untilyou give this command; until then the remaining commands generate broadcastPups and any responses printed are those of the first host to answer.RouteCreates a subsidiary menu of routing protocol commands:Н]Оg║pТ·НІОc8qН]rТ└Н-єqН7BrНІО]ЭqН]r Н-єqН7BrНІОYqН]r Н-єqН7BrНЭОSЛsrНЇОMЪП)НЇОGНТ╡П[НЇОFiТНЇОC=tНЇО@rТ П7Т⌡П(НЇО>▄ТлТмПMНЇО=Т╗П(Т╘П9НЇО;┌Т╦Т╧П?НЇО9ЩТПXНюО6яТЮПJТАНюО5LТ═ПOТ║ НюО3гТПFНЇО0⌡tНЇО-orТЄП'qrТ╣П"НЇО+ЙТ┼П3Т▀П.НЇО*eТ√ПMТ≈НЇО(ЮТЛП$qrТМП,НЇО'[qrТ╙П*Т╚П+НЇО%жТжПWТвНЇО$QТЎП8Т©П!НЇО"лТПLНІО═НёОП6НІООНёОjТ≤П/Т≥П"НёОЕТХТИП/НёО`Т√Т≈ПDНёОшТ⌡ПPНёОVТфПAТг НёОяТПEНІО╔НёО П7 Эы>Г\) GateControl2ForeignRoutingTableObtains and displays the routing table from the current gateway.LocalRoutingTableDisplays the routing table being used by the Pup package insideGateControl. You can deduce the route of GateControl's packets bypondering this table and the routing tables obtained from gateways withthe ForeignRoutingTable command.EchoCreates a subsidiary menu of echo protocol commands:ChecksumsToggles the checksum flag. When this flag is true, outgoing packetscontain a checksum and incoming packets checksums are checked.CheckDataToggles the CheckData flag. When this flag is true, the data in incomingpackets is checked.EchoUserPrompts you for an address and sends echo packets to it until you type anykey. Each packet gets bigger by one byte, up to a maximum size Pup, andthen starts over at zero. "!" means the correct echo came back, "#" meansa delayed out-of-order echo arrived and "?" means no echo arrived within2 seconds. When the test is stopped, the number of echos sent, thenumber of good echo replies, and their ratio are displayed.NameCreates a subsidiary menu of name lookup protocol commands:NameToAddressPrompts you for a name, sends it to the name lookup server in the currentgateway, and displays the resulting address list.AddressToNamePrompts you for an address, sends it to the name lookup server in thecurrent gateway, and displays the resulting name.NameServerStatsAsks the name server in the current gateway for its statistics.NetDirVersionAsks the name server in the current gateway for the version number of itslocal copy of the network directory.BootCreates a subsidiary menu of boot protocol commands:BootFileDirectoryAsks the boot server for its boot file directory. For each boot file whichthe server has, it returns its name, number and creation date. Note that ifthe boot server's parameter file mentions a boot file, but the server doesn'thave a copy yet, it will not be included in this directory.BootServerStatsAsks the boot server in the current gateway for its statistics.ЪНЇОfПr НGЛН╛ОbН≥О`≥ТП@Н╛О]mН≥О[ХТ4П%Т5Н≥ОZcТМТНП1Н≥ОXчТ╩Т╪П3Н≥ОWYТНІОT-НёОR╗П4Н╛ОO|Н≥ОMВТНТОП)Н≥ОLrТП>Н╛ОIFН≥ОGаТ²Т·П4Н≥ОF<ТН╛ОCН≥ОA▀Т┘ПFТ├Н≥О@Т┬П?Т┴Н≥О>│Т─ПDТ│Н≥О<ЭТ П9Т⌡Н≥О;wТДТЕП3Н≥О9РТП;НІО6фНёО5AП;Н╛О2Н≥О0░Т▌ПIН≥О/ТП1Н╛О+ъН≥О*ZТфТгП*Н≥О(уТП1Н╛О%╘Н≥О$$П?Н╛О ЬН≥ОsТ∙Т√П<Н≥ОНТП$НІОбНёО=П4Н╛ОН≥О▄ТїПKН≥ОТ▓ПLН≥О┌Т▐Т░П<Н≥ОЩТП;Н╛ОяН≥ОLП?ЪРЇ/]ЗGateControl3TimeCreates a subsidiary menu of time protocol commands:AltoTimeAsks the timer server for the time in Alto format. It is printed as ifGateControl were located in the time zone of the server.TenexTimeAsks the time server for the time in Tenex format. It is printed as 6 bytes.StringTimeAsks the time server for the time in String format. Not all time serversimplement this format.TimeServerStatsAsks the time server in the current gateway for its statistics.ResetTimePrompts you for an address and commands the time server in the currentgateway to reset its internal calendar clock from the time server at thataddress.Level0StatsDisplays a subsidiary menu consisting of the numbers of all of the networks towhich the current gateway is directly connected. Bugging a number causesGateControl to ask for the statistics for that network. Not all network driverscollect statistics and those that do usually do so only if a compile-time switch is set,since gathering them costs execution time and code space.Enable/DisableCommands which can alter the operation of a gateway rather than just monitor itare not included in any menus until you give this command and enter the properpassword. If GateControl is 'enabled', then the top level command menu containsa 'disable' command.StoreFileStores a local file onto the current gateway's disk. The command is similar to FTP'sstore command, and allows the file to be renamed in the process. If the local file'sextension is ".boot", then if it is a type S boot file, it is reformatted to type B as itis sent. The cursor flips for each 256 word block transferred, and the throughput inbits/second is displayed at the end.DebuggerEnters a simple DDT-style cross-net debugger for the current gateway. Thecommands are:=set print mode to octal words_set print mode to octal bytes_print the current cell as octal bytes=print the current cell as an octal wordadr/open cell adr and print contentsclose current cellclose current cell and open next one^close current cell and open previous oneabort current commandQquit the debuggerЪНЇОfПr НGЛНІОbНёО`≥ТП4Н╛О]mН≥О[ХТрПGН≥ОZcТП8Н╛ОW7Н≥ОU╡Т┤Т┬П1Н╛ОR├ Н≥ОQТ╞П3Т╟Н≥ОO|ТН╛ОLPН≥ОJкП?Н╛ОG÷Н≥ОFТ═Т║П,Н≥ОD∙ТдПDТеН≥ОCНІО?Д НёО>_ТаТбП4НёО<зТТП-НёО;UТлП%ТмП+НёО9пТ┬П:Т┴НёО8KТП9НІО5 НёО3 Т║Т╒П=НёО2Т·П=Т÷НёО0░Т∙ Т√ПFНёО/ТНІО+ъНёО*ZТ┘Т├ПHqrНёО(уТ▀Т▄П8НёО'PТ░Т▒ qrП&qrНёО%кТ│ПCТ┌НёО$FТП$НІО!НёО∙ТqrТНёОТН═ОДН$─Н═О_Н$─Н═ОзН$─П%Н═ОUН$─П'Н═ОпН$─Н═ОKН$─Н═ОфН$─П$Н═ОAН$─П(Н═О╪Н$─Н═О 7Н$─:ЇП3Ш[ GateControl4HaltGatewayCommands the current gateway to stop. Once you have issued this command youlose control of the gateway and manual intervention at the gateway is required torestart it.RestartGatewayCommands the current gateway to stop, return to the gateway machine's Executive,and then restart. To release a new version of the gateway program or to change itsparameters, first store the new file(s) on the gateway's disk with the StoreFilecommand, and then restart the gateway.Revision HistoryJuly 13, 1978First release of documentation.February 16, 1979GateControl was rewritten, and this memo extensively revised.February 28, 1979.НЇОfПr НGЛНІОb НёО`≥Т√П4Т≈НёО_Т║Т╒ПBНёО]▐Т НІОZc НёОXчТ█ПEТ▌ НёОWYТ┤Т┬ПKНёОUтТыТзП5НёОTOТП&НЇОQ#tНЇОMВrНЇОLrТ└НЇОIhНЇОGЦП=НЇОDы┌ЇD▓3Ш#xa TIMESROMAN TIMESROMAN TIMESROMAN LOGO TIMESROMAN ВЮ÷ЪЪj/⌠а]ЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪЪgatecontrol.bravoBoggsFebruary 28, 1979 2:01 AM