GettingStartedinInterlisp-DatXerox[phylum]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?Nop c/ b6q b6b6 b6 ` `` wN%X/b99`r` '* 46:` _q __ _ ]s ]]*%G] \w \w\w \w Z ZZ T_\ $&(D-399p:=m?BDJJ6J6Z Yq YqYqI!4 (H*W 145>7;=\@DDYq W WW 5  WtWWsWSP!k ) 01W46:>BD D W Vk VkVk i1b!&( .2Vk T TT T Se SeSe  ;%  #%'-Q7F7=>?B:CHGHGSe Q QQ 6 "s$ ,-D/57Z @BI*I*Q P_ P_P_  "c$; +|-0?0:u< DGHHP_ N NNYO fN MY MYMY MY K KK]0  n" )+ 46y8 B(EHHK JS JSJS$ *9%(A(*|.C265C9;E>DFFJS H HH|H GM GMGM GM Eq EE E Dtr DtDtsw"&*,3558=+Dt Bq BB B Aes AeAe G*" '*,@./0357<@3 GGAe ? ??t"l#&(.o068:=@BEHH? >_ >_>_ z#& ##(j,G 3$58:Z<>ABIEkHUHU>_ < <<^ &'*.0L56;@A;CG0IJJ< ;Y ;Y;YY" $&N'V)-A2h47<?RDII;Y 9 99l"S!y$'f)+,02479?A:GHH3 2G 2G2GY9"h# )+`/;2%6;=@A@CfHHjHj2G 0 00`{,0 /A /A/A /A -q -- wN%h- , ,, , +s ++ Gd+ )q )) ) (g (g(g wN%(g ' '' ' %s %%}!R%-&U)@-1.o 7;;@8ESFF% $ $$!} "$ "q "" " !Y !Y!Y w !Y    wN%    Nb#M&)4 Q QQ N9l (W03HQ   Nbl"v$$).+   X$$).-a48L:C7C7 Ru RR *RqR0R   wN%XC #M'+19#;B`FI   wN%l $+.> 7 77 wN%/ #M&+.>7   wN%X&)4    / // wN%!#S/    Ks KK={x*96!N"&h(.0MK  yq y y y ! ! ! wN%Xl$$).013H !   wN%Xl#M&-a05=V>-? } q?[!Doyouwanttochangememoryerrorparams?NoUsername?yourname,orPublicDiskname?PartitionpartitionnumberDoyouwantapassword?no,ifPublicAllofthiswillgiveyouaverycleanpartitionwithhardlyanyfilesatall.InordertogetthefilesnecessaryforrunningLisp,executethefollowingcommands(wherefileserveriscurrentlyPhylumandsiteisoneofCIS,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" ^ b6q b6b6 wN%Xl#M)..846b6 ` `` wN%`u`C#M%*`q`*` _ __ wN%"v"v_u_*/_q_/_ ^. ^.^. wN%X$$^.u^.(W*/^.q^./^. \ \\ \ [Js [J[J L %}(h,.13#5;575:<:>U@CDI'I'[J Y YY I?"(-2-2YuY 2YsY2409>ATATYuYCMYsYCDG`HHY XD XDXD  V!0&),.0x3:=tXD Vq VV V U UU UuU bUqU9 #M .8 7u AUuUDUqUDU TE TETE TEuTETEqTETE R RR R Qas QaQa WN !3$a%(I+++Qa Pq PP P N NN N M0r M0M0sw"&*,3558<CJJM0 K{ K{K{ K{ Iq II I Hls HlHl < z $)&Z)p-/ 68?AAHlqHl IOHlsHlIIHl F FFt$US"9 * +H12H2HFqF2`@ GGF Ef EfEf{B!Ef Dq DD D B BB B A5r A5A5sn#''+-1L5~A5 ?q ?? ? >&s >&>&ujv% %x(W*,.3|45369<>=@F0G8G8>& < <<   Z"&(A+A/00 8<=BDZG;IlIl< ; ; ; !; 9 99 9 8 88 GS=Bh@ "%k'*.194#9=9<>AEH&H&8 6 665: % #.&})+),.1#59x<??B8FGJKJK6 5 55 zIT C%&*y.36b9L=?DUH2H25 3 33*"L&H).24G7\8;=AFbHH3 2 22[~A c&(*b,268T@CDGHH2 0 00 _U3 !0 / // / - -- hP- ,6q ,6,6 ,6 * ** wN%*u* #M*q*/*v* 8L*q*8R* ) )) ) 's '' mk f!$(('u' 00's'3579T99'v' ?`'s'?ApAp' &w && UU&s&$&+u+u&v& 1&s&233&w& =O&s&=@BjEGoGo& $ $$\ZS! '*k 1(69;@=qBEAII$ #q #q#q {e*#qv#q g#qs#qww#qw#q )#qs#q*:,.1X359?AE JJ#q ! !! a ^ %+(7*.14p69>;o>AQEZG2J>J>! k k k KQ k    e eecj g"e q     wN%h f ff f s  kwP= #r%(+z.0 q   3 33 wN%3    Os OO .fO!x!!O q      r  $("&(X.149 i i i i s  " - !'|),k.25 ;A}AFGJJ / / /m i D"$#*<-Q24[ <=AEJnJn /  q?[efromtheOfficeSystemsDivision.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:>@[phylum]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(16200),andDsk.TheDiagnosticsvolumeissetupasaTajovolume.TheSystemand ^ bs bb*[Xji$*&(J+W,0 77b ` `` ` ^ ^^  b:k$,'),247;UC"&T( , .1s5$6!:>' DGVJlJl[ Zs ZsZs #ii Q!$.'\(+. 5L7:1< = FFZs X XX>Ah"#'+(. 1,6H9?>@C?GGX Wm WmWmvY#C%)-N13[8w;>. FaIIWm U UU Jpn &%(-/3}59;F>N[ L LLP"e} #Z'*-058 :=?vD7FFL KU KUKUd<!#'*-/25(8BE)E)KU I II   &&*F,/m25{8E;[?AFFI HO HOHO2HO F FF F EI EIEI.EI C CC C Bwq BwBwb9 (W*Bw A AAX C *, 7{A ? ?? "v&++? >o >o>o >o = === ;s ;; ; : ::KH"S!'*.s/2P5h9>JA4C E~E~: 8 88EDm %'*q-1@6|9g:d=NB GIQIQ8 7 77 'O%'.)R*-04Z6=?7 5 55 5 40q 4040 40 2 22 ?2 1 11Xh1 /s // / .q .q.q @M !$*+/#14]6:T:<>ABFII.q , ,, #y, +k +k+k +k *q ** .3H* (s (( ( ' ' '  mYHJ"q(*, .u25:=m>BEIrIr' % %% ._1!#&^'*,.X058;AD-FIEIE% $ $$6g #c *.u0367AGJ J $ " "" 2!N )-0s4|7;>$ EZEZ" ! !!#T=")d+1~46, =A?rB0CGJJ! ~ ~~\"X& ')-0l347;AIDFT~    q CsI   WW q %c s &*3,0466\;=@/CGJ{J{ S !1#&)/+`-/249    Hq HHCHsHIHf"'*/ 17:?B:D 9 99 9 q $s%^^^# *.3L66;H=@A4CC^   !#%'G(D+C0 X X X X q #(W s (]  } } }" ). 2z7;j>BEE }y" ).\/13m458=>Q@EHH q?[?UservolumescanbeusedwithStar(thiscommandfiledoesnotinstallStar,however).Ifyouwantsomeotherconfigurationoflogicalvolumes,youcaneditanyoftheseothellocommandfileswithanyeditor.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(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-densitydouble-sidedfloppies.DocumentationformakingasetoffloppiesfromaSYSOUTfileiscoveredinthe ^bsbb=!]$j'U* ,3$5^8_:>AG^b ` `` ` ^ ^^ Ga ! "&,R.1736=7;"?EHxHx^ ]y ]y]y P&]y [ [[ [ Zs ZsZs Zs X XX X Wm WmWm Wm U UU U Tq TT */T Ss SS S Q QQ mH!(+.0580;<<ABsEHHQ P P P   "%(,- -P N NN N M MM MqM MsM "'s((MqM3MsM4B8b;<)@@MqM JfMsMJJM K KKtKqK KsK KqK,AKsK,033KqK =KsK>@CGGGGK J1q J1J1J1sJ1b%(W,07u<@GjJJJ1 H HH O<"%*-$02v 99H G" G"G" G" E EEs "#R'(+ 5 7;AB H'JXJXE D DD I3 $V%&+-.04{ :.<> ?AFFD B BB ]~ f" *h.0'5M =(@aEEB A AA 4$.1L27D<> DFFA ? ?? ,2? > >> > < << < z "$(u 0q 8L<?TCEaJyJy< ; ; ;   %(-137><A'CXHH; 9 99*]u?!& 0268:[9 8 88 8 6r 66 $v *~6 4s 44 4 3I 3I3I  i #H ) /U1-2 :?CIBIB& %| %|%| '#>'<)l+-317;A$A|DfHH%| # ## z+ !7"&+ 4[58 :A BB# "v "v"vv"v p pp < zO*"%$V'k*)-25E8s9>v?sB3F\JJp   zq#qs#),7 j jj j r  $"'S+/ 2s 22 2   D"?#(-O17:: `q ``-0` s   Q QQ D  $)'/V05QqQ55QsQ <BEwQqQEEQ  (-a.8.> vs vv v r  $ &}*1&6 >s > > > -d"$O%L'*+./5#9=BzDFF 8 8 8 ( #$!&+/2T379g<< EUEU 8   H "'$6()+-e2i56<>@EFHH q?[file[Phylum]Current>MakeLispFloppies.DOC.Wewilluponrequestmakeavailablesetsoffloppiesforourstandardreleases. ^ bs bb ,++-b/3A7;j@CeDIIb ` `` ]` ^ ^^ ^r q?[L HELVETICA ~GACHA  HELVETICA  TIMESROMAN  TIMESROMAN  HELVETICA ~GACHA ~GACHA  & 2z3j/642I,{PHYLUM}CURRENT>GETTINGSTARTED.TEDIT;1 SANNELLA.PA31-May-84 12:14:27