GettingStartedinInterlisp-DatXerox[eris]Current>GettingStarted.teditThisdocumentisintendedasasupplementtotheInterlispReferenceManual.IttellsyouhowtoconfigurelocaldisksofDorados,Dolphins,andDandelionsforInterlisp-D,anditsayswheretofindvariousimportantfiles.ThisisnotaguidetoprogrammingInterlisp-D.ThefirstthreesectionsapplytoDolphin/Doradousers;theremainingsectionstoDandelionusers.AtXerox,theLispfilesaregenerallykeptonthedirectoryCurrent>.PackagesthatcanbeloadedintoLisparelocatedonLibrary>and.ThepackagesonLibrary>aresupportedbytheInterlisp-Dsupportgroup;thoseonarenot.(Library>andformapartitionoftheold.)NewusersshouldaddthemselvestothedistributionlistLispUsers^.PAtogetannouncementsaboutnewreleases,workaroundsforcommonproblems,etc.Asusual,pleasesendreportsofbugs,anomaliesorrequeststoLispSupport.PA.(Dorado/Dolphin)Theveryfirsttime--Settingupthedisk:IfyouaresettinguponaDolphin,youprobablyhavetosetupyourdiskforrunningLisp.Interlisp-DcurrentlyrunswiththeAltofilesystem,atleastonDolphinsandDorados.IfyouhavePilotonyourdisk,youwillneedtoreserveanAltopartition.Decidewhichpartition(s)youwanttouseforLisp.(TheonlyasymmetryonDolphinsbetweenthepartitionsisthatwhenthemachineisinitiallybooteditwillcomeupinpartition1.TobootPartition2,holddownthe0keywhilepressingthebootbutton.)ThestandardDoradomicrocodeobtainedfromthenetworkstartsyououtinPartition5;youhavetoholddowntheappropriatekey(1,2,3,4,5)toanyotherpartition.)Youshouldnow(re)initializethedisk.(Thisprocedurewillerasethediskpartition.Ifthereissomethingthatyouwanttosaveonthepartition,FTPittoyourlocalfileserverandretrieveitafterthisprocedureisfinished.Itispossible,thoughnotusuallydesirable,toinstallLispwithouterasingthedisk;seebelow.)First,gettotheNetExec,bysaying:>NetExecIfyouwantpartition2,say:>Partition2Then,getanewoperatingsystemandinstallit(thisdialogisapproximatelycorrect.NewerversionsofNewOSaskaboutchangingpartitions):>NewOS.bootDoyouwanttoinstallthisOS?YesDoyouwantthelonginstallationdialogue?YesDoyouwanttofirsteraseadisk?YesTypethenameofahostfromwhichAltoprogramscanbeobtained:YourFileserverIfthisisMaxcoranIFS,thisshouldprobablybe'Alto',...:AltoIncludeDP1inthefilesystem?YesUseall14sectorsoftheDisk?YesDoyouwantabigSysdir?YesTypeOKwhenready:OK(Therewillbeapauseforaminuteorsowhilethepartitiongetserased.)Doyouwanttodisableerrorlogging?No b6p b6 b6 ` ` _T wN%X/b99_Tq_T S'-). 249_T ]p ] \Er("\E Z Z Y? T_\ $&(D-399p:=m?BDJJ6J6Y? WI!4 (H*W 145>7;=\@DDW V9 5  V9sV9V9rV9B?!Z ) 01F369>B|CCV9 T i1b!&( .2T S S Q  ;%  #%'-Q7F7=>?B:CHGHGQ P 6 "s$ ,-D/57Z @BI*I*P N  "c$; +|-0?0:u< DGHHN MYO fM K K J]0  n" )+ 46y8 B(EHHJ H$ *9%(A(*|.C265C9;E>DFFH G|G E E D6p D6 Bqsw"&*,3558=+B A)p A) ?r G*" '*,@./0357<@3 GG? >t"l#&(.o068:=@BEHH> < z#& ##(j,G 3$58:Z<>ABIEkHUHU< ;^ &'*.0L56;@A;CG0IJJ; 9Y" $&N'V)-A2h47<?RDII9 8l"S!y$'f)+,02479?A:GHH2 0Y9"h# )+`/;2%6;=@A@CfHHjHj0 .`{,. -y -y ,*p wN%h,* * * )Fr Gd)F 'p ' & wN%& %G %G #r}!R%-&U)@-1.o 7;;@8ESFF# "8!} ""8 p  w  9 wN%9  Nb#M&)4  N9l (W03H 1 Nbl"v$$).+1  X$$).-a48L:C7C7 t *p0  wN%XC #M'+19#;B`FI  wN%l $+.> f wN%/ #M&+.>f  wN%X&)4   ^ wN%!#S^   zr={x*96!N"&h(.0M z  p P wN%Xl$$).013HP N q?[Doyouwanttochangetheaddressforerrorlogging?NoDoyouwanttochangememoryerrorparams?NoUsername?yourname,orPublicDiskname?PartitionpartitionnumberDoyouwantapassword?no,ifPublicAllofthiswillgiveyouaverycleanpartitionwithhardlyanyfilesatall.InordertogetthefilesnecessaryforrunningLisp,executethefollowingcommands(wherefileserveriscurrentlyERISandsiteisoneofCIS,KSA;siteadminstratorsatotherlocationsmayhavesetupothercommandfiles):>Ftpfileserverdirectory/cLisp>Currentretrieve/cNewUserDisk.site>@NewUserDisk.site@ThiswillbringallofthefilesthatyouneedtorunLisp.(Dorado/Dolphin)Theveryfirsttime--Settingupthediskwithouterasingit:ItispossibletoinstallLispwithouterasingthedisk,merelybyperformingthecommandsinNewUserDiskwithoutfirstdoingtheerase.NotethatperformanceisdegradedifLisp.VirtualMemisnotcontiguous,althoughthesystemshouldstillwork.(Dorado/Dolphin)EachtimeyouwanttorunLisp:Assumeyouhavejustbootedyourmachine.Youwillbeinpartition1.IfyouwanttobootPartition2directly,holddown"0"(zero)whileyoupushthebootbutton.Alternatively,wheninPartition1,typethecommandPartition2.IfyourLispfunctionfilesareonanIFS,youcanloadthemfromLispdirectly.Lispwillalso(soon)talkdirectlytofilesonotherpartitionsonthesamedisk,ortoNSfileservers.MaxcalsorunsafileserversothatyoucanjustLOADorMAKEFILEdirectlytoMaxc.Note,however,thatLispprefersfileserverswhichspeakthe"Leaf"protocol,becausethatallowsdirectrandomaccesstofiles.Ifyourfileserverdoesn'trunLEAF,youwon'tbeabletodoLOADFROM,orusethe"remake"optionofMAKEFILE(whichsavesalotoftimeinprogramdevelopment.)YouarenowreadytorunLisp.>Lisp[yourfileserver]Current>lispsysoutwillbringoverafresh,cleanversionofLispfromyourfileserverandstartitup.lispsysout=LISP.SYSOUTwillgetyouthestandardlispsysout;lispsysout=FULL.SYSOUTwillgetyouthestandardsysoutenhancedbysomelibrary>andpackagessuchastheInterlisptexteditorandmailsystem;andlispsysout=DEMO.SYSOUTwillgetyouthefullsysoutenhancedbysomepackagesusedinthestandardInterlispdemo.LOADyourfiles(fromyourdiskorfromtheIFS),andyou'reonyourway.WhenyouwanttoleaveLisp,ifyoutype_(LOGOUT)itwillsaveyour"virtualmemory"sothatthenexttimeyoutype>LISPitwillresumefromwhereyouleftoff.(Dandelion)TheVeryFirstTime--SettinguptheDisk:OnanewDandelion,itisnecessarytoconfigurethediskandinstalltheInterlisp-Dsoftware.Othelloisthe b6p b6 wN%Xl#M&-a05=V>-?b6 ` wN%Xl#M)..846` _ wN%_t_>!#5'(_p_'._ ^ wN%"v"v^t^(-^p^- ^ \ wN%X$$\t\'X(u,h\p\,n\ [E [E Yr L %}(h,.13#5;575:<:>U@CDI'I'Y X6 I?"(-2-2X6tX6 3X6rX63^4:G=@`@`X6tX6BX6rX6BD0FH8H8X6 V  V!0&),.0x3:=tV UHp UH S StS SpS + 4 >StSA1SpSA7S R RtRRpRR Q Q Or WN !3$a%(I+++O N?p N? L L K]qsw"&*,3558<CJJK] I I H%p H% Fr < z $)&Z)p-/ 68?AAFpF J?FrFJJF E t$US"9 * +H12H2HE pE 3?E rE @ANC JJE C{B!C B2p B2 @ @ ?Pqsn#''+-1L5~?P =p = =@F0G8G8AEH&H&65 45: % #.&})+),.1#59x<??B8FGJKJK4 3/ zIT C%&*y.36b9L=?DUH2H23/ 1*"L&H).24G7\8;=AFbHH1 0)[~A c&(*b,268T@CDGHH0) . _U3 !. -# -# + hP+ *Qp *Q ( wN%(t( 5(p(,(u( 54(p(5:( ' ' &r mk f!$((&t& 11&r&3679::::&u& B&r&BDD& $cv UU$cr$cs#%t))$cu$c 2Q$cr$c24a4a$cv$c =$cr$c>3@BEQGG$c "\ZS! '*k 1(69;@=qBEAII" !? {e*!?u!? !?r!? q")")!?v!? ,R!?r!?,/%1@358TAD]FF 8>   cj g" p  n wN%hn   r kwP= #r%(+z.0 ;p ;  wN%   r .fO!x!! p  X X q $("&(X.149   br " - !'|),k.25 ;A}AFGJJb q?[SMesadevelopmentenvironmentutilityformanagingPilotVolumesasdocumentedin"MesaUser'sGuide"fromtheOfficeSystemsDivision.OthellocanbeusedtoinstallInterlisp-D.YoumustfirststartbybootingtheOthelloutilityonyourmachine.Unfortunately,therearemanywaystogetintoOthello,manyofwhichmaynotworkforyou.Herearemanydifferentprocedurestotry.Inallcases,toboot(start)aDandelion,locatethemaintenancepanelunderthefloppydrive.Nexttotherednumbersyouwillfindtwobuttons,labelled"BReset"and"AltB".Thephrase"Alt-Boot-N"meanstoholddownbothbuttons,andthenreleasetheleftbutton(BReset)whileholdingtherightbutton(AltB).Whenthepanelreads000N,letupontherightbutton.(Thereare10so-calledbootoptions:thelightswillcyclefrom0001to0010whileholdingAltBafterpressingbothbuttonsandlettinguponBreset.)BootingOthellofromdisk:Doan"Alt-Boot-1".IftheDisplayreads"Othello10.0",youwin.Otherwise,presson.BootingOthellofromEthernet:Tryan"Alt-Boot-3".Afterafewminutes,youshouldbeinOthello.Ifthedisplayreads"Othello10.0"atthetop,youwin.Insomecircumstances,youwon'tgetOthello10.0,e.g.,ifyouareonCSL's10MBEthernet,inwhichcaseyouwillbeinCedarOthello.Inthatcase,presson:TryAlt-Boot-6.Thelightsshouldthenshow"7777".Atthatpoint,pressAlt-Bagain.Whenthepanelshows"0003",letup.BootingOthellofromFloppy:IfyoucannotbootfromtheEthernetyouwillneedanOthello10.0bootablefloppy.Insertitintoyourfloppydrive,labelsideup,closethedrivepanel,andfollowthedirectionsaboveforthetwo-fingeredbooting,exceptthatyoumustnowwaituntil"0002"isdisplayedbeforereleasingtherightbutton.Othellowilldisplayaherald,e.g.:Othello10.0of1-Mar-8318:06:30PSTProcessor=0AA001EE1H=25200017347B=2-852-134-631Memorysize=1536Kbytes=768Kwords>OnlineDrivename:RD0Typea"carriagereturn"totheOnlinecommandafterRD0.IfyouhaveneverinstalledLisponthismachinebefore,youwillneedtoreconfigurethediskintologicalvolumeswithaLispvolumesufficienttoholdInterlisp-D.Usethe"Login"commandtologinwithyournameandpassword,e.g.:>LoginUser:Masinter.PAPassword:******Howyoupartitiontheharddiskofthe1108dependsonwhatsizediskyouhave.Ifyouhavea10MBdisk,thecommand:>@[eris]Current>Partition10Lisp.othellowillconfigurethediskintothreelogicalvolumes,oneof800pagescalledOthello,oneof3200pagescalledDsk(forthelisplocalfilesystem),andtherestofthediskinthevolume,Lisp.ThiscommandfilewillalsoinstallOthellointothefirstvolume,sincepartitioningerasesthedisk.Thisisusuallytherightcommandfileforthe10MBytedisk8010Dandelionconfiguration.Userswithbiggerdisks(eitherthetwo-cabinet29MByteSA4000orthenewer40MByteQuantum)willprobablywanttoreconfigurethediskinotherways,dependingonwhatotherprogramsonewantstorunalongwithLisp.Someothercommandfilesare:Partition29Lisp.othelloThesameasPartition10Lisp,exceptthat16200pagesareallocatedfortheLispvolume(themaxthatInterlisp-Dcanuse),andtherestfortheDskvolume. br bm i D"$#*<-Q24[ <=AEJnJnb `*[Xji$*&(J+W,0 77` ^ ^ ]y  b:k$,'),2 ;>ADGIcIc]y [ j "&;(J+).n0409 @xADIEGG[ Zs "$ ,036":K=>SACEAGGZs Xru4$&+-0h2359 BOFdGGX Wm >5#%(,B-25:j<?CFHHWm U  !w#&+a/139<A,C]FI\I\U Tg5m!y#$'-0&47s;=j?B@DTg R R QwQ Or O Nt " 5#(u,<.1 8?;=kNt L L KweK Jr J H d#\%*.+-q236:>CqFHKJ|J|H F  #S&) -0347O9u;M?*CHJiJiF E{U"$x'*/-~/}E{ C C Bu d T!%)+.V25k8<@BFtJQJQBu @x@ ?o ?o >&wH>& >o FJFJ9| 7"Biw"A%W)+ 05:<?D97 6v 6v 4.4 3p 3p 2!pb9 (W*2! 0X C *, 7{0 /q "v&++/q . . ,, +5r +5 )KH"S!'*.s/2P5h9>JA4C E~E~) (/EDm %'*q-1@6|9g:d=NB GIQIQ(/ & 'O%'.)R*-04Z6=?& %) %) #p # " ?" !*Xh!* r   @M !$*+/#14]6:T:<>ABFII  #y   p Nr]p&0M r   mYHJ"q(*, .u25:=m>BEIrIr  ._1!#&^'*,.X058;AD-FIEIE }6g #c *.u0367AGJ J }  2!N )-0s4|7;>$ EZEZ w#T=")d+1~46, =A?rB0CGJJw \"X& ')-0l347;AIDFT q q pC r I  bWW bp b( br b)-0_4'79?|ACFF b@! (*.02557D9u<)@ q?[Partition43Lisp.othelloAllocatesfourvolumes,Othello(800pages),Lisp(16200),Lisp2(16200),andDsk.Partition29or43LispTajo.othelloAllocatesthreevolumes,Diagnostics(16000pages),Lisp(16200),andDsk.TheDiagnosticsvolumeissetupasaTajovolume.Partition29or43LispStarTajo.othelloAllocatesfivevolumes,Diagnostics(10000pages),System(6100),User(8000),Lisp(16200),andDsk.TheDiagnosticsvolumeissetupasaTajovolume.TheSystemandUservolumescanbeusedwithStar(thiscommandfiledoesnotinstallStar,however).Ifyouwantsomeotherconfigurationoflogicalvolumes,youcaneditanyoftheseothellocommandfileswithanyeditor.Thecommand:>@[eris]Current>InstallLisp.othellowillinstall[eris]Current>LISP.SYSOUTontotheLispvolumeandstartit.(Usersatothersitesmayfindsimilarcommandfilesontheirlocalfileserver.)ThecommandfileInstallFull.othelloisidenticaltoInstallLisp.othello,exceptthatitfetchesFULL.SYSOUTinsteadofLISP.SYSOUT.Likewise,InstallDemo.othellobringsoverDEMO.SYSOUT.TofetchotherSYSOUTfilesofyourownmakingorfromfileserversotherthanPhylum,youcaneditthe.othellocommandfileusingyourfavoritetexteditorasappropriate.Note:OthellonetworkcommunicationisbasedonPUPcommuncationover10MBEthernet.Presently,theMesa/OthellosoftwarewillonlytalkPUPsifagatewayorotherserverexplicitlytellsititsnetnumber(otherwise,itwillhangwitha981inthemaintenancepanel.)AnetworkadminstratormustregisterDandelionsinthegatewaytables.MessageNetSupport.wbst(or,atPARC,PTS.PA)forassistanceifnecessary.ItispossibletoinstallLispdirectlyfromtheMesadevelopmentenvironment(Tajo,10.0)insteadofOthello.Tajo-basedtoolsInstallMu.bcd,LispTool.bcdareavailablewhichcaninstallSYSOUTsovertheEthernetfromXeroxNS8000seriesfileservers.ContactLispSupport.PAformoredetails.(Dandelion)ReturningtoMesa/Star:TobootMesa/Star,providedithadbeenpreviouslyinstalled,doan"Alt-Boot-1"asdescribedabove.FrominsideLisp,the(LOGOUT)functionwillautomaticallycausean"Alt-Boot-1"aftersavingyourstate,sothatitispossibletoswitchbackandforthbetweenMesaandInterlisp-Dwithouttouchingthebootbutton.(LOGOUTT)willswitchwithoutsavingstate;aconvenienceifyouarereturningtoMesamerelytoretrieveanewversionofLisp.(Dandelion)EachtimeyouwanttorunLisp:Toreturntoapreviouslysavedstate(e.g.,savedviaaSAVEVMorLOGOUT),performasimplemachineboot(eitherbypressingB-reset,machinepoweron,orthe"Quit"commandinsideOthello).Thisreturnsyoutothesavedcomputation,similartotypingsimply"Lisp"totheAltoExecutiveonDolphins/Dorados.ItisnotpossibletoinstalldirectlyfromthelocaldiskusingOthello,andthus,tore-startanewvirtualimage,youmustreexecutetheInstallLisp.othellocommandfile.(Dandelion)ToremoveLispfromyourdisk: brbb ` ` ^pC^r^I^]pf"'*/ 17:?B:D]p [ [ Zjp$ZjrZj%ZjX# *.3L66;H=@A4CCXW[  !#%'G(D+C0W[ U U TUp#(WTUrTU(]TUR" ). 2z7;j>BEERQFy" ).\/13m458=>Q@EHHQFO=!]$j'U* ,3$5^8_:>AG^O N@ N@ L Ga ! "&,R.1736=7;"?EHxHxL K: P&K: I I H4 H4 F F E. E. C C B\p (.>B\ @r @ ?M mH&)+.368:v:>@YCFIsIs?M = 4"%0)*6*<= `:r:?C0EFF: 98__98p98 98r98v98p98 (>98r98(..98p98>98r98?CFF98 7p /7r77p7"7r7"%'4*@-13c68=7@CHH7 6  zj[!%>(J-#/3}4 <<6 4 4 3s "#R'(+ 5 7;AB H'JXJX3 1 I3 $V%&+-.04{ :.<> ?AFF1 0 ]~ f" *h.0'5M =(@aEE0 . 4$.1L27D<> DFF. - ,2- + + * < z "$(u 0q 8L<?TCEaJyJy* (   %(-137><A'CXHH( '*]u?!& 0268:[' % % #q $v *~# "Gr "G   i #H ) /U1-2 :?CIBIBz  '#>'<)l+-317;A$A|DfHH t z+ !7"&+ 4[58 :A BBt v n n  < zO*"%$V'k*)-25E8s9>v?sB3F\JJ h z hp h( hr h)/N1 h [q $"'S+/[  q?[X(1)UsetheOthello"Initial"commandtoreinstallnormalinitialmicrocodefrom[iris|rain]10.0>basics>SAx000Initial.db(2)UsetheOthello"DiagnosticMicrocodeFetch"commandtoreinstalldiagnosticmicrocodefrom[iris|rain]10.0>basics>Moonboot.db(Dandelion)StartingInterlisp-DfromFloppyDisks:Interlisp-Dcanbesavedonfloppydisksinawaythatitcanbeinstalleddirectlyfromfloppies,viatheServicesInstallationUtility(Prometheus).TheDEMOsystemwillfiteasilyonfourdouble-densitydouble-sidedfloppies.DocumentationformakingasetoffloppiesfromaSYSOUTfileiscoveredinthefile[eris]Current>MakeLispFloppies.Tedit.Wewilluponrequestmakeavailablesetsoffloppiesforourstandardreleases. bq br b ` D"?#(-O17::` _0p-0_0 ]r ] \! D  $)'/V05\!p\!6Y6Y\!r\! <CE\!p\!FF\! Z(-a.8.>Z Y=r Y= Wq $ &}*1&6W Vr V T -d"$O%L'*+./5#9=BzDFFT R ( #$!&+/2T379g<< EUEUR Q| H "'$6()+-e2i56<>@EFHHQ| O ,+(p*-H05P8>]@B[G_InInO Nv NNv L L q?[F TIMESROMAN  HELVETICA ~GACHA  HELVETICA  TIMESROMAN  TIMESROMAN  HELVETICA ~GACHA t 6 " -q0j/31I3*{ERIS}CURRENT>GETTINGSTARTED.TEDIT;2MASINTER14-Aug-84 20:11:35