filed on [rose]fugue6>doc>Overview.bravo1. Xerox 1108 OverviewThis section is an informal description of the day-to-day operation of the Xerox 1108. Subsequentsections of this manual contain detailed explanations of the operational procedures sketchedbelow.Operations OverviewOnce the Xerox 1108 has been properly loaded with Xerox software, its operation isstraightforward. Powering up the Xerox 1108 automatically starts Interlisp-D. When the userhas completed a session, he does a (LOGOUT) which saves the state of the current session untilthe next time Interlisp-D is started. The process of logging out puts the Xerox 1108 in its basestate: a black screen with a small bouncing white window. From this state it is possible to (a)resume an earlier Interlisp-D session, (b) load fresh versions of Interlisp-D, (c) run machinediagnostics.On Xerox 1108's with sufficient disk storage, more than one Interlisp-D environment can bemaintained on the local disk. Separate software projects can be supported under eachenvironment. To switch from one project to another, (LOGOUT) of the first environment andenter the second. Special software is provided to facilitate this switching back and forth.Occasionally errors and problems arise during the operation of the Xerox 1108. These areusually signalled via the LED lights on the Maintenance Panel. Please refer to the sectionentitled Maintenance Panel Codes for help in diagnosing such problems.The Local DiskThe Xerox 1108 is equipped with a 10, 29, or 42 Megabyte local disk. The disk is formatted intotwo or more logical volumes; the number and size of these logical volumes depends on the size ofthe disk. The 10 Megabyte disk is partitioned into two logical volumes named Diagnostics andLisp. The 29 and 42 Megabyte disks can be partitioned into four logical volumes: Diagnostics,Lisp, Lisp2 and Lisp3. The disk is partitioned using utility software distributed by Xerox. Insubsequent releases of this software, the user will be able to define the name and size of eachlogical volume.Logical volume Diagnostics contains software for running diagnostics on the display, keyboard,mouse, floppy disk drive, and Ethernet. It also contains a software package, the Install Lisp Tool,for initializing the local disk with Lisp software and switching back and forth between Interlisp-D environments stored on the local disk. Logical volumes Lisp, Lisp2 and Lisp3 can each contain a complete Interlisp-D environment.Each volume holds the Lisp virtual memory which is initialized from floppy disks or a fileserver.Although the Xerox 1108 can operate out of only one logical volume at a time, within eachlogical volume, an independent software project can be developed. As mentioned, the Install LispTool is used to switch the Xerox 1108 from one logical volume to another. The KeyboardThe Xerox 1108 keyboard is designed to accommodate both programming and word processingapplications. As such, many of the key caps may seem inappropriate in the realm of pure Lisp bp>."Xqa TVrNb R\ QN Ms] JrNR Is] G^ Fka D` Cc^ A >[ =SU ;Z :K\ 7BY 5[ 4:G 0s] -rN` ,_ trE *Nt r )WtrNt ' rtrK &O_ $ !_ ?Rtr c 7* /Z a 'Z ` J s] rNW y] 2=+Y2programming. Xerox will shortly offer a new set of key caps which will result in a more intuitiveprogrammer keyboard. In the meantime, please consult the keyboard map at the end of thisdocument. It establishes the location of many keys needed by Interlisp-D. The LOCK and UNLCK keys determine whether alphabetic characters are sent in upper or lower case,respectively. Since Interlisp-D distinguishes between upper and lower case, it may be useful tokeep the keyboard locked by pressing LOCK. For Xerox 1108's equipped with a 2-button mouse, the function key labeled Middle Mousecorresponds to the middle button of the 3-button mouse.Note the position of the control key, CTRL, at the bottom of the the left hand group of function keys.Booting the Xerox 1108Booting the Xerox 1108 is accomplished by depressing and releasing buttons located on theMaintenance Panel (MP). The MP can be found behind the flap under the floppy drive. Thepanel contains the On/Off rocker switch (1 is on, 0 is off), a 4-digit readout, and two switcheslabeled B Reset and Alt B. Using these switches, it is possible to effect different modes of booting bychoosing a 0-boot, 1-boot, 2-boot, etc. To boot the Xerox 1108, simultaneously press B Reset and AltB. Then release B Reset. The 4-digit readout shows 8888, then cycles slowly from 0000 to 0010.Each number is displayed long enough to give you a chance to release Alt B. When the number ofyour choice is displayed, release Alt B. If you make a mistake, press B Reset and Alt B and startagain. The Xerox 1108 may be booted as follows:0-boot restarts Interlisp-D from the most recent session; i.e., from the point of the last(LOGOUT). There are two other ways to get the same effect as a 0-boot: (1) power up the Xerox1108, (2) use the Install Lisp Tool, as described later in the section entitled Software Installation.If Interlisp-D has not been installed, or if the user has aborted the previous Interlisp-D sessionwithout logging out, the results of a 0-boot are unpredictable; the Maintenance Panel may show0217.1-boot places the Xerox 1108 in its base state: a black display with a bouncing white window.From this state, the mouse is used to enter either the Install Lisp Tool or the diagnostics package.Note: if the Xerox 1108 is not on a network with a timeserver, the 1-boot will pause with 0937 inthe MP, waiting for time and date to be set. This can be accomplished by 2-booting theInstallation Utility or Dixed Disk Diagnostics floppy (see below).2-boot boots the Xerox 1108 from an appropriately configured floppy disk. The InstallationUtility, supplied with the Xerox 1108, is a such a floppy. It is used to control the transfer ofInterlisp from floppies to the local disk.5-boot boots the Xerox 1108 from the Fixed Disk Diagnostics floppy, which runs acomprehensive set of machine diagnostics. See the section entitled Hardware Diagnostics.SoftwareXerox supplies a number of software systems with each 1108. Each system is recorded on one ormore floppy disks. The major system is Interlisp-D. The remaining systems are a collection oftools for performing utilitarian functions such as software installation or machine faultdiagnosis. Associated with each tool is a mouse-sensistive window which controls the behavior ofthe tool. See the section entitled 1108 System Tools.The Lisp SysoutNfr bNb `Y _K \ururN Z` Y%ur UJu TyrN7 Qq&ur< Ls] IrNY HY F)vrvr- E urNurNN C tr5urNu BrurNF @~EurN >"urNurNurN =vur* :nwrU 8^ 7f$urN)t 5rb 4^^ 2 /wrUt .Mrd ,=wr" +EW )B &wrT %5a #* bwrs]rN0 Ctrt r s r^ _ Y a w$tr s]  U=] 3A sysout is a checkpointed version of an Interlisp-D environment. It contains all the informationneeded to initialize virtual memory when Interlisp-D is started. In many respects, a sysout is theinitial virtual memory. Each time a user logs out of Interlisp-D by evaluating (LOGOUT), thestate of virtual memory is stored in the logical volume in which the user was running. Virtualmemory can expand to a size no larger than the size of the logical volume.To create a sysout file named FORMS in filedrawer LISP on fileserver ALPHA, evaluate(SYSOUT '{ALPHA:}FORMS.SYSOUT) Installing Software from FloppiesLoad the floppy disk drive with the floppy labeled Installation Utility. Do a 2-boot. After about aminute, a menu of options will be displayed. The menu items permit you to (a) partition the localdisk into logical volumes, (b) install software on the Diagnostics volume, (c) initialize Lispvolumes with a fresh Interlisp-D sysout, (d) start Interlisp-D running on one of the Lisp volumes.Your Xerox 1108 arrives pre-partitioned and loaded with Interlisp-D. You will need theInstallation Utility each time you wish to install a fresh Interlisp-D sysout on a logical volumefrom floppies. Occasionally, a catastrophic software error may require you to re-partition thelocal disk.From time to time, new releases of Interlisp-D will be distributed to Xerox 1108 users. TheInstallation Utility should be used to install these new sysouts.Installing Software on the Diagnostics VolumeThis operation is perhaps the most complicated aspect of bringing up your Xerox 1108. Loadingthe Diagnostics volume requires careful adherence to the instructions in section entitledSoftware Installation. At the completion of this operation, the Diagnostics volume will contain:diagnostic software, the Install Lisp Tool, microcode to facilitate a 1-boot, and a file containingsite-specific information. In particular, you will be asked to supply names for your site's domainand organization. If you are running a Xerox NS Clearinghouse, these names must be the sameas those assigned when your Clearinghouse was created. If you are not running a Clearinghouse,then any names will do.Loading Interlisp-D PackagesXerox supplies two sets of floppies containing Interlisp-D software packages: Lisp Library, whichcontains software supported by Xerox; and Lisp Users, which contains user-written software notnecessarily supported by Xerox. To load selected files from these floppies, start Interlisp-Drunning from any Lisp volume, insert the floppy containing the file you need into the floppy diskdrive, and use the LOAD function to read the file into virtual memory. For instance(LOAD '{FLOPPY}GRAPHER.DCOM)will load the Grapher package into virtual memory; i.e., the functions and variables defined inthat file will now be defined in Interlisp's virtual memory. Alternatively, connect to the floppydevice with CONN {FLOPPY} and (LOAD 'GRAPHER.DCOM).When a file such as GRAPHER.DCOM is loaded, Interlisp-D attempts to automatically load allthe files on which GRAPHER depends. Interlisp-D will fail to locate those files if they are storedon a floppy disk other than the one loaded in the floppy disk drive. One solution is to useCOPYFILE to move files from Lisp Library and Lisp Users to a directory on a fileserver and loadNfr bNtrZ `]tr _] ]_ \J YTnV% S Ns]! KrNe JGc H_ G?b D7W Bb A._ ? <\ ;tr, 6Ks]- 3CrN^ 1trU 0;trL .c -3c +\ *+_ ( #s] rNMtr H*t r* ^ @a Td  _ b 3 Z xd \ pt rt r(  )=*\4from that directory.The Install Lisp ToolThe Install Lisp Tool is activated from the "base state" by clicking the left mouse button. TheTool can be used to display the names of all the logical volumes on your local disk, erase a logicalvolume, transfer a sysout from one logical volume to another or from a fileserver to a logicalvolume, and start/restart Interlisp-D on a particlar logical volume. The Install Lisp Tool iscompletely described in the the section entitled Software Installation.Maintenance Panel CodesTwo types of codes are displayed in the 4-digit readout on the Maintenance Panel: progress codesand error codes. Progress codes are displayed in the MP at various stages of booting and initialization. Forinstance, when the Xerox 1108 is powered up, the lights in the Maintenance Panel cycle from8888 to 0000 through 0199, 0200, pause at 0500, and begin counting up. Error codes are traps which freeze or blink the error number in the MP. They are usually fatalerrors. Codes 9000-9999 are displayed by Interlisp-D to indicate a system failure such as anerror in the address space manager or microcode errors. Occasionally it is possible to recover bypressing the STOP key. The STOP key attempts to activate a remote debugging facility,Teleraid, running on another Xerox 1108 or 1100 (see the Fugue.4 Release Notes for details.) IfTeleraid is not running, Interlisp-D will be restarted. If the failure persists, please note the MPcode and notify Xerox 1100Support.This section discusses a few frequently encountered MP codes. 0149 occurs a few seconds after power-up and indicates the local disk is not yet ready.0937 occurs after a 1-boot when the time and date are unknown. Time and date can be setmanually by 0-booting into Interlisp-D and using the SETTIME function, or by 2-booting the EIFixed Disk diagnostics floppy and responding to the prompts for setting date and time. When(SETTIME) is evaluated under Interlisp-D, the user is prompted to enter a string in the form "22-JAN-84 13:21:00". When the Installation Utility prompts for time and date, pressing "?" inresponse to each query will reveal what is expected from the user. Once time has been set,either logging out of Interlisp-D, or doing a 1-boot out of the Installation Utility, will return theXerox 1108 to its "base state". 0322 occurs when a 5-boot attempts to load software from the Fixed Disk Diagnostics floppy, andthe Xerox 1108 is not connected to the Ethernet. To force the booting process to continue, holddown Alt B until the MP code steps to 0323.The EthernetThe Xerox 1108 is equipped with a controller for 10 Megabit Ethernet. This permits the Xerox1108 to utilize the services of fileservers, printerservers, and non-Xerox equipment whichspeaks the appropriate protocols; it also allows the Xerox 1108 to communciate with other Xerox1108's and 1100's on the net. Each Xerox 1108 processor is uniquely identified with a 48-bit NShost address. This number is used to identify the Xerox 1108 in every NS network transaction.Since Interlisp-D also uses PUP protocols, which use 8-bit PUP host addresses, your Xerox 1108may prompt you for this number when Interlisp-D is started. Simply type in any octal number inthe range 0-255. Make sure no other machine on the same net has already been assigned thatnumber. In essence, each Xerox 1108 has two net host addresses: the 48-bit wired-in NS address,and an 8-bit, arbitrarily assigned PUP address. (Note: if a PUP ID Server is running, the PUPNfr bN ]Ks] ZCrN` Xd W;^ U^ T30t O`s] LXrNa J G[ FH\ DH A_ @7] >c =/V ;:tr :'e 8" 5> 2wrS /wrT .] ,] *a ){Qwr '\ &se $w !r[ b` urN! Is] ArN] [ 9_ ` 1^ ^ )Ptr [ a ^ U=+]5host number will be supplied automatically to the Xerox 1108.)Occasionally devices on the Ethernet may fail to communicate. One possibility is that the net,itself, is at fault; e.g., the cable is shorted, the terminators were trampled upon, the Ethernet tapsthemselves contain metallic debris and need to be cleaned, etc. To test that the network is alive,perform the following steps. Use any two machines on the net which are running Interlisp-D. (Ifyou choose an 1100, make sure it is running 10 Megabit microcode.) Call these Machine A andMachine B. On Machine A, type:\MY.NSADDRESSThe value of this variable looks like 0#0.1345.10654#0. Go to Machine B and type:(NS.ECHOUSER '0#0.1345.10654#)Note the number typed is the same as the number given on Machine A without the number afterthe second "#". If the test is successful, you will see a pattern such as:!+!+!+!+!+!+!+!+!+!+!+!+The ! indicates a successful packet transmission; the + indicates the packet was successfullyechoed back. Anything else indicates the net is down. If you suspect the net is shorted, unscrewthe taps, one-by-one, of each machine on the net. When the offending tap has been removed, theeach test will display !+!+!+!+!+!.Copying Files Between MachinesXerox 1108's and 1100's can communicate amongst themselves on the Ethernet. A simple formof such communication is moving files between machines. This operation is PUP based, and assuch requires that PUP host addresses have been assigned to the communicating machines. Forexample, to move file FOO from your machine to a machine with PUP host address 456, withboth machines on the same net, do (COPYFILE 'FOO '{0#456#}FOO)To copy file FOO from filedrawer AI on fileserver ALPHA to a Xerox 1108 on net number 3 withPUP host address 123 while seated at your machine, type:(COPYFILE '{ALPHA:}FOO '{3#123#}FOO)Note: file transmission is enabled when the PUPFTP process is running on the target machine.To activate this process, first load FTPSERVER.DCOM from the Lisp Library, then evaluate(ADD.PROCESS '(\FTPSERVER).The Floppy Disk DriveThe floppy disk drive is used by the Installation Utility for loading the Xerox 1108 with Lispsysouts recorded on floppy disks. The drive is also supported, with a few restrictions, byInterlisp-D. Consult the section entitled I/O Support for a complete description.Interlisp-D defines a device, {FLOPPY}, which allows file operations to be carried out on floppies.An additional operation, (FLOPPY.FORMAT name) initializes a floppy for writing. Operationssuch as LOAD, MAKEFILE, COPYFILE , READ, PRINT, and TCOMPL are all supported.SummaryThis section is meant to review the flow of day-to-day operation of your Xerox 1108.Your Xerox 1108 arrives, with its 42 Megabyte local disk pre-partitioned. Each of the three Lispvolumes has been loaded with identical versions of the Interlisp-D sysout. The first time youpower up the machine, an automatic 0-boot will start Interlisp-D running on volume Lisp.Having defined functions, set the value of global variables, etc., you (LOGOUT), which saves theNfr bN> __ ]f \c Za Y\ W$+U* RRyPz N#[ LKJG Gwr1wr& Fkb D_ Cc# @s] = rNZ ;\ :\ 8Z 6# 4 2L] 0%tr.q* ,\ *X ) %s] "rN^ !6[ +t r c &[ M s rT a ;^ X 3`  =<^6state of your work in volume Lisp. Within a minute or two, the Xerox 1108 enters its "basestate", and a white window bounces across a dark background.You bring up the Install Lisp Tool and start Interlisp-D running from volume Lisp3. You (oranother user) begins a project in volume Lisp3 and eventually logs out. The machine returns tothe bouncing window. You power down the machine and leave for the night.The next day, you power up the machine and do a 1-boot. Within a few minutes, the whitebouncing window comes up. You summon the Install Lisp Tool and restart Interlisp-D fromvolume Lisp3. After a morning's work, you write a sysout to your fileserver, thereby saving thestate of your work. This sysout can be re-installed into any Lisp volume by using the Install LispTool. A new version of Interlisp-D arrives in the mail. You install the new sysout on volume Lisp2 by2-booting the Installation Utility and selecting the appropriate menu items.A few days later, you wish to experiment with the sysout you saved on your fileserver. You bringup the Install Lisp Tool, type in the name of the file where your sysout is stored, chose the logicalvolume which is to receive the sysout, enter your name and password, and select the Install File!command. Your sysout is intalled , and you select the Start Lisp Volume! command to run the sysout.Nfr bN\ `< ]\ \_ ZI WX UX Ty` Rc Qq Ni` LM Ia HYe FTu EQrN7u rNN E <#\CLASSIC TIMESROMAN CLASSIC CLASSIC CLASSIC GACHAGACHACLASSIC : +$ 5(,j//-]Overview.bravoSANNELLAMarch 30, 1984 9:37 AM