TheAREDITInterlispbugdatabasesystemauthor:MichaelSannellafiles:{eris}AREDIT.DCOMdoc:{eris}AREDIT.TXTuses:AllTeditfilesThefileAREDIT.DCOMcontainsanumberoftoolsusefulforexamining,editing,andsubmittingARs("ActionRequests")relatedtotheInterlisp-Dsystem.Thesetoolsarelooselybasedonthe"Adobe"toolsintheTajoenvironment.TheInterlisp-Dsupportgroupusesthissystemtokeeptrackofthestateofoutstandingbugreports.Therearecurrentlyover2000ARsinthedatabase.ThesetoolscanbeusedfromanymachinerunningInterlisp-DwhichcanestablishaleafconnectiontothePHYLUMfileserver,wherethedatabasefilesarecurrentlystored.AfterloadingAREDIT.DCOM,theusercancreatetwotypesofwindows:AReditformsandARQueryforms.TheAREditFormAnAReditformisusedtoexamine,edit,andsubmitARs.TocreateanAREditForm,evaluate(AR.FORM).Interlispwillpromptyoutospecifyaregionfortheformwindow--thebestsizetogiveitisoneabouthalfthewidthofthescreenandatleasthalftheheightofthescreen.Theformwindowwhichwillappearcontainsthreesubwindows:(1)Onthetopisthemessagesubwindow,wherepromptsandstatusmessagesareprinted;(2)inthemiddleisthecommandsubwindow,amenuofcommandsforediting/submittingARs;(3)onthebottomistheformsubwindow,wheretheinformationinanARisdisplayed.Thecommandsubwindowcontainsthefollowingcommands:New--ButtoningthiswordclearsthefieldsoftheARintheformsubwindow.Somefields(Source,Submitter,Status)areinitializedtoappropriatevaluesforanewAR.Get--ButtoningthisretrievestheARwhosenumberfollows"Number:"inthecommandsubwindow.Put--ButtoningthiswilleitherstoreaneditedAR,orsubmitanewAR.Whichone(submitneworstoreold)dependsonwhetherthelastoperationwas"New"or"Get".IfthecurrentARdisplayedwasretrievedwith"Get",then"Put"willstoreitastheoldAR.IfthisARwasbuiltupfromscratchafterbuttoning"New",then"Get"willsubmitisasanewAR.Thetitleoftheformsubwindowgivesanindicationofwhatstatetheformisin:ifitsays"NewBugReport",then"Put"willsubmitit.Ifitsays"EditingARxxx",then"Put"willstoreit.[Thereareplanstoimprovethisinterface]Number:--Thisisatextfieldjustliketextfieldsintheformwindow(seebelow)usedtospecifythenumberusedby"Get".Buttoningtheword"Number:"willpending-delete-selectthevalueofthefield,soyoucandeleteitandinsertanewnumber.Ifthecharactercarriage-returnistyped,thena"Get"isautomaticallydoneonthevalueofthisfield.Thisisfasterthantypinganumber,andbuttoning"Get".Theformsubwindowcontainsalargenumberoffields.Themeaningofthesefieldsisdescribedin{phylum}LispARFields.press.Thevalueofthesefieldscanbeeditedasfollows:"Enumeratedfields"canonlycontaincertainvalues.Theseareindicatedintheformsubwindowbyfieldnamesfollowedbycurly-braces"{}".Tochangethevalueofoneofthesefields,buttonthefieldname;amenuofpermissablevalueswillappear;selectavalue;itwillbeinsertedbetweenthebraces.[note:Someoftheenumeratedfieldvaluesaredependentonotherfields.Forexample,thevaluesof"Subsystem:"dependonthevalueof"System:"--ifthe"System:"valueischanged,the"Subsystem:"valueisautomaticallysettoNIL.ThefieldswiththisrelationshipareSystem:/Subsystem:andMachine:/Disk:.] q?[ p q?[ b6p bq b `!r7^ $-h3`! ^;q ^; \s\ [H[Hp[H%[Hs[H%[H Y YpY$jYsY$pY XB!:XB Vq V U) U)pU) U)qU)j$&)?-'/6 6 :=U CFFU) Sd 9K &)*+$.24<8/@`F I*JJS R #" TU "3' *-04h59 K@C;GDGDH GsGs E E Dtt%9Dt Bq B A7 ~I #&(*-.#0358:>DDA7 ? Nh !"$)()-/15:;a=@GBDCGH*IhIh? >1 o +\!f#%Z(P*-1(249E91 < mO "V$P&(*,5.f3 :>DFJFJF< ;+Z"#?%p+ 3379;?AFhGpGp;+ 9  #&> -13 ;<>R@A G9 8% 8% 6  "6(.6 5 5 3u w3q3 Q $w&(3*,.K1 89<<@f@3u3GG3 2 /92q2 0 "O# *.124702 0 0 /u w/q/ QG!%*/2//u/5/q/68K:|@ G/ -u -u +u w+q+ Q>!'"&)+=/03[66q:=.BDF^II+ *f  Z$P&'~*fu*f**fq*f+ ,-Q*fu*f/*fq*f151259<AD}JJ*f ( (u((q(ri(u((q(!N v!$(&b) )x*-?/2$5:7:V>AGG( 'N 'Nu'N''Nq'N~.'Nu'N'Nq'N6 V!S$&')),o-0+3c:m=?s EG5JcJc'N % %]p"$'*+J%u%-%q%.1R57278:<BDGG% $6 $6u$6$6q$6&M#n$**, 2 $6 " " !'u!'q!'+u_##"$()+/46:>?CFF!' yuq]"%w&'u,q-/B CEI JJ  ze$$h%'-67;>?@uC&qD.ElEl  .qIz!%H%()-Y0P4d5a:=>CVDuFqG   t t   !C&?'++.458A)D)H3I0I0 P/ {y"&T'Q+D,l.05:=A.P   v!$%'x -/[2r4)9:{=!@@ZBFFH^KuKu  ` &* +w-'/16789>AsBqFHxHx ` * %f() /1!2M4587G9<0> CEE * (*2 q 2 % % q?[;"Textfields"cancontainarbitrarytext.Thesefieldsdonothavebracesafterthefieldname.ThetextcanbeeditedusingnormalTeditediting.Buttoningthefieldnamewillpending-delete-selecttheentirefieldvalue,whichallowsthewholefieldtobeeasilydeleted.[note:Currently,storedARsonlycontainstraighttext.AnyteditformattinginformationputintoanARwillbelostwhentheARisstored.Imageobjects(likebitmaps)arealsonotstored.][note:Afewofthetextfields,like"Number:",arereadonly---theycannotbeeditedbytheuser.][note:inolderversionsofAREDIT,sometextfields(suchas"Attn:"couldonlycontainacertainnumberofcharacters.Theusercouldtypeasmanycharactersashewanted,butanerrorwouldoccurwhenthe"Put"commandwasexecuted.Thishasnowbeenchanged---anytextfieldcancontainanarbitrarynumberofcharacters.]TheARQueryFormAnARQueryFormisusedtosearchtheARdatabaseforallARswithparticularcharacteristics.OnecansearchforallARswithagivennameinthe"Attn:"field,allARswhichhaveStatus:=Open,etc.TheseARscanbesorted,andasummaryoftheselectedARscanbeprintedintoafile.TocreateanARqueryform,evaluate(AR.QFORM.CREATE).Interlispwillpromptforaregion(thedefaultsizeisok),andcreateawindowwiththreesubwindows:(1)ontop,amessagesubwindow,forprintingpromptsandmessages;(2)inthemiddle,abrowsersubwindow,usedfordisplayingtheARsselecedbyaquery;(3)onthebottom,theARquerycommandsubwindow,containinganumberofcommandsandfields.TheArQuerycommandsubwindowcontainsthefollowingfields/commands:QueryList:--ThisfieldisusedtospecifywhichARsthe"Query"commandwillsearchfor.ThisfieldshouldbefilledwithanARqueryspec,whichhasoneofthefollowingforms:(HAS)searchesforallARswhosetextfieldcontains.mayeitherbeanInterlispstringoranatom.Thesearchiscase-independent:foomatchesFoomatchesFOO.(IS)searchesforallARswhoseenumeratedfieldhasthevalue.(AND...)returnsallARssatisfyingALLofthegivenspecs.(OR...)returnsallARssatisfyingANYofthegivenspecs.[note:animplicit(AND)iswrappedaroundthevalueofthe"QueryList:"field,sojustgivinganumberofspecswillANDthemtogether.]NoteveryARfieldcanbesearchedforinthesameway:somecanonlybesearchedwithHAS,somecanonlybesearchedwithIS,andsome(liketheDescription:field)cannotbesearchedatall.Tofindoutthepossiblequeryspecs,buttonthewords"QueryList:"---thiswillputupamenuofallofthepermittedsearchingoptions.Someofthesemenuitemshavesubmenues.Whenoneoftheoptionsisselected,itisaddedattheendofthevalueofthisfield.Examples:QueryList:(Subject:HASfoo)SearchesforallARswhosesubjectcontainsthestring"foo".QueryList:(Status:ISOpen)(Attn:HASsannella)SearchesforallopenARswhichhave"sannella"intheAttn:field.QueryList:(OR(Status:ISDeclined)(Status:ISSuperceded))SearchesforallARswithStatus:eitherDeclinedorSuperceded. % bq b4U"5"&_)+.15#80:a=aAIADJFI0I0b ` -2 !L'),0F2?AEHH` ^!*"&+/^ ]y ]y\Bv! &),.E1588_:< A GItKK\B[  5"#%H',)+-].[115!8:?$@BDH[ YqYXSv!"$%'}),. 4H58C:;>ABEG%HK[XS Vq VUv!"%)l*/24/69:>AdCGUH(KKUTd"# ()?+N-w072b36k ;f<=ACDGyJvJvTdS.!$9%(-/434y68:=A,BDFHJJS.Q"}#(<+-* 2Q Pvq Pv N N Mwt%Mw Kq K J: ~,jw!#2%+-.14 :CCFIIJ: H $ "5$f%HuH)IHqH*Q-/j2U629J9JHpH?+HqH?A;A;HpHDHqHEGGGGH G+ #m$'),$/1l3/7:z;w=G+ E E D% 4!f!fD%pD%/D%qD%0\058v=/?>@;DNFFD% Bi#I"$(X 0_0247'8$=L DFFB A?E ?!#(). 6#90;? ACFFA ?MJzR!r#& )/ 7X =>CEaEa? >.> < < ;  ~ %(".249; 9 9 8u/8q8 !%),./8u838q84;=ACDHG2J2J28 6x<aLv3"l&I(+ ,.486x 4 4 3rp3rq3r? r"$B'-++-05:E> >cCiF?II3r 1 xec!d%n&149#;@DY1 0c 0c .p.q.h!#k&V*T 149 ;T=@Ds. -T -T +p%&+q+'+-E00 691:<@rC+ *E *E (pN%(q(&**,n/Y 5/8:BXBJCGHCII% $'Wq d$' " " !! !!   "%#%)%,H,02a5K7<?nC FnHH  "% ,024}6@;= ?8?ADGFHH {!"yu'+q,.03n578#C  }u}q}ss}p}&*5-}q}-}Sb#!% ).04888nnuqssp&(-3r6>]q>c _Sb#!f$Q(.+F 13A5r8; _   Yu Yq Yss Yp Y!)^+4I;>] HqIH Yq YIN YSb#!#([,13W : q?[SortList:--ThisfielddetermineshowtheQuery-edARswillbesorted.Currently,ARscanonlybesortedbythevaluesofenumeratedfields.Buttoningthewords"SortList:"willputupamenuofthepermittedfieldnames--selectingonewilladdittothevalueofthisfield.Example:SortList:Status:Priority:ThiswillsortfirstbytheStatus:field,andthenbythePriority:field.[note:Aftersortingbyallgivenfields,iftwoARsarethesame,theyaresortedbyARnumber.Therefore,ifthisfieldisleftblank,thequeriedARswillbeinnumericalorder]Query--Buttoningthiscommandwillinitiatethequeryspecifiedbythe"QueryList:"field,andsortitaccordingtothevalueofthe"SortList:"field.Whilethequeryisinprogress,theARquerycommandsubwindowisgreyed-out.Whenthequeryiscompleted,thenumbers,subjects,etcoftheARswhichhavebeenfoundaredisplayedintheARquerybrowsersubwindow.Thiswindowcanbescrolledbothverticallyandhorizontally.PrintFile:--Thisfieldcanbefilledinwithafilename,whichisusedtospecifythefilethatthePrintcommandshouldstoreareport.Ifleftblank,awindowwillpopuponthescreen,andtheinformationwillbedisplayedthere.Print--ThisprintsadetailedsummaryofalloftheARsfromthelastQueryintothefilegiveninthePrintFile:field.TogenerateandprintasummaryofaselectedgroupofARs,fillintheQuryList:andSortList:fields,selectQueryandwaitforthequerytocomplete,fillinthePrintFile:field,andselectPrint.Thesummeryisratherwide--itmaybeagoodideatousetheLANDPRESSpackagetoprintitoutsidewaysonaprinter.TheARquerybrowserwindow:Thiswindowshowsashortsummary(onelineeach)oftheARsthathavebeenqueried.Left-buttoningoneoftheARlineswillcallAR.SHOWonthatAR,todisplayit.Middle-buttoninganARlinewill"Get"thatARintoaspecifiedAReditformwindow.Backgroundmenucommands:WhenAREDITisloaded,theitem"AREDIT"isaddedtothebackgroundmenu,withanumberofsubitems.Theseareinterpretedasfollows:AREDIT--CreatesanewAReditform,initiallycleared.NewARForm--SameasAREDITLoadARForm--promptstheuserforanumber,andcreatesanewAReditform,withthespecifiedARnumberloadedinitially.AR.SHOW--promptstheuserforanumber,andcallsAR.SHOW,anoldversionofAREDITwhichquicklydisplaysthecontentsofagivenAR.Itpromptsforawindowregionthefirsttimeitisused--thereafteritusesthesamewindow.ARQueryForm--CreatesanewARqueryform.: bq b b `u%X`q` !$&,/2388v >AD$GHH` ^m ##*1,b0?0^u^5"9U^q^:]<?*AB EGHIyIy^ ]g   j!O#&S'{(+,.0125]g [ [ZaZaXXW[uDW[qW[W[pW[$T+W[qW[+W[UCt!B#s#sUpU)TUqU)-/24R66UpU>UqU>jAoU TC TCS v!$f')/*-P0C1035W78;=?BCEIJ J S Q #$&()+.04)6l8W9:?BrQ PTq PT Nu%NqN}q"&(,s1356NuN;?NqN@DHFIYJJN ME*MEuME $MEqME&)[)-/346F;> @sD0J_J_ME K: D $s% ,.49;=p?BFiIIK J6 # '#( 0K038:<AD JJJJJ6 H { H G0 G0 E E D*u/D*qD*#=$'(*.2368p<? AGCFFD*uD*JJD*qD*JJD* B!k7!%&+.A0246;.=? G=IIB A A ? ? > > M@D EGG< ;u/;q;6<; 9z 9z 7 7 6t 6t 4 > T!Q&L*+.02c444u48<4q4=R??4u4DHA4q4HH4 3e^^3eu3e3eq3er<K |$9%+-/=1n1n3eu3e6x:3eq3e;>[@DtDt3eu3eH3eq3eIVII3e 1 h "#&)+:-//1p17A1q17<>*B2DxII1 0M -0M . . -G -G +t%' + *q * (  #&H)+N-0j3 6!9O>> GJXJX( '  } ' p' ' q' /!#&e',f-.=9:=B?BDB' u' Ey' q' FI I ' % Y#% # # "y "y t  Cq C pq={NDp$q&'D+8,. 6@:J=5>2C.DJJJ 4 J4   .p.q.TXU|"'j+.   pD%q}Xp$q$   pqT # %'(.70568;;=A^DIFzFz {(    ~~p~~q~!k!#$*,/l/l~p~5M~q~579>@@~p~E&~q~E~I[I[~ "$%4&~+-.37:<?@B EFaFa o )%ts o iipimwiqi+u!/",$'S+.Mi^ q?[lAuxiliaryAReditformcommands.PressingtheleftmousebuttoninthetitlebaroftheAREditformcommandsubwindowwillbringupamenuofless-usedcommands:Clear--ClearsALLthefieldsofthecurrentAR.SimilartoNew,exceptthatnonofthefieldslikeSource:,etc.,arefilledin.ThisisusefulwhenyouaresubmittinganARforsomeoneelse.NewGetPut--thesameastheCommandsintheeditcommandsubwindow.Put&Get--promptstheuserforanumber,PutsthecurrentAR,andGetsthegivennumberedAR.UsefulwhenscanningthroughanumberofARs.GetFromFile--Promptstheuserforafilename,andloadstheinformationfromthatfileintotheAReditformsubwindow.Ifthisfileisnotintherightformat,anerrorwillbegenerated.PutToFile--Promptstheuserforafilename,andstorestheinformationfromtheARintothatfile.LocallycachingtheARindex.AllARqueryoperationsusetheinformationinthe"ARIndex"file.Thisfile,whichisupdatedeveryfewdays,isstoredas{phylum}AR.INDEX.TospeedupQueryoperations,thisfilecanbecopiedtoalocalfileserver,orthelocalharddisk.Warning:thisfileiscurrently~700IFSpageslong,anditwillundoubtedlygetlarger.Also,itistheresponsibilityoftheusertomakesurethattheyupdatetheirlocalversionofAR.INDEXwhenthemastercopyisupdated.TousealocalversionofAR.INDEX,givethefilenameasanargumenttoAR.QFORM.CREATE:(AR.QFORM.CREATE'{DSK}AR.INDEX).GlobalVariablesthatcontrolAREDITThefollowingareglobalvariablesthatcanbesettoaltertheoperationofAREDIT.Thesearetheonlyglobalvariablesthatitissafetochange.AR.ENTRY.LIST.WINDOW.FIELDS--ControlswhichfieldsaredisplayedintheARquerybrowserwindow,alongwiththewidthsofthefields.AR.ENTRY.LIST.PRINT.FIELDS--ControlsthefieldsdisplayedbythePrintcommandoftheARqueryform.AR.ENTRY.LIST.PRINT.MULTILINE.FLAG--ifnon-NIL,thePrintcommandoftheARqueryformwillprintallofthecharactersineachfield,usingmultiplelinesforthosefieldvaluesbiggerthanthefieldwidthallowed.IfNIL,eachARwilluseonlyoneline,truncatinganyfieldvaluesthataretoobig..Mi bq b b ` ` ^tP"^q^#^ ]B ]B [$U #S%'%)V+.17?A}DFGG[ Z</Z< X X W6p%W6qW6},;!l&()-/1/1W6pW61W6qW62f69%;=N?CE~E~W6 UpUqU7] #'* ,2 2479>A(U T T Rp wRqR }R Qp wQqQ }Q Op wOqO JKa #%+ 2O M M LtpLtqLt+u%%LtpLt'LtqLt(o*/9144LtpLt7LtqLt7:=CFGGLt J27=:#6$'J Ie Ie Gp /GqGJ "$#!%[)D+/01a 8;>@CoEHJJG FV* 8"h #&;*,/2_4" ::FV D D CPpCPqCP#kg v!s#'*-0 7V:<?&ADmFCP A A @A @A >tl >q>> = = ; |9 + %')1,H03F369<>5C]FIVIV; 9Ar9p9)9q9**,026 =b?BDkF.JmJm9 8r r o #$J*B,.0,59G;?kBE6F^HH8r 6 S!A )|+-80157:r=SADGG6 5l5lp5l5lq5l$"%>&|+5l 3 3 2] 1.Cee2]p2] 2]q2] #%'+- .46E6E2]p2]B2]q2]C]2] 0 0 /Np9%/Nq/N&//N - - ,? ,? *tU&C* ) ) 'Vq y!$%')G,=.n4d5<BHGNGN" !D$ $i!    p  q ! !x"()*Z-357; A;BDG^G^    yp"'yqy')"*U0P25;=~?BEI I y  mf" ] $7',0258<~@C~EHH j5/ "%(X+7 147;=?BD7j0 q?[ TIMESROMAN~GACHA  TIMESROMAN  TIMESROMAN  TIMESROMAN TIMESROMAN ~GACHA  % d% .j/1/^[{ERIS}AREDIT.TXT;1 SANNELLA.PA30-Aug-84 15:45:20