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?NoDoyouwanttochangetheaddressforerrorlogging?No b6p b6 b6 ` wN%X/b99`q` S'-). 249` _)p _) ]r("] \ \ Z T_\ $&(D-399p:=m?BDJJ6J6Z YI!4 (H*W 145>7;=\@DDY W 5  WsWWrWB?!Z ) 01F369>B|CCW U i1b!&( .2U Tx Tx R  ;%  #%'-Q7F7=>?B:CHGHGR Qr 6 "s$ ,-D/57Z @BI*I*Qr O  "c$; +|-0?0:u< DGHHO NlYO fNl L L Kf]0  n" )+ 46y8 B(EHHKf I$ *9%(A(*|.C265C9;E>DFFI H`|H` F F Ep E Dqsw"&*,3558=+D Bp B @r G*" '*,@./0357<@3 GG@ ?rt"l#&(.o068:=@BEHH?r = z#& ##(j,G 3$58:Z<>ABIEkHUHU= A:GHH3Z 1Y9"h# )+`/;2%6;=@A@CfHHjHj1 0T`{,0T . . -p wN%h- ,* ,* *r Gd* )Op )O ' wN%' & & %r}!R%-&U)@-1.o 7;;@8ESFF% #!} "# "Ap "A w   wN% 9 Nb#M&)49  N9l (W03H  Nbl"v$$).+ 1 X$$).-a48L:C7C71 t *p0 n wN%XC #M'+19#;B`FIn  wN%l $+.>  wN%/ #M&+.> f wN%X&)4f    wN%!#S ^ ^ r={x*96!N"&h(.0M O O p wN%Xl$$).013H P wN%Xl#M&-a05=V>-?P { q?[Doyouwanttochangememoryerrorparams?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.OthelloistheMesadevelopmentenvironmentutilityformanagingPilotVolumesasdocumentedin"MesaUser'sGuide" b6p b6 wN%Xl#M)..846b6 ` wN%`t`>!#5'(`p`'.` _s wN%"v"v_st_s(-_sp_s- _s ^ wN%X$$^t^'X(u,h^p^,n^ \ \ [r L %}(h,.13#5;575:<:>U@CDI'I'[ Y I?"(-2-2YtY 3YrY3^4:G=@`@`YtYBYrYBD0FH8H8Y W  V!0&),.0x3:=tW Vp V UH UHtUH UHpUH + 4 >UHtUHA1UHpUHA7UH S StSSpSS Rr Rr Pr WN !3$a%(I+++P Op O N? N? Lqsw"&*,3558<CJJL K K I}p I} Gr < z $)&Z)p-/ 68?AAGpG J?GrGJJG Fet$US"9 * +H12H2HFepFe3?FerFe@ANC JJFe D{B!D Cp C B2 B2 @qsn#''+-1L5~@ ?%p ?% =rujv% %x(W*,.3|45369<>=@F0G8G8= <   Z"&(A+A/00 8<=BDZG;IlIl< :!: 9 9 7 GS=Bh@ "%k'*.194#9=9<>AEH&H&7 6 5: % #.&})+),.1#59x<??B8FGJKJK6 4 zIT C%&*y.36b9L=?DUH2H24 3*"L&H).24G7\8;=AFbHH3 1[~A c&(*b,268T@CDGHH1 / _U3 !/ .{ .{ , hP, +p + *Q wN%*Qt*Q 5*Qp*Q,*Qu*Q 54*Qp*Q5:*Q ( ( 'Zr mk f!$(('Zt'Z 11'Zr'Z3679::::'Zu'Z B'Zr'ZBDD'Z %v UU%r%s#%t))%u% 2Q%r%24a4a%v% =%r%>3@BEQGG% $\ZS! '*k 1(69;@=qBEAII$ " {e*"u" "r" q")")"v" ,R"r",/%1@358TAD]FF s8>s   mcj g"m p   wN%h n n r kwP= #r%(+z.0 p  ; wN%;   Wr .fO!x!!W p    &q $("&(X.149 & q q r " - !'|),k.25 ;A}AFGJJ 7m i D"$#*<-Q24[ <=AEJnJn7  q?[NfromtheOfficeSystemsDivision.OthellocanbeusedtoinstallInterlisp-D.YoumustfirststartbybootingtheOthelloutilityonyourmachine.Toboot(start)aDandelion,locatethemaintenancepanelunderthefloppydrive.Nexttotherednumbersyouwillfindtwobuttons,labelled"BReset"and"AltB".Presstheleftbootbutton(BReset)andwaitaboutaminutewhilediagnosticsrununtiltheinstalledbootprogramappears.Ifyouwanttoskipoverdiagnosticsyoucandoan"Alt-Boot-1",otherwiseknownasa"OneBoot".Thisisdonebypressingbothbuttons,thenreleasingtheleftbuttonwhilestillholdingdowntherightbutton.Therightbuttonshouldbereleasedwhenthemaintainencepanellightsays0001.[Thereareinfact10so-calledbootoptions:thelightswillcyclefrom0001to0010whileholdingAltBafterpressingbothbuttonsandlettinguponBreset.]TheprogramyoustartmaybeOthello,Star,Tajoornothing.Ifyoudon'tgetOthellofromtheharddisk,youmaybeabletobootOthellofromtheEthernet.Tryan"Alt-Boot-3"--i.e.,pressbothbuttons,releaseB-resetwhileholdingdownAlt-B,waituntilthelightsshow0003,andthenreleaseAlt-B.Afterafewminutes,youshouldbeinOthello.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.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 br b*[Xji$*&(J+W,0 77b ` ` ^  b:k$,'),247;UC"&T( , .1s5$6!:>' DGVJlJl[ Zs #ii Q!$.'\(+. 5L7:1< = FFZs X>Ah"#'+(. 1,6H9?>@C?GGX WmvY#C%)-N13[8w;>. FaIIWm U Jpn &%(-/3}59;F>N[ LP"e} #Z'*-058 :=?vD7FFL KUd<!#'*-/25(8BE)E)KU I   &&*F,/m25{8E;[?AFFI HO2HO F F EI.EI C C Bwpb9 (W*Bw AX C *, 7{A ? "v&++? >o >o == ;r ; :KH"S!'*.s/2P5h9>JA4C E~E~: 8EDm %'*q-1@6|9g:d=NB GIQIQ8 7 'O%'.)R*-04Z6=?7 5 5 40p 40 2 ?2 1Xh1 /r / .q @M !$*+/#14]6:T:<>ABFII.q , #y, +k +k )p N)r)])p)&0M) (\r (\ & mYHJ"q(*, .u25:=m>BEIrIr& %V ._1!#&^'*,.X058;AD-FIEIE%V #6g #c *.u0367AGJ J # "P 2!N )-0s4|7;>$ EZEZ"P #T=")d+1~46, =A?rB0CGJJ J\"X& ')-0l347;AIDFTJ   DpCDrDIDWWp(r)-0_4'79?|ACFF,@! (*.02557D9u<)@, & & pCrIf"'*/ 17:?B:D   p$r%# *.3L66;H=@A4CC   !#%'G(D+C0    p#(W r (] p" ). 2z7;j>BEEp B q?[ (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:(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-density brby" ).\/13m458=>Q@EHHb`=!]$j'U* ,3$5^8_:>AG^` ^ ^ ]y Ga ! "&,R.1736=7;"?EHxHx]y [ P&[ Zs Zs X X Wm Wm U U Tg Tg Sp (.>S Qr Q P  mH&)+.368:v:>@YCFIsIsP N 4"%0)*6*`KrK?C0EFFK I__IpI IrIvIpI (>IrI(..IpI>IrI?CFFI Hhp /HhrHhHhpHh"HhrHh"%'4*@-13c68=7@CHHHh F zj[!%>(J-#/3}4 < ?AFFBS @ ]~ f" *h.0'5M =(@aEE@ ?M 4$.1L27D<> DFF?M = ,2= <A'CXHH9A 7*]u?!& 0268:[7 6; 6; 4q $v *~4 3r 3 1  i #H ) /U1-2 :?CIBIB%6 # '#>'<)l+-317;A$A|DfHH# "0 z+ !7"&+ 4[58 :A BB"0 v * *  < zO*"%$V'k*)-25E8s9>v?sB3F\JJ $ z$p$($r$)/N1$   q $"'S+/ `r `  D"?#(-O17:: p-0 r   D  $)'/V05p6Y6Yr <CEpFF '(-a.8.>' r  q $ &}*1&6  cr c -d"$O%L'*+./5#9=BzDFF ] ( #$!&+/2T379g<< EUEU] q?[double-sidedfloppies.DocumentationformakingasetoffloppiesfromaSYSOUTfileiscoveredinthefile[eris]Current>MakeLispFloppies.Tedit.Wewilluponrequestmakeavailablesetsoffloppiesforourstandardreleases. br b H "'$6()+-e2i56<>@EFHHb ` ,+(p*-H05P8>]@B[G_InIn` ^ N^ ]y ]y q?[h HELVETICA ~GACHA  HELVETICA  TIMESROMAN  TIMESROMAN  HELVETICA ~GACHA < & T" --3.j/1/6*{ERIS}CURRENT>GETTINGSTARTED.TEDIT;1 SANNELLA.PA31-Jul-84 11:00:16