GettingStartedinInterlisp-DatXerox[phylum]Current>GettingStarted.doc13October1983ThisdocumentisintendedasasupplementtotheInterlispReferenceManual.IttellsyouhowtoconfigurelocaldisksofDorados,Dolphins,andDandelionsforInterlisp-D,anditsayswheretofindvariousimportantfiles.ThisisnotaguidetoprogrammingInterlisp-D.ThefirstthreesectionsapplytoDolphin/Doradousers;theremainingsectionstoDandelionusers.AtXerox,theLispfilesaregenerallykeptonthedirectoryCurrent>.(EarlyversionsofthereleasenamedFuguewerestoredonFugue>.)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.)p c/b6 q b6` oFyP'Z11`r` K'%)& 249`_) q _)] s(%%Z%'j,/K]\ \Z  LWT $& (<-399h:=e?BDBJ.J.ZY  A!, (@*O 14567;=T@DDYW -WtWWsW:7!R ) 01>369>BtCCWU a)Z!&(.1UTx TxR  3{RuRpM#&&(+2>>1>CVIvIvRQ$ s uSr"$` -.I368:>ADFFQ$O vN < %,%(--/ 8;%AjC8EiEiON \ 4 'u),8,6n8 @CDJ,J,NL  u LK KI U(  f" )+ 46q8 B EHHIH  "1%(9(*t.;2.5;9;=>DF{F{HF tFE E C q CB3 rko"&*,3-58=#B3@ q @?$ s ?"y"'*,8.'0 357<@+ G G ?$= l"d#&(.g067:=@BEHH=<  r #( + 25L8z9PAAE GG<: V &'*.0D56;@ A3CG(I JJ:9 Qz z$&F'N)-92`47<?JDII97 dK!q$'^)+$024797<7?B I.I.76  Q:} !b64 43   \!!%]+.(1w36f <$<|=A+BiHH3 1  ?m !]$R%z&*-/U335:;>A2GHH10 Q1`# )+X/326;x=@A8C^GHbHb0. Xs$.- -+ q oFy`+*Y *Y( s ?\('~ q '~&& oFy&&$ $#B su!J%%&M)8-).g 73;@0EKFF#B! u "! p q p o  oFh FZ#E&),h F1d (O03@ FZd"n$)&+` P$)&-Y48D:C/C/` v "q( oFP; #E'x+19;BXFI2 oFd $+.62 oF' #E&+.6 oFP&),* * oF!#K z z s5sp"1.!F"&`(-0E k } k  q  x q?[Doyouwanttodisableerrorlogging?NoDoyouwanttochangetheaddressforerrorlogging?NoDoyouwanttochangememoryerrorparams?NoUsername?yourname,orPublicDiskname?PartitionpartitionnumberDoyouwantapassword?no,ifPublicAllofthiswillgiveyouaverycleanpartitionwithhardlyanyfilesatall.InordertogetthefilesnecessaryforrunningLisp,executethefollowingcommands(wherefileserveriscurrentlyPhylumandsiteisoneofCSL,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>whichlisp.sysoutwillbringoverafresh,cleanversionofLispfromyourfileserverandstartitup.whichlisp=lispwillgetyouthestandardlispsysout;whichlisp=fullwillgetyouthestandardsysoutenhancedbysomelibrary>andpackagessuchastheInterlisptexteditorandmailsystem;andwhichlisp=demowillgetyouthefullsysoutenhancedbysomepackagesusedinthestandardInterlispdemo.LOADyourfiles(fromyourdiskorfromtheIFS),andyou'reonyourway.WhenyouwanttoleaveLisp,ifyoutype_(LOGOUT)itwillsaveyour"virtualmemory"sothatthenexttimeyoutype>LISPitwillresumefromwhereyouleftoff.(Dandelion)TheVeryFirstTime--SettinguptheDisk:OnanewDandelion,itisnecessarytoconfigurethediskandinstalltheInterlisp-Dsoftware.Othelloisthe c8b6 q oFPd$)&013@b6` oFPd#E&-Y05=N>%?`_ oFPd#E)&.046_^. oF^.v^.6!#-' ^.q^.'&^.\ oF"n"n\v\( ,\q\-\[X oFP$$[Xv[X'P(m,`[Xq[X,f[XY YXa s  D %u(`,.135357-:<2>M@~C<IIXaV  A7"(-*-*VvV 2VsV3V4:??/AAVvVCVsVDJEHIIVU CQ !!UuU(.+/K138?nCwUS q SRJ RJvRJ RJqRJ + 4 >RJvRJA)RJqRJA/RJP PvPPqPPOt OtM s OF!+$Y%(A+++ML q LKA KAI rko"&*,3-58<CJJIH  HF q FD s 4 r$!&R)h-/ 68?z@@DqD J7DsDJJDCg lMK"1 *+@1 2@2@CgqCg3?CgsCg@AFC JJCgA s: A@ q @?4 ?4= rkf#'+-1D5v=<' q <': smbn%%p(O*,. 3t45+69<6=@F(G0G0:9  R"&(9+9/0( 8z<=BDRG3IdId97 76 64  ?K5|:`8"%c'*-114959AEHH43 -2  #&&u)+!,.159p< >?B0FGJCJC3 1  rAL ;$&~*q.36Z9D=?DMH*H*10 ""D&@).24?7T8;=AFZHH0. Sv9[&}(*Z,268L@;DGHH.-  WM+ -+} +})  `H)( q ('S oFy'Sv'S -'Sq'S,'Sw'S4U'Sq'S:<'S% %$\ s ec ^!$( ( $\v$\ 1 1 $\s$\36w79:2:2$\v$\@*$\s$\@B:B:$\x$\Dk$\s$\DG>IYIY$\"  r s"v"!"s"":##"x"%"s"&8(*-V/48>@DD"! G ""%$&(.04w79>A8A8!v!G0!s!GI@I@!y xzysyMh!|z$s&A)/:2G35;b@DDIsIsy  eq/!.$'+,/23V3\U U [ b _" q + oF`+ G s coH5 #j%(|+r-0G q  oFyH H s &^G!p!!m q m   r  !&(P.1z49  s  % !'t),c.24 ;AuF6GtIII q?[sMesadevelopmentenvironmentutilityformanagingPilotVolumesasdocumentedin"MesaUser'sGuide"fromtheOfficeSystemsDivision.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:******Thecommand:>@[phylum]Current>PartitionLisp.othellowillconfigurethediskintotwologicalvolumes,oneof800pagescalledOthello,andtherestofthediskinthesecondvolume,Lisp.ThiscommandfilewillalsoinstallOthellointothefirstvolume,sincepartitioningerasesthedisk.Thisisusuallytherightcommandfileforthe10MBytedisk8010Dandelionconfiguration.Userswithbiggerdisks(eitherthetwo-cabinet29MByteSA4000orthenewer40MByteQuantum)willprobablywanttoreconfigurethediskinotherways,dependingonwhatotherprogramsonewantstorunalongwithLisp.Thecommand:>@[phylum]Current>InstallLisp.othellowillinstall[Phylum]Current>Lisp.SYSOUTontotheLispvolumeandstartit.(Usersatothersitesmayfindsimilarcommandfilesontheirlocalfileserver.)ThecommandfileInstallFull.othelloisidenticaltoInstallLisp.othello,exceptthatitfetchesFULL.SYSOUTinsteadofLISP.SYSOUT.Likewise,InstallDemo.othellobringsoverDEMO.SYSOUT.TofetchotherSYSOUTfilesofyourownmakingorfromfileserversotherthanPhylum,youcaneditthe.othellocommandfileusingyourfavoritetexteditorasappropriate.Note:OthellonetworkcommunicationisbasedonPUPcommuncationover10MBEthernet.Presently,theMesa/OthellosoftwarewillonlytalkPUPsifagatewayorotherserverexplicitlytellsititsnetnumber c8b se a <" $*4-I24S ;=xAEJfJfb` "SPb #&''*,w0R 77`^ ^]y  Z2c$$'),24z7z;M DGNJdJdZsX  aa I!$&'T(+.} 5D7:)<= FFXWm 69`"#'#(.1$6@97>@C7GwGwWmU nQ#;%)-F13S8o;>& FYIIUTg  Bhf %(-/3u593"%'O*.,14%7;r?WBCF6F6LKU H]u #R'*-05z8:}=?nD/FFKUI \4#'*-|/25 8yBE!E!IHO  &*>,/e25s8=;S?A FFHOF  *FEI EIC &CBC BC@ qZ1 (O*@? P ; *, 7s?>D  "n&++>D< <; ;: s :8 C@K!'*.k/2H5`8>BA,CEvEv87 =<e %z'*i-186t9_:\=FA GIIII75  wGw%'&)J*-04R6<?53 32 q 21U  71U/ P`/.q s .q,  ,+k +k* q ,1*( s ('  eQ@e!' )+(-1,4: <>A8BDGI2I2' %  |"% '*8.25|7:V?fB II%$ +!(.*h,w.4^7:4@ IWIW$" |- &c,0248>dDGPGP"! 7 L}!;"&*)0B25H8>ADFHHH!~ ydS~ x  x  q */ s   e@!(+-058(; <<ABkEHH  "%',--    q%s&I',.c.cq>Xs?C(EFF WWq snq (6s(..q>s?CEE q 'sq"s"%',*8- 13[68=/@CHH j  rbS!%6(B-/3u4 ?AFF q?[C(otherwise,itwillhangwitha981inthemaintenancepanel.)AnetworkadminstratormustregisterDandelionsinthegatewaytables.MessageNetSupport.wbst(or,atPARC,EESupport.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:UseOthellotoreinstallanormal[iris|rain]10.0>basics>SAx000Initial.dbandreinstalldiagnosticsfrom[iris|rain]10.0>basics>Moonboot.db(Dandelion)StartingInterlisp-DfromFloppyDisks:Interlisp-Dcanbesavedonfloppydisksinawaythatitcanbeinstalleddirectlyfromfloppies,viatheServicesInstallationUtility(Prometheus).TheDEMOsystemwillfiteasilyonfourdouble-densitydouble-sidedfloppies.DocumentationformakingasetoffloppiesfromaSYSOUTfileiscoveredinthefile[Phylum]Current>MakeLispFloppies.DOC.Wewilluponrequestmakeavailablesetsoffloppiesforourstandardreleases. c8b s Uyv ^" *`.05E = @YEEb` ~,$.1D27< @B HJJ`^ $*^]y ]y[  4 r"$(m 0i 8D<?LCEYJqJq[Zs   %(-1w37>4ACPHHZsX "Um7!& 0260:SXWm WmU r n *vUT5 s T5R   a #@ ) /M1%2 :LK# K#I r B!&(+0'IG s GFh  a^ i k#'3)B*?02/9>?CI:I:FhD  #6'4)d*-+179fDuD;BBDsDCEJnJnDC  r# !/"&+ 4S58:ABBCA nA@ @>  4 rG""$N'c*!-25=8k9>n?kB+FTJJ>=  r=q=(=s=)/F1=;| ;|9 r  "'K+/98D s 8D6  JW]65r q-05r3 s s3q33s3 3q332 (-Y.0.621 s 1/ r  &u*16/- s -,G %\"$G%D'*+./59=BrDFF,G*   #$&+/2L379_<4 EMEM*)A @ "$.()+-]2a56<>@DFHH)A'  $+*-Z/397;b@C]DII'&;  U&;$ $b q?[ HELVETICA ~GACHA  HELVETICA  TIMESROMAN  TIMESROMAN  TIMESROMAN  HELVETICA ~GACHA ~GACHA ]  #+oj/.,W*{PHYLUM}CURRENT>GETTINGSTARTED.DOC;6 STANSBURY13-OCT-83 14:46:39