--AlpineDoc.tioga--Lasteditedby--MBrownonJune7,19839:42am--KollingonJune7,198310:27amThefollowingmessageissenttonewAlpineaccountholders,andistheonlyuser-leveldocumentationforAlpine.Client-leveldocumentationexistsas[Indigo]Doc>AlpineInterfaces.*.Subject:InstructionsforusingAlpineTo:YourName.paReply-To:Kolling.paI.IntroductionWelcometothecommunityofAlpineusers!Thepublicly-availableAlpineserveriscalled"Luther.alpine".(TheserverrunsonaDoradonamedBataan,whoseterminalisinthenursery.)AnAlpineserverkeepstrackofthespaceoccupiedbyfiles.Eachfilehasanowner,denotedbyacharacterstring(suchas"YourName.pa"or"CedarDocs"),andeachownerhasanassociatedpagequota.TocreateapersonalfileontheAlpineserver,yourRNamemustbeestablishedasanowner,and(unlikeIFS!)theactofcreatingthefilemustnotputyouoveryourquota.(Itispossibletocreateafileownedbyanon-individual,suchas"CedarDocs",or,withsufficientpermission,inanotherowner'sspace,butwe'llnotgointothedetailshere.)Thefactthatyouhavereceivedthismessageprobablymeansthatyouareestablishedasanowneron"Luther.alpine".Ifyourunoutofspace,Imaybeabletoincreaseyourquota.Alpineprovidesaccesscontrolonfiles.Eachfilecontainsa"readaccesslist"(default"world")anda"modifyaccesslist(default"owner").TheselistsmaycontainRNames,plusthespecialvalues"world"and"owner".Thelistsmustfitintoafixedamountofspaceassociatedwiththefile,soitisagoodideatograntaccesstogroupsratherthanindividuals(say,grantmodifyaccessto[CSL^.pa,ISL^.pa]ratherthanto[Atkinson.pa,Birrell.pa,...]).AnAlpineserverdoesnotprovidetextnamesforfiles.Howeverapackage(includedinAlpineUserImpls.bcd,andrunontheworkstation)providesasimpledirectorysystem.Afileisnamedbyacharacterstringoftheform"[server]file",forinstance"[Luther.alpine]Walnut.segment".(Thispackageisaninterimdirectoryimplementation;itdoesnothandlelargedirectoriesefficiently,orversionnumbersatall.)AnAlpineserverdoesnothaveaTelnet"executive"interface(youcan'ttalktoitviaChat).ItalsodoesnotsupporttheFTPprotocol(youcan'ttalktoitviatheFileTool).Howeverapackage(calledAlpineCmds,includedinAlpineUserImpls.bcd,andrunontheworkstation)allowsyoutoperformoperationssuchascopyingfilestoandfromAlpineservers,deletingfiles,listingyourdirectory,determininghowfaryouarefromexceedingyourAlpinediskquota,andreadingandchangingtheaccesslistsforfiles.Thepackageiscallablefromtheinterpreter.ToretrievetoyourlocalworkstationthepackagesthatyouwillneedtobeanAlpineuser,do:Bringover/a/pTop>AlpineUserp p_,  C]  C[ m  CZ6   V lP!&r+03w47C:\ U@ %b #" ,0= S' PI$  N _ Lb q H p D"\ Af !'"&1O48;=>D ?Oi 6?D 5U#&(f 113M6h ?2Dt g d'*-9/?1 9=@fB  mLxf "&3*/48)"]("List.mesa","Rope.mesa","Walnut.segment")&3_AlpineCmds.Delete["[Luther.alpine]Rope.mesa"]TRUE--returnsTRUEiffilefound,otherwisereturnsFALSE.&4_AlpineCmds.List["[Luther.alpine]*.mesa"]("List.mesa")&5_AlpineCmds.Copy[to:"[Luther.alpine]Rope.mesa",from:"Rope.mesa"]{doesnotreturnavalue}&6_AlpineCmds.Copy[to:"Walnut.segment",from:"[Luther.alpine]Walnut.segment"]{doesnotreturnavalue}&7_AlpineCmds.ReadQuota["[Luther.alpine]"][pageLimit:6000,spaceInUse:3130]&8_AlpineCmds.GetReadAccess["[Luther.alpine]List.mesa"];[fileFound:TRUE,accessList:("world")]&9_AlpineCmds.GetModifyAccess["[Luther.alpine]zot"];[fileFound:FALSE,accessList:NIL]&10_AlpineCmds.SetReadAccess[file:"[Luther.alpine]List.mesa",list:LIST["AlpineImplementors^.pa","owner","Cattell.pa"]];TRUE--returnsTRUEiffilefound,otherwisereturnsFALSE.&11_AlpineCmds.SetModifyAccess[file:"[Luther.alpine]List.mesa",list:LIST["world"]];TRUE--returnsTRUEiffilefound,otherwisereturnsFALSE.&12_AlpineCmds.GetOwnerCreateAccess["[Luther.alpine]"];[ownerFound:TRUE,ownerAccessList:("owner")]&13_AlpineCmds.SetOwnerCreateAccess[directory:"[Luther.alpine]",list:rHDg/p ^ |,%&5B4E \ *y"0$'0,238b:<?^BF [H. q VR (0!!# p S  #+j/w457O > Q\* *9 O Lf "sQLfLf"%e(-J0p J Ivl E / D!   @ : ?+s?+7?+5<"',p ; 5 :5 6 (7n;O 5?Cm 1 ' 0I- .Cm +S 4 ) (  &] B $   !g >  ^ " q D#8(= 5% "s"7"5<"',p  D$(> , s75<"',p 6 D@ #d @ D*+h@;TVm$3LIST["AlpineImplementors^.pa","CedarImplementors^.pa"]];TRUE--returnsTRUEifownerfound,otherwisereturnsFALSE.NotethattheListprocedureallows'*tobeembeddedwithinthe"simple"filenameonly,notwithintheservernameortheownername.TheproceduresinAlpineCmdsarenotdesignedforheavyuse,theyarejustawaytogetoffthegroundwithAlpine.Theydonothandleexceptionalcasesverygracefully.Forinstance,ifyouexceedyourquotawithCopy,youwillgetanuncaughtsignal.Whenyougetanuncaughtsignal,trytounderstandwhetheritrepresentsaproblemofthissort(theargumenttothesignalisoftendescriptive).Ifnotoryoucan'ttell,pleasecallme(Karen).III.UsingWalnutwithAlpine:CypressknowshowtoaccessfilesstoredonAlpine.ThismeansthatyoucanstoreyourWalnutdatabase("Walnut.segment"),andotherdatabases,onAlpine.YoucannotusefullystoreyourWalnutlogonAlpineyet(butthisiscomingsoon).HerearetheinitializationproceduresthatyoumustfollowifyouwantWalnuttouseAlpineforyourcopyofWalnut.segment:&1RunAlpineUserImpls.bcd--unlessyouhavealreadydoneso.(thereareunboundimports)Loadedandstarted:AlpineUserImpls.bcd&2_AlpineCmds.Copy[to:"[Luther.alpine]Walnut.segment",from:"Walnut.segment"];{doesnotreturnavalue}ThenchangeYourName.profiletosayWalnut.WalnutSegmentFile:"[Luther.Alpine]Walnut.segment",andWalnut.WalnutLogFile:"Walnut.DBLog".CopyingyourWalnut.segmenttoAlpineandchangingyourYourName.profileare"onetimeonly"procedures,anddonotnormallyneedtobedoneeachtimeyouinvokeWalnut.WhenyouwanttoinvokeWalnut,do:&1RunAlpineUserImpls.bcd--unlessyouhavealreadydoneso.(thereareunboundimports)Loadedandstarted:AlpineUserImpls.bcd&2Walnut--TheWalnutcontrolviewershouldappear.OpeningWalnuttransaction...Notes:YoumayincludeAlpineUserImplsandWalnutinyourcheckpoint.SinceAlpineUserImpls'rollbackproceduremustbecalledbeforeWalnut's,besuretorunAlpineUserImplsbeforeWalnutisrun.Forexample,puttingrHDg/p _,5 ]s]7]5<#).6p X5c% "b$&,13_9%;?NBE5 V +; S L E # (+.147-9:=?AC Q $ +/@2N 9<+AC2 PIFc~ A"%6'&-%168;<BG7 N m : !'j)#+.{1T7~9-;?w@ L |l!u%(#*vq H p D.2#&+g.258J:>2Am CZ&#| )+1\4k8>Ao Ag m!& >2  !$'T*.0U3 6i;S=?vCF9 7@ YE#( 37!8 VR SRs *#(),.37} N  ,}6"r ,.1 9;C @ Lf.dNi!$)+ 1346^8 =?vCH J _b"$'+t1[ 8W:>>?D I1Z!5$*b+.y02p87:=? GpT!4 'S*-1'7Q;'>m@E E  $'&,/046E8 <>v D! @ A}><!j## -C/25<89>C^ ?+ :$8$Y&I( 0346h8:u?_ ; "$p(+U 2486 BWDG :5 v  " ,.1 8;@; 8,9+8+;?AB 66'!*&(.o/ 8 :@gFO 5?gF#$&+2.35=8<"?h 1 yj "%?(")/1.6:=?{A 0I]# $M'~)-/269><>BDF . $t 4%'(+&02B57:<>B D , 4<f ?"'*,02e6s <@CE +S  _!#{&*@ (A #9$ ,#1 6@ $ LD "' /+ 6>A#D'Gm # I> q  # 6 -nb="(,i06~7;@GA {   !R%'O+-c15;=I?9C;E 8S g m"'R,:2o47:; BD - H c (Q+-/14A79A;H= @SD  TVm$ TIMESROMAN HELVETICA TIMESROMANLAUREL M  j/" ,AlpineDoc.tioga 8-Jun-83 9:13:32