1HIGHER-LEVELNSPROTOCOLFUNCTIONSThefollowingisadescriptionoftheInterlisp-DfacilitiesforusingXeroxSPPandCourierprotocolsandtheservicesbasedonthem.Thesectionsonnamingconventions,Printing,andFilingareofgeneralinteresttousersofNetworkSystemsservers.TheremainingsectionsdescribeinterfacesofinteresttothosewhowishtoprogramotherapplicationsontopofeitherCourierorSPP.1.1NameandAddressConventionsAddressesofhostsintheNSworldconsistofthreeparts,anetworknumber,amachinenumber,andasocketnumber.ThesethreepartsareembodiedintheInterlisp-DdatatypeNSADDRESS.ObjectsoftypeNSADDRESSprintas"net#h1.h2.h3#socket",whereallthenumbersareprintedinoctalradix,andthe48-bithostnumberisbrokenintothree16-bitfields.MostfunctionsthatacceptanaddressargumentwillaccepteitheranNSADDRESSobjectorastringthatistheprintedrepresentationoftheaddress.Higher-levelfunctionsaccepthostargumentsintheformofasymbolicnameforthehost.TheNSworldhasahierarchicalnamespace.Eachobjectnameisinthreeparts:theOrganization,theDomain,andtheObjectparts.Therecanbemanydomainsinasingleorganization,andmanyobjectsinasingledomain.ThenamespaceismaintainedbytheClearinghouse,adistributednetworkdatabaseservice.AClearinghousenameisstandardlynotatedasobject:domain:organization.Thepartsorganizationordomain:organizationmaybeomittediftheyarethedefault(seebelow).Alphabeticcaseisnotsignificant.Internally,namesarerepresentedasobjectsofdatatypeNSNAME,butmostfunctionsacceptthetextualrepresentationaswell,eitherasalitatomorastring.ObjectsoftypeNSNAMEprintasobject:domain:organization,withfieldsomittedwhentheyareequaltothedefault.ADomainisstandardlyrepresentedasanNSNAMEinwhichtheobjectpartisnull.IffrequentuseistobemadeofanNSname,itisgenerallypreferabletoconvertittoanNSNAMEonce,bycallingPARSE.NSNAME,thenpassingtheresultantobjecttoallfunctionsdesiringit.CH.DEFAULT.ORGANIZATION[Variable]ThisisastringspecifyingthedefaultClearinghouseorganization.CH.DEFAULT.DOMAIN[Variable]ThisisastringspecifyingthedefaultClearinghousedomain.IfitorthevariableCH.DEFAULT.ORGANIZATIONisNIL,theyaresetbyLispsystemcode(whentheyareneeded)tobethefirstdomainservedbythenearestClearinghouseserver.Insmallorganizationswithjustonedomain,itisreasonabletojustleavethesevariablesNILandhavethesystemsetthemappropriately.Inorganizationswithmorethanonedomain,itiswisetosettheminthesiteinitializationfile,soasnottobedependentonexactlywhichClearinghouseserversareupatanytime.(PARSE.NSNAMENAME#PARTSDEFAULTDOMAIN)[Function]When#PARTSis3(orNIL),parsesNAME,alitatomorstring,intoitsthreeparts,returninganobjectoftypeNSNAME.Ifthedomainororganizationisomitted,defaultsaresupplied,eitherfromDEFAULTDOMAIN(anNSNAMEwhosedomainandorganizationfieldsonlyareused)orfromthevariablesCH.DEFAULT.DOMAINandCH.DEFAULT.ORGANIZATION.If#PARTSis2,NAMEisinterpretedasadomainname,andanNSNAMEwithnullobjectisreturned.Inthiscase,ifNAMEisafull3-partname,theobjectpartisstrippedoff.����������������
êq?€`½�î��ï��pÿ�������������
êq?€`½�î��ï��î
êïg_pî	ôïb;qî	úïb;î	ôï\u�î
üîTîwî’
îØî%;î-±ï\urï\uî-·ï\uî	ôïYpîî{
î¹�î¶
î“
îîO
î&-	î+\î-kî0åî4Øî7˜î:!î?îDÃîGLîI}îI}ïYpî	ôïWíîÎî€
îXî	îaî
îù
î!Ñî&•î.Nî3Áî6Jî:$î<J
î=ÕîBxîG&
îH¦îH¦ïWíî	ôïVjî
C
îÎîPîbîîsî!î'kî,Zî1Œ	î7„
î9î=½
î?=îB¬îEîH‚
îJîJïVjî	ôïTçîRîÁî!
îùî?
îÊî#†î(j
î*�î,¿ïTçqïTçî,ÅïTçî	ôïO!îî\îwîHîºî©
î!åïO!rïO!î!ëïO!î	ôïLî9
îÄî
î’îÃ
îî¾î#
î$“î'íî+~�î,{î1¡î6õ�î7òî=EîB™îE"�îFîJîJïLî	ôïJ™îGîŸîqîËîî*î"c
î#ãî&
î,òî2Qî2QïJ™sïJ™î9àïJ™rïJ™�î:î:çî?ª
îA5îDîDïJ™î	ôïI
sîƒïI
rïI
îÛî
î”î%òî)Ûî+œî-Íî3Mî5sî:
î;–î>·îBhîDñîG"îG"ïI
î	ôïGî
»î…î
î¿î@îèî!Bî%	î(äî)<î,•î2`î4ÿî9	
î:Ìî?†îEîGúîGúïGî	ôïEþî
þîº
î}î}ïEþsïEþîïEþrïEþîdîK
î á�î!Þî%„î(#
î)aî+’î05
î8÷
î:‚î<³îArïEþî	ôïCî£înîxîBî$¿
î&?î(pî+¨
î-3�î.0î3Ãî7Tî9cî;”î>µî?
îA¶
îCöîG±îIøîIøïCî	ôïAŽ�î
ñî&î·î”îìî/î!î$§
î%å
î'eî*¿î.qî0¢î0¢ïAŽtïAŽî8AïAŽrïAŽ�î8ñî;"î;"ïAŽtïAŽî?ÉïAŽrïAŽ�î@yîCîE3îE3ïAŽtïAŽîHúïAŽrïAŽîIRîIRïAŽî	ôï?øî
„î
Üî®î
îÎîjî¼
î <�î!9î$ôî,íî/vî3î7}
î8ý�î9úî=µîBÚîC2îEÛîIlîIlï?øî	ôï>uî
z
î¸	î¬
îzî«î«ï>utï>uî!îï>urï>u�î"ž�î#›
î*Xî/~î4èî9Cï>uî	ôï;~�îSîî°
îî	îjî$.
î%¯î%¯ï;~tï;~î)ï;~rï;~�î)ï;~tï;~î-Òï;~rï;~�î.Kï;~tï;~î5ˆï;~rï;~�î67î6î98î<qî<qï;~tï;~îC®ï;~rï;~îD
îEœîEœï;~î	ôï9ètî9ï9èrï9è�î²ï9ètï9èîïï9èrï9èîGî
îàîÄ
î ÷î#Øî%þî(/î,¦î/Eî3ñî4I	î;î=Ð
î?îATîHîHgîHgï9èî	ôï8R
îdîyîŸ
î×
îXî#Ã
î%Nî*­î*­ï8Rsï8Rî/·ï8Rrï8R�î0gî2¹î5æî;±î?»îAìîFBîFBï8Rî	ôï6Æ
î¶
î7îMî	
îŠ�î‡î"
î#�î$šî(—î(ïî-²
î/=î2î2ï6Æsï6Æî7(ï6Ærï6Æî7€î:¸
î<9î<9ï6Æî	ôï5:tî
Yï5:rï5:�î
Òï5:tï5:îï5:rï5:�îï5:tï5:îÍï5:rï5:�î}îhî ìî%Ðî)Vî,7î.]î1í
î3mî5žî:lî:Ä�î<#î<#ï5:tï5:î@Êï5:rï5:îA"
îB`	îHÜîHÜï5:î	ôï3¤
î,
î­
îpîpï3¤sï3¤îzï3¤rï3¤îÒ
îRî/î!`î%Gî'ü
î):î,9î,‘
î-æî3Eî5Œ
î6Ê
î8J
î:
î=ž
î?)
î@ì
îC,îG
îH=
îI{îI{ï3¤î	ôï2î©	î
î„î=
îe
îå
î ¨î ¨ï2sï2î%²ï2rï2î&
î)y
î+Gî/zî/zï2sï2î9Žï2rï2�î:>î=5îAØîD	îI}îI}ï2î	ôï0Œî
Û
î[îîçîìîï0Œsï0Œîï0Œî	ôï-ŸîEï-Ÿrï-Ÿîîõî0 	î5äï-Ÿî¢ï,îŒ
îÊ�îÇîm	î%±î'âî,Yî5%î<Åï,sï,î<Ëï,î	ôï)&î;ï)&rï)&î“îëî0 	î5äï)&î¢ï'šîŒ
îÊ�îÇîm	î%±î'âî,Yî5%î:J
î;Ÿ
î<Ç
î>]î@ŽîE“îE“ï'šî¢ï&sî)óï&rï&î*K
î+‰î+‰ï&sï&î.ï&rï&�î.¾î1Ÿî3Åî5´
î7‚î:lî>¸îAÏîEÎîH¯îH¯ï&î¢ï$‹îÈîÚ
îZ
î!î#Nî%÷î*Åî.å
î0³î2äî7gî@3îDï$‹î	ôï!§
î–îî)îî†îî$)
î%Q
î&	î-+
î.«î1î4vî7Ðî=Yî=Yï!§sï!§î?Þï!§rï!§î@6îB¿îE×îHîHï!§î	ôï î@î/î‰
îîu
îî&<î)'î,‹î/‚î1ÿî7%
î8M
î9‹î<k
î=ëî?ÚîC4
îD´îFåîI6îI6ï î	ôï˜
îî/
îÅ
îFîŒ
î
îÏî#b
î%:î)¦î-ƒî6Oî:±î<×
î>»
î@&îB™îEŽï˜sï˜îE”ï˜î	ôï«î¶î¶ï«uï«îtîˆî(ßï«sï«�î)¶ï«rï«î*î*fî0 	î6Fï«î¢ïî‹î‹ïuïîYïrïî±
î ï�î!÷î$î$ïsïî&‹ïrï
î'´î+¨î+¨ïuïî/ ïrï�î/Ð�î0Íî5M
î6ãî:áî=‰î?5îBîF îF ïî¢ï“îy
î<î"#
î#®î&î&ï“sï“î+™ï“rï“�î,Hî, 
î-õî0&î4ô
î6Šî>+
î?iîD¥îI îI ï“î¢ïîÈî}î"9î%qî%qïuïî/Èïrïî0 î2\î2\ïsïî7fïrïî7¾î;¼î@ŠîCîJ´îJ´ïî¢ï{î&îî6î"¼
î$Rî'Šî)»î/Dî/Dï{sï{î=‹ï{rï{î=ãî@lî@lï{î¢ïïsî)óïïrïï�î*Pïïî¢ï
î÷î÷ïuïîÅïrïî
î[
î»î»ïuïî#3ïrïî#‹
î$É
î+¨
î-)�î.&î2ôî6Ýî9f
î;)î;)ïsïî@3ïrïî@‹îCvîFîJîJïî¢ïv
îàî¡îù
î›î"
î%%
î&Xî&Xïvuïvî)Ðïvrïvî*(
î+f�î,cî.¾î2œî6…î8¶î<î?R
î@îE·îGÀïvÿ�������#����
êq?€`½ù��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������2If#PARTSis1,NAMEisinterpretedasanorganizationname,andasimplestringisreturned.Inthiscase,ifNAMEisa2-or3-partname,theorganizationisextractedfromit.IfNAMEisalreadyanobjectoftypeNSNAME,thenitisreturnedasis(if#PARTSis3),oritsdomainand/ororganizationpartsareextracted(if#PARTSis1or2).(NSNAME.TO.STRINGNSNAMEFULLNAMEFLG)[Function]ConvertsNSNAME,anobjectoftypeNSNAME,toitsstringrepresentation.IfFULLNAMEFLGistrue,thefullprintednameisreturned;otherwise,fieldsthatareequaltothedefaultareomitted.ProgrammerswhowishtomanipulateNSADDRESSandNSNAMEobjectsdirectlyshouldloadtheLibrarypackageETHERRECORDS.1.2ClearinghouseFunctionsThissectiondescribesfunctionsthatmaybeusedtoaccessinformationintheClearinghouse.(START.CLEARINGHOUSERESTARTFLG)[Function]PerformsanexpandingringbroadcastinordertofindthenearestClearinghouseserver,whoseaddressitreturns.IfaClearinghousehasalreadybeenlocated,thisfunctionsimplyreturnsitsaddressimmediately,unlessRESTARTFLGistrue,inwhichcasethecacheofClearinghouseinformationisinvalidatedandanewbroadcastisperformed.START.CLEARINGHOUSEisnormallyperformedautomaticallybythesystemthefirsttimeitneedsClearinghouseinformation;however,itmaybenecessarytocallitexplicitly(withRESTARTFLGset)ifthelocalClearinghouseservergoesdown.CH.NET.HINT[Variable]Anumberorlistofnumbers,givingahintastowhichnetworkthenearestClearinghouseserverison.WhenSTART.CLEARINGHOUSElooksforaClearinghouseserver,itprobesthenetwork(s)givenbyCH.NET.HINTfirst,performingtheexpandingringbroadcastonlyifitfailsthere.IfthenearestClearinghouseserverisnotonthedirectlyconnectednetwork,settingCH.NET.HINTtothepropernetworknumberinthelocalINITfilecanspeedupSTART.CLEARINGHOUSEconsiderably.(SHOW.CLEARINGHOUSEENTIRE.CLEARINGHOUSE?DONT.GRAPH)[Function]ThisfunctiondisplaysthestructureofthecachedClearinghouseinformationinawindow.Oncecreated,itwillberedisplayedwheneverthecacheisupdated,untilthewindowisclosed.ThestructureisshownusingtheLibrarypackageGRAPHER.IfENTIRE.CLEARINGHOUSE?istrue,thenthisfunctionprobestheClearinghousetodiscovertheentiredomain:organizationstructureoftheInternet,andgraphstheresult.IfDONT.GRAPHistrue,thestructureisnotgraphed,butrathertheresultsarereturnedasanestedlistindicatingthestructure.(LOOKUP.NS.SERVERNAMETYPEFULLFLG)[Function]Returnstheaddress,asanNSADDRESS,fortheobjectNAME.TYPEisthepropertyunderwhichtheaddressisstored,whichdefaultstoADDRESS.LIST.Theinformationiscachedsothatitneednotberecomputedoneachcall;thecacheisclearedbyrestartingtheClearinghouse.IfFULLFLGistrue,returnsalistwhosefirstelementisthecanonicalnameofNAMEandwhosetailistheaddresslist.ThefollowingfunctionsperformvarioussortsofretrievaloperationsondatabaseentriesintheClearinghouse.Here,"TheClearinghouse"referstothecollectiveserviceofferedbyalltheClearinghouseserversonaninternet;Lispinternallydealswithwhichactualserver(s)itneedstocontacttoobtainthedesriedinformation.Theargument(s)describingtheobjectsunderconsiderationcanbestringsorNSNAME's,andinmostcasescan���îGÀïvî
êïførî	ôïh„s�î
Ëïh„î¢ïb
r
î÷î÷ïb
uïb
îÅïb
rïb
î
î[
î»î»ïb
uïb
î#3ïb
rïb
î#‹
î$É
î+¨
î-)
î.ìî6î:vî<ÿ�î=üîB0îEÖ
îGîGïb
î¢ï`~îcî»
î]î Ïî#ç
î%î%ï`~uï`~î(’ï`~rï`~î(ê
î*(�î+%
î,¦
î.<î2î6î84î?Õ
îAîFÊîJîJï`~î¢ï^ûîÏï^ûî¢ï\
î÷î÷ï\uï\îoï\rï\îÇ
îî!¨
î#kî'R
î(Ýî+¾î+¾ï\sï\î0Èï\rï\�î1xî4o
î5—
î6Õî<?
î=À
î>þî@ªî@ªï\uï\îExï\rï\îEÐ
îGîHç
îJ}îJ}ï\î¢ïZ‹îNîî!“î)4î,mî.“î4Jî5öî5öïZ‹uïZ‹î:ÄïZ‹rïZ‹î;
î<Z�î=b
î>øî@xïZ‹sïZ‹î@~ïZ‹î	ôïWžîîïWžuïWžî\
î' ïWžsïWž�î'÷ïWžrïWžî(Oî(§î0 	î6FïWžî¢ïVîBîBïVuïVî!FïVrïV�î!ö
î#¹î' 
î)+î,î,ïVsïVî1ïVrïV�î1Æ
î3Fî4òî8˜îA±îB	
îC^îC^ïVî¢ïT†u
îfïT†rïT†î¾
î üî$	î&:î(•î-8î0É
î2î7ê	î>9îA½îD\îF‚îJîJïT†î¢ïS
î"îSîÊî ðî%ÙïSî	ôïP
î3îî	
î‰	î }î }ïPsïPî(ïPrïPî(dî*íî*íïPsïPî/÷ïPrïPî0Oî4ºî9}î=Çî@¦îB×îGšîGšïPî	ôïN“îîïN“sïN“îïN“rïN“�îpïN“qïN“îvïN“î	ôïHÍîî\îwî)îûïHÍrïHÍî
ïHÍî	ôïEÈîÞîIîÿîÊîiî"?
î$î'
î(î,m
î3Â
î5Bî7s
î@>ïEÈsïEÈî@DïEÈî	ôïBÛî—î—ïBÛuïBÛ	î#ïBÛsïBÛ�î#êïBÛrïBÛî$Bî$šî0 	î6FïBÛî¢ïAOîX
îî$—î'Kî-C
î.Ãî2H
î3Èî6‡î8¸î=;îFîJ=îJ=ïAOî¢ï?Ìî îZ
î ‚î%\î%´
î'	�î(î0Òî3î7¼î:êî?ÎîB@îG‡îG‡ï?Ìî¢ï>Iîáîdî!î%Êî-Åî1¸î1¸ï>Iuï>I	î94ï>Irï>Iî9Œ
î:Êî=×
î?WîC4îEôîH%îH%ï>Iî¢ï<Æî>
îÉî$•
î+ê
î-(
î4î6Ž�î7‹î:Kî@C
îA	îHjîHÂîHÂï<Æî¢ï;Csî&—ï;Crï;Cî&ï
î(-î-Ëî4]î<™
î>gî@˜îDäîGîI¾îI¾ï;Cî¢ï9·î˜
îÀîrî'>î/î4·
î5ßî8µ
î:xî@[
îAÛîD6
îE^îE^ï9·î¢ï84	îUî¹î¹ï84uï84	î'5ï84rï84î'î)õ
î+(î-Yî0nî9:î=î@îCï84sï84îC£ï84î	ôï5G
î1ï5Grï5Gî‰îáî0 	î5äï5Gî¢ï3»�î
îý
î“î ¡
î",î(î+ö�î,óî/§
î1(
î2¨î6…î;«î=ÜîB_îB_ï3»î¢ï28înî#L
î$Šî&¹î'î*úî*úï28sï28î:ïï28rï28î;Gî>³î@Â�îA¿îJ‹îJ‹ï28î¢ï0¬îØ
î�î Kî"|	î)î,
î.kî.kï0¬sï0¬
î7¨ï0¬rï0¬î8�î;
	îB�îD1îJ­îJ­ï0¬î¢ï/ îVîNî"8
î#k
î$“î'Qî+
î,Wî.ˆî3î;×î?µ
î@óîC9
îEîGBîGBï/ î¢ï-îeî!µî'3î+hî+hï-sï-
î4¥ï-rï-î4ý
î6}î8®î<ùîBîG
îH›îH›ï-î¢ï,îÓîèîèï,sï,îDï,rï,îœî!Öî$3î'å
î)Éî)Éï,sï,î9¾ï,rï,î:îAÙï,sï,îAßï,î	ôï)$îÀîÀï)$uï)$î*6	î1Ìï)$sï)$�î2£ï)$rï)$î2ûî3Sî6š	î<Àï)$î¢ï'˜îŒîÓî#Øî&	î+”
î-î/Pî3²î<~
îCÓ
îES�îFPîFPï'˜î¢ï&îóîKîºî$«
î%Óî(N
î*
î1&î7*î9[î<÷
î>5îCµîFËîHüîHüï&î¢ï$’îœ
îÚî!.î!†î$/î)º
î*øî/î2‘î4Âî9…î>–î>–ï$’sï$’îDwï$’rï$’�îDÔï$’î¢ï!¥
î÷î÷ï!¥uï!¥î''ï!¥rï!¥î'
î(½î+Êî.Áî13î6zî:Åî<öîEÂ
îGBîGBï!¥î¢ï "îÓîî!Àî.Pî3Û
î5fî7—î=
î?ŠîCËîEüîIîîJFîJFï "î¢ïŸ
î÷î÷ïŸuïŸ	îïŸrïŸîå
î!#î$0î&aî+ì
î-*î/pî4ðî7Bî; î=QîApîC–îI�
îJîJïŸî¢ï�îŸî¿îÍ	î#úî&+	î+µïsïî+»ïî	ôï/îîï/uï/îÐî î%^ï/sï/�î&5ï/rï/î&î&åî0 	î6Fï/î¢ï£î©îÚî"ì
î$m
î&0î&0ï£sï£î-¿ï£rï£�î.oî0~î2¯î6–î6–ï£uï£î:ï£rï£�î:½î;î;mî;mï£uï£î>iï£rï£î>Á
î?ÿîB0îG™îG™ï£î¢ïîuîRî ƒî%=
î&{î*Æî.£î3ž
î5î5ïsïî?2ïrï�î?áî@9îBâ
îJ7îJ7ïî¢ï‹
îàîB
îØî w
î!Ÿî$Íî'
î(Ö	î09
î2î5î7çî:î=´
î>òîC
îEMîEMï‹î¢ï	î„îµ
î'Øî(0
î)…î)…ïuïî.Ñïrïî/)
î0gî3tî7÷�î8ôî;î?�îA©îF¯
îGíîJîJïî¢ï…î‚î 
î!žî!žï…uï…î%ï…rï…î%nî'÷î+õî.$
î/bî1“î6Mî8`ï…î	ôï¡îî{îFîmî"î%
î&›î+Ì	î2F
î4î9ˆî=È
î?HîAy
îJœîJôîJôï¡î	ôïî
‘îê
îfî

îî!¾	î'’î+èî0€
î2Nî4î6@î?îCn
îEF
îG	îG	ïî	ôï›î]îG	î=î‹îvî"Sî&%î+y
î,¡î0S
î1Óî6`
î7àî;óî>$îB¼îJhîJÀîJÀï›î	ôïî
î	îqî¢î!
î$àî-î/y
î1<î5f
î6üî6üïsïî<ïrïî=’î@
îA›îDÈîHîJiîJiïÿ�������o����
êq?€`½í������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������3containthewildcard"*",whichmatchesasubsequenceofzeroormorecharacters.Wildcardsarepermittedonlyinthemostspecificfieldofaname(e.g.,intheobjectpartofafullthree-partname).Whenanoperationintendedforasingleobjectisinsteadgivenapattern,theoperationisusuallyperformedonthefirstmatchingobjectinthedatabase,whichmayormaynotbeinteresting.(CH.LOOKUP.OBJECTOBJECTPATTERN)[Function]LooksupOBJECTPATTERNintheClearinghousedatabase,returningitscanonicalname(asanNSNAME)iffound,NILotherwise.IfOBJECTPATTERNcontainsa"*",returnsthefirstmatchingname.(CH.LIST.ORGANIZATIONSORGANIZATIONPATTERN)[Function]ReturnsalistoforganizationnamesintheClearinghousedatabasematchingORGANIZATIONPATTERN.Thedefaultpatternis"*",whichmatchesanything.(CH.LIST.DOMAINSDOMAINPATTERN)[Function]Returnsalistofdomainnames(two-partNSNAME's)intheClearinghousedatabasematchingDOMAINPATTERN.Thedefaultpatternis"*",whichmatchesanythinginthedefaultorganization.(CH.LIST.OBJECTSOBJECTPATTERNPROPERTY)[Function]ReturnsalistofobjectnamesmatchingOBJECTPATTERNandhavingthepropertyPROPERTY.PROPERTYisanumberorasymbolicnameforaClearinghouseproperty;thelatterincludeUSER,PRINT.SERVICE,FILE.SERVICE,MEMBERS,ADDRESS.LISTandALL.Forexample,(CH.LIST.OBJECTS"*:PARC:Xerox"(QUOTEUSER))returnsalistofthenamesofusersinthedomainPARC:Xerox.(CH.LIST.OBJECTS"*lisp*:PARC:Xerox"(QUOTEMEMBERS))returnsalistofallgroupnamesinPARC:Xeroxcontainingthesubstring"lisp".(CH.LIST.ALIASESOBJECTNAMEPATTERN)[Function]ReturnsalistofallobjectsintheClearinghousedatabasethatarealiasesandmatchOBJECTNAMEPATTERN.(CH.LIST.ALIASES.OFOBJECT)[Function]ReturnsalistofallobjectsintheClearinghousedatabasethatarealiasesofOBJECT.(CH.RETRIEVE.ITEMOBJECTPROPERTYINTERPRETATION)[Function]RetrievesthevalueofthePROPERTYpropertyofOBJECT.Returnsalistoftwoelements,thecanonicalnameoftheobjectandthevalue.IfINTERPRETATIONisgiven,itisaClearinghousetype(seesectionX.XX)withwhichtointerpretthebitsthatcomeback;otherwise,thevalueissimplyoftheform(SEQUENCEUNSPECIFIED),alistof16-bitintegersrepresentingthevalue.(CH.RETRIEVE.MEMBERSOBJECTPROPERTY---)[Function]RetrievesthemembersofthegroupOBJECT,asalistofNSNAME's.PROPERTYisClearinghouseGrouppropertyunderwhichthemembersarestored;theusualpropertyusedforthispurposeisMEMBERS.(CH.ISMEMBERGROUPNAMEPROPERTYSECONDARYPROPERTYNAME)[Function]TestswhetherNAMEisamemberofGROUPNAME'sPROPERTYproperty.Thisisapotentiallycomplexoperation;seethedescriptionofprocedureIsMemberintheClearinghouseProtocoldocumentationfordetails.���îJiïî
êïførîI“ïh„s�îJjïh„î	ôïb
rî¡îÒî±î’�îBïb
sïb
�îïb
rïb

îyîVî"s�î#p
î+7
î,Âî/–
î1,î4
î;"î;zîAÉîCïîJîJïb
î	ôï`uîÞ
î^îî¼îtît
îÿ�îüî!î$¹
î&9î(jî,Qî/
î0‘�î1Žî3é	î:î>zî>ÒîB»
îD~îJtîJtï`uî	ôï^òî~î�îŠîEî,
îjîìî#q�î$nî)Tî+…î1{
î2¹î7:î=Ì
î?¤îAÕîD~îJJîJJï^òî	ôï]oî
Û
î[îŒîNî+î

î—î"mî$³
î&vî,ûï]osï]oî-
ï]oî	ôïZ‚îîïZ‚uïZ‚î"ÉïZ‚sïZ‚�î# ïZ‚rïZ‚î#øî$Pî0 	î6FïZ‚î¢ïXöî’
îvîvïXöuïXöî&-ïXörïXöî&…
î(î*6î3î8Äî>›î@GîF'îI¸îI¸ïXöî¢ïWsîœ
î_î_ïWssïWsîiïWsrïWs�î :
î!mî%¢î%¢ïWssïWsî('ïWsrïWsî(	î.Íî/%
î0zî0zïWsuïWsî:1ïWsrïWsî:‰î?º�î@·�îAgïWssïWs�îB>ïWsrïWs
îCžîH!îJRîJRïWsî¢ïUçîKîî"§ïUçsïUçî"­ïUçî	ôïRúîEîEïRúuïRúî+¯ïRúsïRú�î,†ïRúrïRúî,Þî-6î0 	î6FïRúî¢ïQnî©�î¦î´
î ?î'àî+õ
î-uî/¦î8rî=ÜîC¨îC¨ïQnî¢ïOëuî%ïOërïOë�î%»î(dî,Ûî1i
î2§�î3WïOësïOë�î4.ïOërïOë
î5Žî9kî>ˆîDïOësïOëîDïOëî	ôïLþî;î;ïLþuïLþî"~ïLþsïLþ�î#UïLþrïLþî#­î$î0 	î6FïLþî¢ïKrî©�î¦î´
î ?î%
î)"î.îî.îïKrsïKrî3øïKrrïKrî5¥
î7%î9VîB"îGŒîGŒïKrî¢ïIæînînïIæuïIæî&±ïIærïIæ�î'`î*	î.€î3
î4L�î4üïIæsïIæ�î5ÓïIærïIæ
î73î;î@-îE¬
îG,îI]îI]ïIæî¢ïHZîî"¹ïHZsïHZî"¿ïHZî	ôïEmî;î;ïEmuïEmî"8î(\ïEmsïEm�î)3ïEmrïEmî)‹î)ãî0 	î6FïEmî¢ïCáî©�î¦î´
î ?î$&î(;î.î.ïCáuïCáî7¾ïCárïCáî8î:Ÿî>êîAîF„îF„ïCáî¢ïB^uîÆïB^rïB^�îïB^uïB^îcî#‡ïB^rïB^î#ß
î%�î&î+
î,¬�î-©î3<î6Íî8Ü�î9ÙîB¥îH‡îJ¸îJ¸ïB^î¢ï@Ûîî³î³ï@Ûsï@Ûî"ï@Ûrï@Û�î"¿î"¿ï@Ûsï@Ûî-ªï@Ûrï@Û�î.Zî.Zï@Ûsï@Ûî8nï@Ûrï@Û�î9î9ï@Ûsï@Ûî>ÿï@Ûrï@Û�î?¯î?¯ï@Ûsï@ÛîIÃï@Ûrï@ÛîJîJï@Ûî¢ï?Oî+î+ï?Osï?Oî°ï?Orï?O�î
ï?Oî¢ï<bîîfï<bsï<bîlï<bî¢ï9uî$é
î1‚î7cî<mï9urï9uî<sï9uî¢ï6ˆî%�î"î0
î»î!ìî&

î'Œî*Û
î,[î.Œî3Z
î;¢ï6ˆsï6ˆî;¨ï6ˆî¢ï3›î$éî5µî;–îC%ï3›rï3›îC+ï3›î¢ï0®î%�î"î0
î»î!|î%Nî)c
î*ã	î3,	î9±î;âîA˜îE]ï0®sï0®îEcï0®î	ôï-Áî;î;ï-Áuï-Áî%jï-Ásï-Á�î&Aï-Árï-Áî&™î&ñî0 	î6Fï-Áî¢ï,5î©�î¦î´
î ?î"�î&k
î'ëî*î2èî8Rî:ñî=îA*îC³îG§îG§ï,5î¢ï*²uî#Ñï*²rï*²�î$(ï*²sï*²î$.ï*²î	ôï'ÅîÀîÀï'Åuï'Åîï'Åsï'Å�îôï'Årï'Åî Lî ¤î0 	î6Fï'Åî¢ï&9î©�î¦î´
î ?î"�î&k
î'ëî*î2èî8Rî:ñî=îA*
îBµîBµï&9uï&9îGï&9rï&9�îGiï&9sï&9îGoï&9î	ôï#Lîîï#Luï#Lîµî$
î.kï#Lsï#L�î/Bï#Lrï#Lî/šî/òî0 	î6Fï#Lî¢ï!Àîyîªî"$
î#¯î%àî%àï!Àuï!Àî,ï!Àrï!Àî,\î1Å
î3Pî3Pï!Àuï!Àî7­ï!Àrï!À�î8\î8´î=»�î>¸î@Æ
îBQîDÎîJ°îJ°ï!Àî¢ï =îÓî³î"D
î#Ïî&�î)çî,pî.¡î2rî2Ê
î4î4ï =uï =
î>kï =rï =î>Ã
î@
îCÞ
îE
îFD�îGAîGAï =î¢ïºînî"Oî$îî)Yî-™î0„î4a
î5áî;Uî=†î?øîB—îFîI¡îI¡ïºî¢ï7	îñî"î"œ
î#Úî(
î)¤î+Õî/
î/
ï7sï7î7sîA‡ï7rï7�îB7�îC4îEB
îFÍîJ”îJ”ï7î¢ï«î’î#7î%hî(áï«sï«î(çï«î	ôï¾î—î—ï¾uï¾î :î&¤î'Çï¾sï¾�î(žï¾rï¾î(öî)Nî0 	î6Fï¾î¢ï2îyîªî$l
î%÷î((î+úî+úï2uï2î0Wï2rï2�î1
î2ˆ�î3…î5“
î7î7ï2sï2î<(ï2rï2î=³î>î>ï2uï2îD/ï2rï2îD‡
îEÅîEÅï2î¢ï¦înî#¹î)"î,õî0Òî3î8Åî:ëî?WîAˆîD÷îJ`îJ`ï¦î¢ï#î¯î¾î0î#A
î$î$ï#sï#î*`ï#rï#�î*·ï#sï#î*½ï#î	ôï6îßîßï6uï6î¡î#î0£î4ï6sï6�î4òï6rï6î5Jî5¢î6š	î<Àï6î¢ïªîûîîïªuïªî"ïªrïªî"è
î$&�î%#î*a
î+ìî+ìïªuïªî3hïªrïª
î4œî4œïªuïªî:Àïªrïªî;î@ØîA0îD
îEX�îFUîFUïªî¢ï'
î<î"Ž	î(ýî+#î-T
î41
î5¼î<î<ï'sï'îBÄï'rï'îC
îDœîFÍîFÍï'î¢ï›înî$³î-âî/ñî4ï›qï›î4ï›ÿ�������	‘����
êq?€`½o��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������41.3NSPrintingThissectiondescribesthefacilitiesthatareavailableforprintingInterpressmastersonNSPrintservers.(NSPRINTPRINTERFILEOPTIONS)[Function]ThisfunctionprintsanInterpressmasteronPRINTER,whichisaClearinghousenamerepresentedasastringorNSNAME.IfPRINTERisNIL,NSPRINTusesthefirstprintserverregisteredinthedefaultdomain.FILEisthenameofanInterpressfiletobeprinted.OPTIONSisalistinpropertylistformatthatcontrolsdetailsoftheprinting.Possiblepropertiesareasfollows:DOCUMENT.NAMEThedocumentnametoappearontheheaderpage(astring).Defaultisthefullnameofthefile.DOCUMENT.CREATION.DATEThecreationdatetoappearontheheaderpage(aLispintegerdate,suchasreturnedbyIDATE).Thedefaultvalueisthecreationdateofthefile.SENDER.NAMEThenameofthesendertoappearontheheaderpage(astring).Thedefaultvalueisthenameoftheuser.RECIPIENT.NAMEThenameoftherecipienttoappearontheheaderpage(astring).Thedefaultisnone.#COPIESThenumberofcopiestobeprinted.Thedefaultvalueis1.MEDIUMThemediumonwhichthemasteristobeprinted.Ifomitted,thisdefaultstothevalueofNSPRINT.DEFAULT.MEDIUM,asfollows:NILmeanstousetheprinter'sdefault;Tmeanstousethefirstmediumreportedavailablebytheprinter;anyothervaluemustbeaCouriervalueoftypeMEDIUM.Theformatofthistypeisalist(PAPER(KNOWN.SIZETYPE))or(PAPER(OTHER.SIZE(WIDTHLENGTH))).ThepaperTYPEisoneofUS.LETTER,US.LEGAL,A0throughA10,ISO.B0throughISO.B10,andJIS.B0throughJIS.B10.STAPLE?Trueifthedocumentshouldbestapled.#SIDES1or2toindicatethatthedocumentshouldbeprintedononeortwosides,respectively.ThedefaultisthevalueofEMPRESS#SIDES.PRIORITYThepriorityofthisprintrequest,oneofLOW,NORMAL,orHIGH.Thedefaultistheprinter'sdefault.(NSPRINTER.STATUSPRINTER)[Function]Thisfunctionreturnsalistdescribingtheprinter'scurrentstatus---whetheritisavailableorbusy,andwhatkindofpaperisloaded.(NSPRINTER.PROPERTIESPRINTER)[Function]Thisfunctionreturnsalistdescribingtheprinter'scapabilitiesatthemoment---typeofpaperloaded,whetheritcanprinttwo-sided,etc.1.4NSFilingLispaccessesXeroxNSfileserversusingtheNSFilingProtocol.Formostoperations,theprogrammersimplytreatstheNSfileserverasanyotherhostordevice.OPENFILE,GETFILEINFO,DIRECTORYallworkappropriatelywhenthefilenamespecifiesanNSfileserverhostname,e.g.,���î4ï›î
êïg2qî	ôïh„s�î
Ëïh„î	ôïb
qîî\îw
î½îˆïb
rïb
îŽïb
î	ôï^üîÞîIîÿî0	î_î þî#$î(¬î*»î/Ë	î5ûî:À
î<˜
î>ØîBîF|ï^üsï^üîF‚ï^üî	ôï\îƒîƒï\uï\îæîÛî
ï\sï\�îáï\rï\î 9î ‘î0 	î6Fï\î¢ïZƒîŒîÓî"
î$R	î*‚î.Ã
î0›î0›ïZƒuïZƒî5¸ïZƒrïZƒ�î6hî:E
î;ƒ�î<€îELîHÝîHÝïZƒî¢ïY�
îÚ
î[�î Xî#þ
î%”î%”ïY�sïY�î*žïY�rïY��î+Mî+¥
î,úî,úïY�uïY�î2ïY�rïY�î2o
î3­î3­ïY�sïY�î62ïY�rïY��î6âî6âïY�sïY�î<ÃïY�rïY�î=î?æîBîDÀîGøîGøïY�î¢ïWtî€	î ™
î"î$Jî(Áî-æî-æïWtuïWtî0•ïWtrïWtî0í
î2+î4\î7í
î9x
î;;	îAkîC¥
îE%
îFèîFèïWtî¢ïUñîœîôîôïUñuïUñî!#ïUñrïUñî!{
î"¹�î#¶î%Ä
î'Dî,­î.»î3î5¥î:©î>Ç
î@RîBƒîGêîHBîHBïUñî¢ïTnî¼	î"�î$&
î%§î*RïTnsïTnî*XïTnî¢ïQî!ïQrïQî!åî"=î"•î"Âî%kî+¥î/6
î0¶î5

î6åî9î=mî@…
îAûîFqîFÉîFÉïQî ÔïOõî%£
î&áî)î+mî.þ
î0‰î2ºî4óïOõsïOõî4ùïOõî¢ïMî)ïMrïMî)tî)Ìî*$î*3î,Üî1ìî4Â
î6Bî:™
î<qî>¢îBùîF
îG‡îJqîJqïMî ÔïK|î%@î(nî+p
î,ñî2[
î4)î4)ïK|sïK|î8\ïK|rïK|
î9„î9Üî<…î@üîDv
îE´îGåîGåïK|î ÔïIðî%äî(º
î*Eî,vî.¯ïIðsïIðî.µïIðî¢ïG
îßïGrïGî 7î î çî"Âî%kî(ü
î*‡î,¸î0î
î2nî6Å
î8î:Îî?%îB=
îC³îH)îHîHïGî ÔïEwî#}î'ôî+n
î,¬î.Ýî2n
î3ùî6*î8ôïEwsïEwî8úïEwî¢ïBŠ
î"dïBŠrïBŠî"¼î#î#lî%=î'æî+w
î-î/3î4±
î61î:ˆ
î<`î>‘îBèîF�
îGvîGvïBŠî Ôï@þî%Jî%¢î(Kî,Â
î.�î1Bï@þsï@þî1Hï@þî¢ï>îƒï>rï>îÛî3î‹î Ôî#}î(y
î*î.

î/
î1Dî6>î6–î9?î=¶îA0
îBn
îCuï>sï>îC{ï>î¢ï;$î¬ï;$rï;$îî\î´î Ôî#}î(º
î*’î.oî0 î4á
î6
î7Ÿ
î9bî>\î>´
î@	îEEîG·îG·ï;$î Ôï9˜î%Ï
î'Oî)€î,ú
î.…î.…ï9˜sï9˜î@ÿï9˜rï9˜�îA¯
îC0îH3îH‹îH‹ï9˜î Ôï8sî#Yï8rï8î#±î'Æ
î)Fî+î-¾î2ûî7ëî7ëï8sï8�î8Âï8rï8î9î=/
î>¯î@öîC'îEÐîEÐï8î Ôï6€î&î+oî0÷
î2Åî4öî9Ðî<Cî?²îC,îFe
îH(�îI%îI%ï6€î Ôï4ýî%¸î)2
î*½î-žî-žï4ýsï4ýî2¨ï4ýrï4ý�î3Wî3¯î6Xî:£
î<.î> îA
îB¿�îC¼îEÊîEÊï4ýî Ôï3qsî&µ
î0Éî0Éï3quï3qî3Åï3qsï3q
î5sï3qrï3qî5Ë
î7aî7aï3qsï3qî=B
îGVîGVï3qî Ôï1å�î!«ï1åuï1åî&î*Øï1åsï1åî-]ï1årï1å�î.î.dî1
î4¿î4¿ï1åuï1åî7»ï1årï1åî8
î9Qî;Î
î=Yî=Yï1åsï1åîDèï1årï1å�îE˜îE˜ï1åî Ôï0Ysî'Œï0Yrï0Y�î(<î(<ï0Ysï0Y
î)êï0Yrï0Yî*Bî/Hî/Hï0Ysï0Yî1Íï0Yrï0Y�î2}î2}ï0Ysï0Yî7‡ï0Yrï0Yî7ßî<åî<åï0Ysï0YîBÆï0Yrï0Y�îCvîEÿîEÿï0Yî Ôï.Ísî%Þï.Írï.Íî&6î+<î+<ï.Ísï.Íî1ï.Írï.Í�î1tï.Ísï.Íî1zï.Íî¢ï+àîƒï+àrï+àîÛî3î‹î Ôî$

î%4î'eî-Ÿî1é
î3¬î8-ï+àsï+àî83ï+àî¢ï(óî¬ï(órï(óîî\î´î Ô�î!Ü
î#r�î$z
î%úî*ôî-“î/Äî5þî:H
î<î@®
îB†îE
îF™îIîIï(óî Ôï'gî$Yî+ñî,Iî.òî3i
î4§î6Øî:R
î;Ýî;Ýï'gsï'gîFÈï'grï'g�îGï'gsï'gîG%ï'gî¢ï$zîZï$zrï$zî²î
îbî Ôî#}î(?
î)Êî,<î/tî4pî6í
î8xî8xï$zsï$zî:ýï$zrï$z�î;­î;­ï$zsï$zî@·ï$zrï$z�îAg
îBýîBýï$zsï$zîFYï$zrï$z�îGîG`îJ	îJ	ï$zî Ôï"îî%K
î&‰î(ºî-÷î2mï"îsï"îî2sï"îî	ôï 
îîï 
uï 
î/ï 
sï 
�îï 
rï 
î^î¶î0 	î6Fï 
î¢ïuîŒîÓî#V�î$Sî&a	î,Æî.÷î44î8ÍîB¤
îCÌ
îE
îJ’îJ’ïuî¢ïò
î8î¨î1î!_î$_
î%êî)œ
î*Úî/#ïòsïòî/)ïòî	ôïînînïuïî!‹ïsï�î"bïrïî"ºî#î0 	î6Fïî¢ïyîŒîÓî#V�î$Sî&a	î,Æî.÷î44î;
î<†î>·îGè
îIsîIsïyî¢ïöîTîöî$
î%;î'˜î*Ð	î15î39ïöqïöî3?ïöî	ôï0îî\îw
î½î)ï0rï0î/ï0î	ôï+îÞîåîØ
î
î\î!Öî$
î&Gî*!î/½î0î2‘î5¾
î<î>Á	îFqîJ°îJ°ï+î	ôï¨î
zî«
îë	î«
î,îŸîî!Ø
î#nî'Ùî(1î(1ï¨sï¨î.éï¨rï¨�î/™î/™ï¨sï¨
î8Öï¨rï¨�î9†î9†ï¨sï¨îAï¨rï¨îAmîC.îF{îF{ï¨î	ôïî1î·îèî[î"¢
î$e
î&¥î(ßî,½î/‡î3pî6#î6#ïÿ�������s����
êq?€`½z������������������������������������������������������������������������������������������������������������������������������������������������������5{PHYLEX:PARC:XEROX}<LISP>LIBRARY>GRAPHER.DCOM;1.NotethatallNSFileServerhostnamesmustcontainacolon,evenifthedomainandorganizationfieldsaredefaulted,inorderthattheybedistinguishablefromothertypesofhostnames(e.g.,Pupservernames).NotealsothatspacesareallowablecharactersinNSnames.Thus,ifanNSfilenamecontainsspaces(inthefilenameortheservername)andispresentedasalitatom,thespacesmustbequotedwith%.However,allthestandardfileoperationsalsoworkwhenthenameispresentedasastring,inwhichcasethereisnoproblemwithspaces.ThefollowingarefeaturesspecifictoNSfileservers.(BREAK.NSFILING.CONNECTIONHOST)[Function]ClosesanyopenconnectionstoNSfileserverHOST.FILING.ENUMERATION.DEPTH[Variable]ThefullNSFilingProtocolsupportsatruehierarchicalnamespaceforfiles.ThisleavessomeambiguityabouthowdeepthefunctionDIRECTORYshouldenumeratefiles.ThedepthiscontrolledbythevariableFILING.ENUMERATION.DEPTH,whichiseitheranumber,specifyingthenumberoflevelsdeeptoenumerate,orT,meaningenumeratetoalllevels.Intheformercase,whentheenumerationreachesthespecifieddepth,onlythesubdirectorynamerootedatthatlevelislisted,andnoneofitsdescendantsislisted.WhenFILING.ENUMERATION.DEPTHisT,allfilesarelisted,andnosubdirectorynamesarelisted.FILING.ENUMERATION.DEPTHisinitiallyT.IndependentofFILING.ENUMERATION.DEPTH,arequesttoenumeratethetop-levelofafileserver'shierarchylistsonlythetoplevel,i.e.,assumesadepthof1.Forexample,(DIRECTORY'{PHYLEX:})listsexactlythetop-leveldirectoriesoftheserverPHYLEX:.1.5SPPStreamInterfaceThissectiondescribesthestreaminterfacetotheSequencedPacketProtocol.SPPisthetransportprotocolforCourier,whichinturnisthetransportlayerforFilingandPrinting.(SPP.OPENHOSTSOCKETPROBEPNAMEWHENCLOSEDFN)[Function]ThisfunctionisusedtoopenabidirectionalSPPstream.Therearetwocases:userandserver.User:IfHOSTisspecified,anSPPconnectionisinitiatedtoHOST,anNSADDRESSorstringrepresentinganNSaddress.Ifthesocketpartoftheaddressisnull(zero),itisdefaultedtoSOCKET.IfbothHOSTandPROBEParespecified,thentheconnectionisprobedforaresponsebeforereturningthestream;NILisreturnedifHOSTdoesn'trespond.Server:IfHOSTisNIL,apassiveconnectioniscreatedwhichlistensforanincomingconnectiontolocalsocketSOCKET.SPP.OPENreturnstheinputsideofthebidirectionalstream;thefunctionSPPOUTPUTSTREAMisusedtoobtaintheoutputside.ThestandardstreamoperationsBIN,READP,EOFP(ontheinputside),andBOUT,FORCEOUTPUT(ontheoutputside),aredefinedonthesestreams,asisCLOSEF,whichcanbeappliedtoeitherstreamtoclosetheconnection.NAMEisamnemonicnamefortheconnectionprocess,mainlyusefulfordebugging.WHENCLOSEDFNisanoptionalfunctionorlistoffunctionstocallwhenthestreamisclosed,eitherbytheuserortheserver.(SPPOUTPUTSTREAMSTREAM)[Function]��î6#ïî
êïførîI“ïh„s�îJjïh„î	ôïb
ð/î1mïb
rïb
�î2î2tî5»î8Zî:
î<[î?îC"îEìîJ
îJ
ïb
î	ôï`uî
-îÚ�î×î½îÕ
îî9î"î$î,1î/µî1Û	î8
î9•î=î?¹îBš
îD]îD]ï`uî	ôï^òî"îZîÉî.
î¹î!ƒî%˜î(Äî+yî/Wî4<î4”î7Ûî:xî=îA!îCGîI1îI1ï^òî	ôï]o	î/
î¯
îïî[î³îY
îŒ
îO
î!î#Éî'Zî,‹î0•î2Žî4¿î6ùî:Š
î< î>QîB/îF9îHÂ
îJ�îJ�ï]oî	ôï[ìî
î„�îîYîŠî”î Í
î"î'î)òî)òï[ìsï[ì�î*Éï[ìrï[ì�î+xî+Ðî1Ôî3•î5Æî;0î=j	îCäîFîIÎîIÎï[ìî	ôïZ`î
zî«î<
îzî‰
î
�îî!
î"…î&bî)"î,|
î-º
î/’î4äî7Ïî;ÞïZ`î	ôïW|îî{î¡îîU
îÕ
î"î(XïW|sïW|î(^ïW|î	ôïTî ¡î ¡ïTuïTî#ÓïTsïT�î$ªïTrïTî%î%Zî0 	î6FïTî¢ïSîÀî3î v
î'Á
î)A
î+î-»î1™î1™ïSuïSî4ËïSrïS�î5"ïSsïSî5(ïSî	ôïPîïPrïPîtîÌî0 	î5äïPî¢ïNŠîKî¦
îæî!Àî'î,c�î-`î0î7Jî:Ûî>aî@pîC…îCÝîFÇîJ¤îJ¤ïNŠî¢ïMîî Jî#ûî&Ðî)þî,/î1vî1vïMsïMî9ïMrïMî9]î=§îD:îGOîG§îJPîJPïMî¢ïK{î_
î	î!ê
î#¸î%éî*îî*îïK{sïK{î?ïK{rïK{�î?ÆîC£
îDáîH�îIšîIšïK{î¢ïIïîö	î":î$kî)g
î*òî.Œî1º
î3:	î:%
î;»î;»ïIïsïIï�î<’ïIïrïIï�î=BîB«îI>
îJ¾îJ¾ïIïî¢ïHcîcîTî¬
îNî î$àî'øî+~î-¯
î5î:.î<_îAèîEýîHçîHçïHcî¢ïFàîÓî ‚î$î(<
î)§î,Fî/\
î0šî4kî6ôî:7
î;Âî=n
îDÝ
îFîIëîJCîJCïFàî¢ïE]î‹î‹ïE]sïE]î.³ïE]rïE]î/
î0Iî0IïE]sïE]�î1 ïE]rïE]�î1Ðî3‘î6Oî8uî<Fî>Ï
î@§îHVîHVïE]î¢ïCÑî·îÝî ­î!î!ïCÑsïCÑî5-ïCÑrïCÑî5…
î6Ãî;Žî;ŽïCÑsïCÑ�î<eïCÑrïCÑ�î<ÂïCÑî¢ï@ä
î
î 
î 
ï@äsï@äî42ï@ärï@ä�î4â�î5ßî:ƒ
î<îB–îDÇîJDîJDï@äî¢ï?X
î-�î*îdî î&�î(’î+|î-­î/óî3aî5Æî:ã�î;àî?
îA(
îB‡îBßîE[îE[ï?Xî¢ï=ÕîBîBï=Õsï=Õ	î%
î.¼ï=Õrï=Õî/î1¦î6î8Cî=À
îD:
îEÅîGöîGöï=Õî¢ï<Iî€î€ï<Isï<Iî aï<Irï<I�î ¸ï<Iqï<Iî ¾ï<Iî	ôï6ƒîî\îwîwîîVï6ƒrï6ƒî\ï6ƒî	ôï3~îÞîIîÿî0îqî"å
î$eî&–î-Uî1Šî7&î7~î:>
î;|î=­îCXîH’îJ¡îJ¡ï3~î	ôï1ûî0î

îîc
î¡îÒî }î#µî%Äî)žî,'î1Aï1ûsï1ûî1Gï1ûî	ôï/îZîZï/uï/îÒî»î›î#Yî-Aï/sï/�î.ï/rï/î.pî.Èî0 	î6Fï/î¢ï-‚îŒîÓ
î î#
î$žî'á�î(Þî0 î3`î7øî8Pî<"î>Hî@ÅîD‚îGMîIÖîIÖï-‚î¢ï+ÿî…ï+ÿî¢ï)î>î–
îëîëï)uï)îï)rï)îu
î ³	î&”
î(Wî+	î1Þ
î3î8L
î9Ìî9Ìï)uï)î<þï)rï)�î=®
î?qî?qï)sï)îG�ï)rï)îGX
îHîîHîï)î¢ï'îHî!í
î#°
î%ðî+
î+Y
î,®î.ßî2Üî5‘
î7î9Mî>
î?EîAíîF
îG3
îHqîHqï'î¢ï&î„
îîï&uï&î"§ï&rï&�î#V
î$«î'·î'·ï&uï&î*éï&rï&î+Aî-Êî-Êï&uï&î2dï&rï&î2¼î4â	î:Ãî=ºî?ë	îF²
îGðîGðï&î¢ï$‰î/î>�î;î#¯î'Îî-¥î/Öî4î4ï$‰sï$‰î7ï$‰rï$‰î7m
î8«î>
î?Hî?Hï$‰uï$‰îBzï$‰rï$‰îBÒîG_îG_ï$‰î¢ï"ýî¸ï"ýî¢ï î;
îîï uï îÂï rï î 
î!Xî!Xï sï î#Ýï rï �î$�î%Šî*	î0Ó
î2î6ªî:‡î>„î@“
îBVîH+îH+ï î¢ï	îi
îéî!þî%ûî%ûïuïî*žïrï�î*õïsïî*ûïî¢ï îZï rï î²î"5î$fî'àî*‰
î,î.Eî6î:Áî<òîB9îB9ï î¢ïsî#;ïrïî#“
î$Ñî'Þ
î)^î-qî/¢î3âî6âî7:î9ãî?MîCŽ	îJîJïî¢ïˆsî'ïˆrïˆ�î×î×ïˆsïˆî
ïˆrïˆ�îºîºïˆsïˆî"ïˆrïˆî"nî$¿î&ðî*jî-äî0mî0mïˆsïˆî3Éïˆrïˆ�î4yî4yïˆsïˆ
î=¶ïˆrïˆî>î@_îBîFÐîJJîJJïˆî¢ïüîÈî—
îoî"Éî'æ
î)g
î*¥î*¥ïüsïüî/¯ïürïü�î0_î4<î6™
î8\î=
î>”îBPîF‘
îHîHïüî¢ïpîÙî

î"Ðïpuïpî"Öïpî¢ïŒîïŒrïŒîr
î°�î­î#>î&Ïî(Þî+	î1Öî6Ñî;1î?îA(	îHîH^îH^ïŒî¢ï	uî Šï	rï	î â
î" 
î#ãî)î.Y
î/ïî1ý
î3ˆî9S
î:Óî=.î@´îBåîG&
îHdîHdï	î¢ï†î÷î³
î î"²î%}
î'î)Dî-!ï†sï†î-'ï†î	ôï™î;î;ï™uï™î	ï™sï™�îàï™rï™î8îî0 	î6Fï™ÿ�������
N����
êq?€`½«������������������������������������������������������������������������������������������6AppliedtotheinputstreamofanSPPconnection,thisfunctionreturnsthecorrespondingoutputstream.SPP.USER.TIMEOUT[Variable]Specifiesthetime,inmilliseconds,towaitbeforedecidingthatahostisn'tresponding.(SPP.SENDEOMSTREAM)[Function]Transmitsthedatabufferedsofaronthisoutputstream,ifany,withtheEndofMessagebitset.Ifthereisnothingbuffered,sendsazero-lengthpacketwithEndofMessagebitset.(SPP.DSTYPESTREAMDSTYPE)[Function]Accessesthecurrentdatastreamtypeoftheconnection.IfDSTYPEisNIL,returnsthedatastreamtypeofthecurrentpacketbeingread.IfDSTYPEisnon-NIL,setsthedatastreamtypeofallsubsequentpacketssentonthisconnection,untilthenextcalltoSPP.DSTYPE.Sincethisaffectsthecurrentpartially-filledpacket,thestreamshouldprobablybeflushed(viaFORCEOUTPUT)beforethisfunctioniscalled.(SPP.EOMPSTREAM)[Function]ThisfunctionreturnsTorNILdependingonwhetherornotanEndofMessageindicationhasbeenreached.Thisisonlytrueafterthelastbyteofdatainthemessagehasbeenread.Byconvention,EOFPistrueofastreamthatisatEOM.(SPP.CLEAREOMSTREAMNOERRORFLG)[Function]ClearstheEndofMessageindicationonSTREAM.ThisisnecessaryinordertoreadbeyondtheEOM.CausesanerrorifthestreamisnotcurrentlyattheEndofMessage,unlessNOERRORFLGistrue.(SPP.SENDATTENTIONSTREAMATTENTIONBYTE)[Function]SendsanSPP"attention"packet,onewiththeAttentionbitsetandcontainingthesinglebyteofdataATTENTIONBYTE.1.6CourierRemoteProcedureCallProtocolCourieristheXeroxNetworkSystemsRemoteProcedureCallprotocol.ItusestheSequencedPacketProtocolforreliabletransport.Courierusesprocedurecallasametaphorfortheexchangeofarequestfromauserprocessanditspositivereplyfromaserverprocess;exceptionsorerrorconditionsarethemetaphorforanegativereply.Afamilyofremoteproceduresandtheerrorstheycanraiseconstitutearemoteprogram.Aremoteprogramgenerallyrepresentsacompleteservice,suchastheFilingorPrintingprogramsdescribedearlierinthischapter.FormoredetailaboutCourier,thereaderisreferredtothepublishedspecificationoftheCourierprotocol.Thefollowingdocumentationassumessomefamiliaritywiththeprotocol.ItdescribeshowtodefineaCourierprogramanduseittocommunicatewitharemotesystemelementthatimplementsaserverforthatprogram.Thissectiondoesnotdiscusshowtoconstructsuchaserver.1.6.1DefiningCourierProgramsACourierprogramdefinitionisafilepackagetypeandcommand,COURIERPROGRAMS.Thus,youcanuseGETDEF,PUTDEF,andEDITDEFtomanipulatethem,orusethefilepackagecommand(COURIERPROGRAMSname1name2...)tosavethem.ThefunctionCOURIERPROGRAMcanbeusedtodefineaCourierprograminitially.(COURIERPROGRAMNAME...)[NLambdaNoSpreadFunction]ThisfunctionisusedtodefineCourierprograms.Thesyntaxis���î6Fï™î
êïførî	ôïh„s�î
Ëïh„î¢ïb
rî¼
î<îmî"çî'(
î(³
î*vî-6
î4Uî6Çî<î@‘îBÂîBÂïb
î¢ï`~îcî#£î'ãï`~sï`~î'éï`~î	ôï]‘îdï]‘rï]‘î¼îî0 	î5äï]‘î¢ï\î+î\î!ª
î#*î+
î,˜î/bî3î8Þî;}�î<zî?DîB
îHöï\sï\îHüï\î	ôïYîßîßïYuïYî­ïYsïY�î„ïYrïYîÜî4î0 	î6FïYî¢ïWŒîÐî
î!×î'A
î(×î*Ñ
î,©î/î3[î7ô
î9'î;òî>ÝîAîCØ
îEcîJ·îJ·ïWŒî¢ïV	îîÖî.
îƒîÝ
î!î%ÿî+Áî/R�î0O
î7Mî;wî>bîA,
îB·îHîIùîIùïV	î¢ïT†îïT†sïT†î–ïT†î	ôïQ™
îîïQ™uïQ™îî¤ïQ™sïQ™�î{ïQ™rïQ™îÓî+î0 	î6FïQ™î¢ïP
îî<î"Õ	î)”î,u
î.�î01
î7Oî7§
î8üî8üïP
uïP
î=„ïP
rïP
î=Ü
î?î?ïP
sïP
îAŸïP
rïP
�îBOîFÒîIîIïP
î¢ïN	îaî B
î!Íî#þî(—î,Áî0\î3Ÿî3÷
î5Lî5LïNuïNî9ÔïNrïNî:,
î;jî>)ïNsïNî@®ïNrïN�îA^îA¶îD)îFZîFZïNî¢ïLõ	îaî B
î!Íî#Ž	î*„î/2î1ç
î3¿î61
î=Pî@fîB—îExîGÓ
îISîISïLõî¢ïKrs	îïKrrïKr�î·î î#”î&î*&î,Wî0ðî9£î>%î@VîD—îHáîHáïKrî¢ïIæîA
îî"²î%:î%:ïIæsïIæ
î.wïIærïIæ�î/Hî3gî5Ùî; 
î<^î@#ïIæsïIæî@)ïIæî	ôïFùîZîZïFùuïFùî(ïFùsïFù�îÿïFùrïFùîWî¯î0 	î6FïFùî¢ïEmîŒîÓî#Vî#VïEmsïEm�î$-ïEmrïEmî$…
î&î&ïEmsïEmî( ïEmrïEmî(øî/Š
î1bî6
î8î:[
î<î>è
î@sîEÇîEÇïEmî¢ïCá	îÙî î"Nî'–î*€
î+¾î.¨î1]î4jî6›î8ìî;Í
î=Xî@.
îA®îCßîIîIïCáî¢ïB^îéîîZî²
î! 
î(Õî(ÕïB^sïB^î,1ïB^rïB^î,‰
î-Çî0|
î2�î3î7Eî9ä
î;"
î<î@1ïB^sïB^î@7ïB^î	ôï?qî¶î¶ï?quï?qîÊ	î"ºï?qsï?q�î#‘ï?qrï?qî#éî$Aî0 	î6Fï?qî¢ï=åî«îÜî¦
î!1î&…	î,¼
î.”î.”ï=åuï=åî3bï=årï=å�î4î4iî7S
î8‘î>t
î?ôîCy
îDùîGåîGåï=åî¢ï<bî[îŒî!ˆî!àî&M
î(î+S
î,†î.·î2ø
î46î6|î<'
î=’î?ÃîB
îDîIÄîIÄï<bî¢ï:ßî•î•ï:ßuï:ß	î"…ï:ßrï:ßî"Ý
î$î&Ïï:ßsï:ßî&Õï:ßî	ôï7òîéîéï7òuï7òîýî(Æï7òsï7ò�î)ï7òrï7òî)õî*Mî0 	î6Fï7òî¢ï6fîu
î8îø
î%ìî*nî,ëî/Öî2î7ýî9ëî;Úî>c	îDèîGîGï6fî¢ï4ãî]î>
îÉî!Ÿî!Ÿï4ãuï4ãî+hï4ãrï4ã�î+¿ï4ãqï4ãî+Åï4ãî	ôï/îî\îwîDî(îî"?î'Wï/rï/î']ï/î	ôï,îØ
îîGî:î¼î Îî%Éî,$î.âî4sî4Ë
î6î8àî;îAÐîFîFï,î	ôï*•î9îHîÿ	î
îYî!=î$î*Xî,³
î.4�î/1î54î7Cî9tî?A
î@Ì�îAÉîFmîI¥�îJ¢îJ¢ï*•î	ôï)î¿îbîëî—îzîÓî!�î"î%æî+	î1ˆ
î3î6a	î<Ïî>õîA&îG)îI8�îJ5îJ5ï)î	ôï'î1îáî9�î˜î«
î6î­	î%î(
î*;î.î0ãî3@î6L	î<Y�î=VîAÍîG‚îGÚ�îI9îI9ï'î	ôï&îkîÉî~	îÏ�î Ìî&î+/î.1
î/²î1ãî5½
î7Sî<nîBPîHHîHHï&î	ôï$‰î
î‡îùî¸ï$‰î	ôï!¥îpîÔînîî[îŒî"¡
î#ßî(ñ
î*qî,¢î2Åî:r
î;ýî>.îCîH£îHûîHûï!¥î	ôï "îî{îªî Çî$+
î*™î-„î/µî5Fî5ž
î6èî<žî?s
î@óîDü�îEùîEùï "î	ôïŸîØî6î¿î
î.
î®
î#ìî&×�î'Ôî,Kî0—î5î8<	î?r�î@oîDMîF\îHûîHûïŸî	ôïî©î
îëîVîWîî!	î#Þ
î%^î+î.�î/î2ðïqïî2öïî	ôïVî
î
dîwîÛî¨îPïVrïVîVïVî	ôïQ�îSî7î•	î«
îé�îæî  î%1î(î*›î1"î1"ïQsïQî=»ïQrïQ�î>jî>ÂîBhîDðîGMîI”îI”ïQî	ôïÅsîþïÅrïÅ�î®î®ïÅsïÅî¸ïÅrïÅ�îhîñîñïÅsïÅîÒïÅrïÅî*
îª	î&žî*P
î+æî.-î0^î2˜î7©î=Øî=ØïÅî	ôï9sî;îEî"Oî%«ï9rï9î&
î'ƒî*Yî.
î.bî1î6Rî6Rï9sï9
îBï9rï9îBlîDÉ
îFŒîI™îI™ï9î	ôï­
îtî}�îzî^î¼	î†ï­sï­îŒï­î	ôïÀîdîdïÀuïÀî"îôïÀsïÀ�îËïÀrïÀî#î{î0 î6áî=5îBùïÀî¢ï4îŒîÓ
î î#
î$žî(§î-‹î3Äî4î6Åî:Ú
î;Àï4sï4î;Æï4ÿ�������	í����
êq?€`½8��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������7(COURIERPROGRAMNAME(PROGRAMNUMBERVERSIONNUMBER).DEFINITIONS)ThetailDEFINITIONSisapropertylistwherethepropertiesareselectedfromTYPES,PROCEDURES,ERRORSandINHERITS;thevaluesarelistsofpairsoftheform(LABEL.DEFINITION).Thesearedescribedinmoredetailasfollows:TheTYPESsectionliststhesymbolically-definedtypesusedtorepresenttheargumentsandresultsofproceduresanderrorsinthisCourierprogram.Eachelementinthissectionisoftheform(TYPENAMETYPEDEFINITION),e.g.,(PRIORITYINTEGER).TheTYPEDEFINITIONcanbeapredefinedtype(seenextsection),anothertypedefinedinthisTYPESsection,oraqualifiedtypenametakenfromanotherCourierprogram;theselatterarewrittenasadottedpair(PROGRAMNAME.TYPENAME).ThePROCEDURESsectionliststheremoteproceduresdefinedbythisCourierprogram.AproceduredefinitionisastylizedreductionoftheCourierdefinitionsyntaxdefinedintheCourierProtocolspecification:(PROCEDURENAMENUMBERARGUMENTSRETURNSRESULTTYPESREPORTSERRORNAMES)ARGUMENTSisalistoftypenames,oneperargumenttotheremoteprocedure,orNILiftheproceduretakesnoarguments.RESULTTYPESisalistoftypenames,oneforeachvaluetobereturned.ERRORNAMESisalistofnamesoferrorsthatcanberaisedbythisprocedure;eachsucherrormustbelistedintheprogram'sERRORSsection.TheatomsRETURNSandREPORTSarenoisewordstoaidreadability.TheERRORSsectionliststheerrorsthatcanberaisedbyproceduresinthisprogram.Anerrordefinitionisoftheform(ERRORNAMENUMBERARGUMENTS),whereARGUMENTSisalistoftypenames,oneforeachargument,ifany,reportedbytheerror.TheINHERITSsectionisanoptionallistofotherCourierprograms,someofwhosedefinitionsare"inherited"bythisprogram.Morespecifically,ifatype,procedureorerrorreferencedinthecurrentprogramdefinitionisnotdefinedinthisprogram,thesystemsearchesforadefinitionofitineachoftheinheritedprogramsinturn,andusesthefirstsuchdefinitionfound.TheINHERITSsectionisusefulwhendefiningvariantsofagivenCourierprogram.Forexample,ifonewantedtotryoutversion4ofCourierprogramBAR,andversion4differedfromversion3ofprogramBARonlyinasmallnumberofprocedureortypedefinitions,onecoulddefineaprogramNEWBARwithanINHERITSsectionof(BAR)andonlyneedtolistthefewchangeddefinitionsinsideNEWBAR.1.6.2CourierTypeDefinitionsThissectiondescribeshowtheCouriertypesdescribedintheCourierProtocoldocumentareexpressedinaLispCourierprogramdefinition,andhowvaluesofeachtypearerepresented.EachtypeinaCourierprogram'sTYPESsectionmustultimatelybedefinedintermsofoneofthefollowing"base"types,althoughthedefinitioncanbeindirectthrougharbitrarilymanylevels.Thatis,atypecanbedefinedintermsofanyothertypeknownbyanextantCourierdefinition.Thenamesofthebasetypesare"global";theyneednoqualification,nordotypenamesmentionedinthesameCourierprogram.TorefertoatypenotdefinedinthesameCourierprogram(ortoanynon-basetypewhenthereisnoprogramcontext),onewritesaQualified��î;Æï4î
êïg,sîI“ïh„�îJjïh„î¢ïb5î$î$ïb5uïb5î'Šïb5sïb5î(a�î)8ïb5uïb5î4ïb5sïb5î4ñî4ñïb5uïb5î?@ïb5sïb5�î@ïb5î¢ï`©îyîPî'�îÕîÕï`©uï`©
î"ï`©sï`©�î#gï`©rï`©î#mï`©î¢ï]¼îKîzîzï]¼uï]¼
î#5ï]¼rï]¼î#
î$Ë�î%Èî+1î-?î1(î3Y	î9î;Ãî@¾îCöîCöï]¼sï]¼îH)ï]¼rï]¼�îHÙîHÙï]¼î¢ï\0s	îï\0rï\0�î¸î¸ï\0sï\0î$Âï\0rï\0î%î'£î'£ï\0sï\0î.[ï\0rï\0�î/,î1]î5[î7î:
î;žî>Ë
î@VîB‡îE¿�îF8ï\0uï\0îJ
ï\0rï\0îJbîJbï\0î¢ïZ¤�îQîQïZ¤uïZ¤	î\ïZ¤rïZ¤
î„îÜî#®î%Ôî+Ì
î-Lî0°î4J
î5Ëî:|ïZ¤î¢ïWÀîKîKïWÀsïWÀî~ïWÀrïWÀîÖî"Aî$Óî'î3 î7î:
î;’îA_îCîJ
îJ
ïWÀî¢ïV4î+îJ
îÕ	î%©î(2î+ù
î-yî/ëî4Ïî:„î:Üî>îC%
îD¥îGîGïV4î¢ïT±î

îK
îÖî î#?�î#¸ïT±uïT±î*,ïT±rïT±î*„î*„ïT±uïT±
î4‹ïT±rïT±
î5´î8gî8gïT±sïT±î@ÍîG…ïT±rïT±�îH4îHŒîHŒïT±î¢ïS%îKîKïS%uïS%
î#RïS%rïS%î#ªî&
î'Ê�î(Ç	î/…î2fî5î7æî="îAüîDÝîI¬îI¬ïS%î¢ïQ¢
î"î”î”ïQ¢sïQ¢îÇïQ¢rïQ¢îî#â
î%x�î&uî,î2"î5²î8êî=ÄîB¨îHîHïQ¢î¢ïPîüî`î†î$
î%‰�î&†î*¥î-N�î-ÇïPuïP
î7ïPrïPî7c�î8î8ïPuïPî>†ïPrïP
î?\ïPî¢ïM2îKîKïM2sïM2	î!±ïM2rïM2î"	î&tî)î+7î/®	î6‚î;Q
î=î?‘îDuîJ*îJ‚îJ‚ïM2î¢ïK¦�î
îQ	î$g
î%¥�î&¢î+dî1[
î2æî5î9û	î@îD&îHõ
îJuîJuïK¦î¢ïJ#îÓî·î"ü
î*ÊïJ#sïJ#î*ÐïJ#î¢ïGj�îyïGjuïGjî"ïGjsïGjî"öî"öïGjuïGjî(ïGjsïGjî(ãî(ãïGjuïGjî03ïGjsïGjî09ïGjî¢ïFîyîPî'îþîÕî¬îƒîZî1îîßî&—î&—ïFuïF
î.ÕïFsïFî/¬î6dî6dïFuïF	î>ˆïFsïF�î?_ïFuïFî?eïFî¢ïC%îòïC%rïC%îJ
îˆ�î …î"“
î$î&ÿî+lî-éî00î6)
î7©î9Úî>Q	îDù
îFîFïC%sïC%îIïC%rïC%îIl
îJŸîJŸïC%î¢ïA™îÓî#î"q
î$I	î+î+uî+uïA™uïA™
î3³ïA™rïA™î4
î5I�î6Fî8T
î9ßî<ÀîA-îCªîE¹îH»îH»ïA™î¢ï@î
îœ
î_î# î#xî#xï@uï@	î+œï@rï@î+ô
î-2�î./î0=
î1Èî5Ý
î7hî;/î=Îî@+
îAîîEÀ
îGŽîJ�îJ�ï@î¢ï>“	îkî mî#oî&²î)ë
î+®î/'
î0§î2Øî9î9ï>“sï>“î>ï>“rï>“î>tîC6îCŽîF7îJ	îJ	ï>“î¢ï=sîƒï=rï=îÛîdîdï=sï=î%Eï=rï=î%î'Ãî+&î/
î0ƒî2¨î9Hï=î¢ï:îKîKï:sï:îUï:rï:î­î#î%ªî'Ûî+¢î.Aî0ž
î2aî63
î8
	î>Õ
î@UîBÇîH|îHÔîHÔï:î¢ï8Ž
îÇî
	î" 
î#^
î$éî'î)úï8Žsï8Žî*�ï8Žî¢ï5¡�îyï5¡uï5¡îíï5¡sï5¡îÄîÄï5¡uï5¡î$Úï5¡sï5¡î%±î%±ï5¡uï5¡î-
ï5¡sï5¡�î-Øï5¡rï5¡�î.6ï5¡î¢ï2´î‹î‹ï2´uï2´î!Ûï2´rï2´î"3
î#q�î$nî&|
î(î*èî/Uî1Òî3áî6ãî=4
î>gîA2îF
îH^îJîJï2´î¢ï11îêï11î¢ï.MîKîKï.Msï.Mî ï.Mrï.Mî [î$Æ
î&
î'Çî,öî/
î0î3þî8âî?îB€
îDîH	îH	ï.Mî¢ï,Á
î<îb
î&l
î(:î*¬î0aî0¹î4Iî;r
î<¥�î=¢î@ÛîG+
îHÁîHÁï,Áî¢ï+>îå	î x
î!øî$)î(Âî. 	î46
î5tî7ºî<‰
î>	î@{îF1îHbîHbï+>î¢ï)»îîî !î"0�î#-	î)C
î*Î
î+ö
î-vî0x
î2î44î9Þî?À
îA@îDnîF÷îIÂîIÂï)»î¢ï(8îÓî|î~	î$”î(vï(8î¢ï%TîKîKï%Tsï%Tî ï%Trï%Tî [î$Æ
î&î)ìî-rî2®î7ž
î9)�î:&î=«îBîHDîHœîHœï%Tî¢ï#Èîî¾
îñî"nî'
î(‡î*î,Çî1^�î2f
î3ñî8Õî>3î>3ï#Èsï#Èî@¸ï#Èrï#È�îAhîCñîHˆ�îIîIï#Èî¢ï"<î¨îàî#w�î$
î&
î+hî+hï"<sï"<î-íï"<rï"<î.Eî1/
î2¯�î3¬î7î<
î=¡îCñ
îE‡îHhîHhï"<î¢ï °î”î î#«î'´�î(±î.î.ï °sï °î3ï °rï °î3qî6\
î8î8ï °sï °î>×ï °rï °î?/îCš
îE%îE%ï °sï °îIXï °rï °îI°îI°ï °î¢ï$î+îîC
î Ãî"Ñî%î'uî,³
î3Mî7î7ï$sï$î<(ï$rï$�î<ï$qï$î<…ï$î	ôï^î
î
dîwîDî‰
îï^rï^îï^î	ôïYîÞîIîÿîÔîî éî$Nî*F
î+Æî-÷î2Ûî8 î>Zî@€îF
îH�îIîIïYî	ôïÖîÞîÂî 
îŽî î"ìî&ê
î(uî+wî.Xî0~î8
î8eî;¨î>‰
î@	�îAîEêîEêïÖî	ôïSî.î.ïSsïSîaïSrïSî¹î$î]	î" 
î$cî)2
î*²î.N
î/Ùî2V
î3áî6î;ðî@<îCùîI‚îI‚ïSî	ôïÇî%	î;î˜
î[î4î :
î&rî*î-ÿî.Wî1nî3�î4
î6âî9?
î;î?Ñ
îAQîDí
îFxîHëîHëïÇî	ôïDî
cîDî™
îg
î*îî!
î'oî'Çî*pî.…
î0î2Aî5-î8’î:¸î@‚îCcîF‘
îHiîHiïDî	ôïÁ
îî_
î7îî-î#Ô
î%Tî'…î*Ôî/¸î5mî5Å
î7½î:à
î<`�î=]î@>îB„îGS
îHÓîHÓïÁî	ôï
>î%îtîXî¶îÅ
îEî¸î%cî(Dî+Êî/$
î0b
î2:î7˜î=î?‰îC[�îDXîDXï
>tï
>îJîJï
>�������
¨����
êq?€`½W������������������������������������������������������������������������������������������������������������������������������������������������������������������������8name,intheform(PROGRAM.TYPE).Ingeneral,aQualifiednameislegalinanyplacethatcallsforaCouriertype.1.6.2.1Pre-definedTypesPre-defined(atomic)typesareexpressedasuppercaselitatomsfromthefollowingset:BOOLEANValuesarerepresentedbyTandNIL.INTEGERValuesarerepresentedassmallintegersintherange[-32768..32767].CARDINALValuesarerepresentedassmallintegersintherange[0..65535].UNSPECIFIEDSameasCARDINAL.LONGINTEGERValuesarerepresentedasFIXP's.LONGCARDINALSameasLONGINTEGER.NotethatInterlisp-Ddoesnot(currently)haveadatatypethattrulyrepresentsa32-bitunsignedinteger.STRINGValuesarerepresentedasLispstrings.Inaddition,thefollowingtypesnotinthedocumenthavebeenaddedforconvenience:TIMERepresentsadateandtimeinaccordancewiththeNetworkTimeStandard.ThevalueisaFIXPsuchasreturnedbythefunctionIDATE,andisencodedasaLONGCARDINAL.NSADDRESSRepresentsanetworkaddress.ThevalueisanobjectoftypeNSADDRESS(sectionX.XX),andisencodedassixitemsoftypeUNSPECIFIED.NSNAMERepresentsathree-partClearinghousename.ThevalueisanobjectoftypeNSNAME(sectionX.XX),andisencodedasthreeitemsoftypeSTRING.NSNAME2Representsatwo-partClearinghousename,i.e.,adomain.ThevalueisanobjectoftypeNSNAME(sectionX.XX),andisencodedastwoitemsoftypeSTRING.1.6.2.2ConstructedTypesConstructedTypesarecompositeobjectsmadeupofelementsofothertypes.TheyareallexpressedasalistwhoseCARnamesthetypeandwhoseremainingelementsgivedetails.Thefollowingareavailable:(ENUMERATION(NAMEINDEX)...(NAMEINDEX))EachNAMEisanarbitrarylitatomorstring;thecorrespondingINDEXisitsCourierencoding(aCARDINAL).ValuesoftypeENUMERATIONarerepresentedasaNAMEfromthelistofchoices.Forexample,avalueoftype(ENUMERATION(UNKNOWN0)(RED1)(BLUE2))mightbethelitatomRED.(SEQUENCETYPE)ASEQUENCEvalueisrepresentedasalist,eachelementbeingoftypeTYPE.ASEQUENCEoflengthzeroisrepresentedasNIL.NotethatthereisnomaximumlengthforaSEQUENCEintheLispimplementationofCourier.(ARRAYLENGTHTYPE)AnARRAYvalueisrepresentedasalistofLENGTHelements,eachoftypeTYPE.(CHOICE(NAMEINDEXTYPE)...(NAMEINDEXTYPE))TheCHOICEtypeallowsonetoselectamongseveraldifferenttypesatruntime;theINDEXisusedintheencodingto��îJï
>î
êïgtî	ôïh„s�î
Ëïh„î	ôïb
tî
ïb
rïb
�î
Á
îAîrîª�î#ïb
uïb
î5�îÁî½ïb
rïb

îåî =
î!ßî&Ú�î'×î-¶î1G
î2…î5›
î7î9Žî<òî?‘îBpîD�îE|îJ`îJ`ïb
î	ôï`kîÔï`kqï`kîÚï`kî	ôïZ¥îîlîw
îîúïZ¥rïZ¥î�ïZ¥î	ôïW 
î6îrî×îýî"
î#î)Èî.Ìî2î45î:î<#ïW sïW î<)ïW î	ôïT³îÕïT³rïT³î-î…îÝî¢îíî
î$K
î&î&ïT³sïT³�î&ðïT³rïT³î'Hî)Ñî)ÑïT³sïT³î,VïT³rïT³�î,­ïT³sïT³î,³ïT³î	ôïQÆîÕïQÆrïQÆî-î…îÝî¢îíî
î$K
î%Ìî):î.*
î/ªî1Ûî5wî>™ïQÆsïQÆî>ŸïQÆî	ôïNÙî¬ïNÙrïNÙîî\î´î¢îíî
î$K
î%Ìî):î.*
î/ªî1Ûî5w
î;`ïNÙsïNÙî;fïNÙî	ôïKì
î1ïKìrïKìî‰îáî9î¢î3
î´î´ïKìsïKìî"lïKìrïKì�î"ÃïKìsïKìî"ÉïKìî	ôïHÿ
î1ïHÿrïHÿî‰îáî9î¢îíî
î$K
î%Ìî%ÌïHÿsïHÿî)(ïHÿrïHÿî*[ïHÿsïHÿî*aïHÿî	ôïFîïFrïFî`î¸îî¢î3
î´î´ïFsïF
î$ñïFrïF�î% î%øî)?î+Þ
î2¼î5½î8
î> îA¸�îBµîHîJ³îJ³ïFî¢ïD†îÄ	î �î!î$Ùî$ÙïD†tïD†î)ñïD†rïD†î*Iî.´ïD†sïD†î.ºïD†î	ôïAîþïArïAîVî®îî¢îíî
î$K
î%Ìî(¶î,åïAî	ôï>¢
î–î)îZî8îîã
î cî"”î(Îî+æî/î3î5î<Ñï>¢sï>¢î<×ï>¢î	ôï;µî
Pï;µrï;µî
¨î�îXî¢	îw�îtî!Jî#Óî&É
î(I	î/(î2î4Dî9Æî=4îC7îCîF8îI²îI²ï;µî¢ï:)
îà�îÝîÝï:)sï:)î9ï:)rï:)î‘î“
î!î&~
î(Lî*}î/Äî/Äï:)sï:)î3÷ï:)rï:)�î4§î70
î8nî=¶
î?7�î@4î@4ï:)î¢ï8sî ¶ï8rï8�î!
ï8sï8î!ï8î	ôï5°îƒï5°rï5°îÛî3î‹î¢	îw�îtî#šî(«î)î+¬î/&
î0d
î2'î6
î7™î:zî:zï5°sï5°îB	ï5°rï5°îBaîGEîGEï5°î¢ï4$î:îÃ
î
î$I
î%Êî'¸î+2
î,½î/žî/žï4$sï4$
î8Ûï4$rï4$�î92ï4$sï4$î98ï4$î	ôï17îþï17rï17îVî®îî¢	îw�ît	î$¤î-pî1Xî1°î4Yî7Ó
î9
î:Ôî>»
î@FîC'îC'ï17sï17îH1ï17rï17îH‰îH‰ï17î¢ï/«î†î î"§
î#åî)-
î*®î.î1‚
î3
î5îî5îï/«sï/«î:øï/«rï/«�î;Oï/«sï/«î;Uï/«î	ôï,¾îÕï,¾rï,¾î-î…îÝî¢	îw�îtî#Çî,“î0|î2á�î3Þî9î9[î<î?~
î@¼
îBîFf
îGñîGñï,¾î¢ï+2îƒîƒï+2sï+2îï+2rï+2îåî#Éî(aî*ê
î,(î1p
î2ñî5nî8è
î:sî=Tî=Tï+2sï+2îB^ï+2rï+2�îBµï+2qï+2îB»ï+2î	ôï%lîîlîw
îíîhï%lrï%lînï%lî	ôï"g
îxîUî{îÉî"4î%Å
î'©
î)4î.¾
î0Iî3¸î7tî7Ìî;%î=Kî?îE
îFœ�îG™îI§îI§ï"gî	ôï äî
òî
òï äsï äîwï ärï äîÏîäîîöîî }î&Ìî,Vî/î3Šî3âî6‹î<iî>	îD8ï äsï äîD>ï äî	ôï÷îß�î¶ï÷uï÷îtî3ï÷sï÷�îáî"=�î#ï÷uï÷î&Òî*‘ï÷sï÷
î,?ï÷rï÷î,—î,ïî-Gî/)î2lî2lï÷uï÷î5äï÷rï÷î6<
î7z
î9=î>±îC1
îDÇîHæîHæï÷î¢ïkîÓî!”î!”ïkuïkî%Sïkrïkî%«
î&éî(•î-yî3.
î4¤î4¤ïksïkî;\ïkrïk
î<„î<ÜîA'
îB²îE“îE“ïkî¢ïßs
îßïßrïßî 7î"]
î)•
î+�î,î,ïßuïßî/‹ïßrïßî/ãî3î5Lî7Z
î8åî=Óî>+î@§îFG�îGDîJ¾îJ¾ïßî¢ïS
î-îîïSsïSî%ùî-ˆ
î0
î4@
î6Åî;Ïî>TïSrïSî>¬îBs
îD6îFgîFgïSî¢ïÇî"î"ïÇsïÇî§ïÇrïÇ�îþïÇsïÇîïÇî	ôïÚîZîZïÚuïÚîVïÚsïÚ�î-ïÚrïÚî…îÝî5îÖ�î5î5ïÚsïÚî íïÚrïÚî!Eî$¿
î%ý
î-5
î.¶�î/³î2î5î:!î=¼
î?GîB(îB(ïÚuïÚîE$ïÚrïÚ�îEÓîF+�îGŠîGŠïÚî¢ïNsîZïNrïNî²
î=î#Fî&
î'X
î.
î0î0ïNsïNî2–ïNrïN�î3Eî3î6äî9ƒî<Ý
î>
î?óîFCîJLîJLïNî¢ïÂî±�î®î®ïÂsïÂî fïÂrïÂî ¾
î">î$oî'Y
î1�
î2‹î7nïÂsïÂî7tïÂî	ôïÕîÕîÕïÕuïÕîëîçïÕsïÕ�î¾ïÕrïÕîînîÆîQ
îvîvïÕsïÕî!©ïÕrïÕî"
î%{
î&¹
î-ñ
î/r�î0oî2}
î4î4ïÕuïÕî8ØïÕrïÕî90î?îB
îCŸîF€îF€ïÕuïÕîI|ïÕrïÕ�îIÓïÕsïÕîIÙïÕî	ôïèî¬�îƒïèuïèîAîFîBïèsïè�îðî!L�î"#ïèuïèî%áî)æî,âïèsïè
î.ïèrïèî.èî/@î/˜î1¤î4Mî4Mïèsïèî9Wïèrïèî9¯î<î@ŒîC	
îD‰îHîHïèî¢ï
\îøîYî$Íî(2
î)î/î1Mî1Mï
\uï
\î5ï
\rï
\î5d
î6¢î9¯
î;/î=`îC
îD•îD•ï
\ÿ�����������
êq?€`½������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������9distinguishthevaluetypes.AvalueoftypeCHOICEisrepresentedinLispasalistoftwoelements,(NAMEVALUE).Forexample,avalueoftype(CHOICE(STATUS0(ENUMERATION(BUSY0)(COMPLETE1)))(MESSAGE1STRING))couldbe(STATUSCOMPLETE)or(MESSAGE"Outofpaper.").(RECORD(FIELDNAMETYPE)...(FIELDNAMETYPE))ValuesoftypeRECORDarerepresentedaslists,withoneelementforeachfieldoftherecord.Thefieldnamesarenotpartofthevalue,butareincludedfordocumentationpurposes.Forprogrammerconvenience,therearetwomacrosthatallowCourierrecordstobeconstructedanddissectedinamannersimilartoLisprecords.ThesecompileintotheappropriatecompositesofCONS,CARandCDR.(COURIER.CREATETYPEFIELDNAME_VALUE...FIELDNAME_VALUE)[Macro]CreatesavalueoftypeTYPE,whichshouldbeafully-qualifiedtypenamethatdesignatesaRECORDtype,e.g.,(MAILTRANSPORT.POSTMARK).EachFIELDNAMEshouldcorrespondtoafieldoftherecord,andallfieldsmustbeincluded.EachVALUEisevaluated;allotherargumentsarenot.Theassignmentarrowsareforreadability,andareoptional.(COURIER.FETCHTYPEFIELDOBJECT)[Macro]AnalogoustotheRecordPackageoperatorfetch.ArgumentTYPEisaswithCOURIER.CREATE;FIELDisthenameofoneofitsfields.COURIER.FETCHextractstheindicatedfieldfromOBJECT.Forreadability,thenoiseword"of"maybeinsertedbetweenFIELDandOBJECT.OnlytheargumentOBJECTisevaluated.Forexample,iftheprogramCLEARINGHOUSEhasatypedeclaration(USERDATA.VALUE(RECORD(LAST.NAME.INDEXCARDINAL)(FILE.SERVICESTRING))),thentheexpression(SETQINFO(COURIER.CREATE(CLEARINGHOUSE.USERDATA.VALUE)LAST.NAME.INDEX_12FILE.SERVICE_"Phylex:PARC:Xerox")wouldsetthevariableINFOtothelist(12"Phylex:PARC:Xerox").Theexpression(COURIER.FETCH(CLEARINGHOUSE.USERDATA.VALUE)FILE.SERVICEofINFO)wouldproduce"Phylex:PARC:Xerox".1.6.2.3UserExtensionstotheTypeLanguageTheprogrammercanaddnewbasetypestotheCourierlanguagebytellingthesystemhowtoreadandwritevaluesofthattype.Theprogrammerchoosesanameforthetype,andgivesthenameaCOURIERDEFproperty.Thenewnamecanthenbeusedanywherethatthetypenameslistedintheprevioussections,suchasCARDINAL,canbeused.Suchextensionsareusefulforuser-definedobjects,suchasdatatypes,thatarenotnaturallyrepresentedbyanypredefinedorconstructedtype.TheNSADDRESSandNSNAMECouriertypesaredefinedbythismechanism.COURIERDEF[PropertyName]TheformatoftheCOURIERDEFpropertyisalistofuptofourelements,(READFNWRITEFNLENGTHFNWRITEREPFN).Thefirsttwoelementsarerequired;ifthelattertwoareomitted,thesystemwillsimulatethemasneeded.Theelementsareasfollows:���îD•ï
\î
êïførîI“ïh„s�îJjïh„î¢ïb
r
î^îî#	î&Åî'�î(|î+ö
î-î0bî0bïb
sïb
î5lïb
rïb
î5Ä
î7
î>:
î?ºîB¤
îD%�îE"îG0
îH»îH»ïb
î¢ï`uîî
�îzï`uuï`uî"òï`urï`uî#Jî#Jï`uuï`uî'>ï`urï`u
î(fî(¾î+:î0Ú�î1×î5Q
î6Üî9½î9½ï`usï`uî9Ãï`uî¢ï]¼îZî$�î%Àî0«î5µ
î8:î@ îDÓîDÙï]¼î¢ï\0îyîPî'îþîÕî¬îƒîZî$é�î&—î-Oï\0rï\0î-Uï\0î¢ïYCî<
îÿîÿïYCsïYCî"·î*FïYCrïYCî*ž
î,4î,4ïYCsïYCî3Ãî7ö
î:{îA3ïYCrïYC�îAŠïYCsïYCîAïYCî	ôïVVî¬�îƒïVVuïVVîÌîÈïVVsïVV�îvî Ò�î!©ïVVuïVVî(òî+îïVVsïVV
î-œïVVrïVVî-ôî.Lî.¤î/)î3t
î4ÿî7àî7àïVVsïVVî<êïVVrïVVî=Bî?h
îF 
îH!îH!ïVVî¢ïTÊîŒîwîôî#úî&	î)î,
î-–î/Çî4=î4•î7>î:>î>Sî@yîB¿îEt
îFÿîI0îI0ïTÊî¢ïSGîtîÆîìî$_î&nî/î57ïSGî	ôïPcîp	î îîkî!‘î$î(î+/î.§î3‹î8.
î9®
î;q
îB’îEîJ»îJ»ïPcî	ôïNà
ît�îqîLî 
î î
îî\î#.î(2î*Úî-
î46	î;
î<“î<“ïNàsïNàî?ïïNàrïNà�î@Ÿî@ŸïNàsïNàîC$ïNàrïNàîC|îFîFïNàsïNàîHŠïNàrïNà�îHáïNàsïNàîHçïNàî	ôïKóîdîdïKóuïKóî¦î!ï�î"ïî')î(Aî/Š�î0Šî4~ïKósïKó�î5UïKórïKóî5­î6î6šî;6ïKóî¢ïJgî\�îYîÓ
î!^î$?î$?ïJguïJgî';ïJgrïJg�î'ëî+Èî0
î1Õ�î2Òî;‘î>rîBîD¢îD¢ïJgî¢ïHä	îý�îúîúïHäsïHäî#ïHärïHäî#\î&•î)Hî)HïHäsïHä
î5á�î7î?ïHärïHä�î?Íî@%îChîChïHäî¢ïGXuî¥ïGXrïGXîýî"G	î)0
î*°�î+­î.­
î08î2iî6àî9iî;*î>®îAç
îCªîItîIÌîIÌïGXî¢ïEÕîåîåïEÕuïEÕîÙïEÕrïEÕî1
îo	î%àî'¡î+î1î3³î6Pî6¨î9Q	î@0îDpîF–îH¥îH¥ïEÕî¢ïDRî•î î"Dî'rïDRsïDRî'xïDRî	ôïAe
îîïAeuïAeîÏî î!ýïAesïAe�î"ÔïAerïAeî#,î#„î0 î4¼ïAeî¢ï?Ùî<
î¼î íî%î*¬î/þî/þï?Ùsï?Ùî41ï?Ùrï?Ù�î4àî58î;“î;“ï?Ùuï?Ùî>ï?Ùrï?Ùî>ç
î@%
îA¦îD‘îD‘ï?Ùî¢ï>Ms
î"dï>Mrï>M�î#5î#5ï>Muï>Mî&Àï>Mrï>Mî'
î(Vî*‡î.
î/£î2 
î3«î5Wî92î9Šî9Šï>Msï>MîDuï>Mrï>MîDÍîIîIï>Mî¢ï<ÁîÓî“î!“î$Ëî$Ëï<Áuï<Áî)(ï<Árï<Á�î)×î*/î,«î3žî5Ïî<3�î<ãï<Ásï<Á
î>‘ï<Árï<Á�î?™îBo
îD2îI8îI8ï<Áî¢ï;5îàîàï;5uï;5îkï;5rï;5îÃî"Lî"Lï;5uï;5î&©ï;5rï;5�î'Xî'°î*òî-#î3î3ï;5uï;5î7yï;5rï;5î7Ñ
î9	î?ï;5î	ôï8Qîpî
îCîtîÒîÒï8Qsï8Qî%½ï8Qrï8Qî&î(\�î)Yî,:
î2¿ï8Qsï8Qî2Åï8Qî	ôï5˜îdîî,cî3øï5˜î	ôï4î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înîEîî)Þ	î2Dï4rï4î2Jï4î	ôï1îëî	îJï1sï1îPï1î	ôï.fîþî1î ¡
î-:�î.èî;‡ï.fî	ôï-î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îî&‚�î(0
î)äï-î	ôï+‚î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îî#ý�î%«î6wï+‚rï+‚î6}ï+‚î	ôï(•î
ñîàîîîï(•sï(•îrï(•rï(•îÊ
îJî{î ‰î ‰ï(•sï(•î#åî4±ï(•rï(•�î5`î5¸î8a	î>ï(•sï(•î>•ï(•î	ôï%¨
î
î#&�î$Ôî2Dî=/
î?´îCçï%¨rï%¨îCíï%¨î	ôï"»î
ñîîï"»sï"»î#
ï"»rï"»�î#dï"»qï"»î#jï"»î	ôïõîîlîwî˜	îZ
îåîî Zî&ïõrïõî&ïõî	ôïðî	îMîªî3îóîßî"D
î#Äî%õî*Ùî0n
î2<î6Cî8tî<Àî?•
îAîD
îFŠîIØîIØïðî	ôïmî
ò
î}îîTî¬îU	î î$Þ�î%Ûî)lî+{î-¬î0åî3nî6±î8âî<s�î=pî=pïmsïm	îEÖïmrïmîF.îF.ïmî	ôïáî´îîµîuîîcîZ
î î#*î).î+Íî-þî0ßî4ôî8m
î9íî<îA{îFÂîIÄîIÄïáî	ôï^
îuîuï^sï^î-ï^rï^�îÝî:
îýîaî¹îý	î$mî&“î*{î,Šî4Eî9î<

î=‹	îCÆîFeîH‹îH‹ï^î	ôïÒî:îÎ
î
îÔîG	î$
î%›
î,¼î/ôî0Lî2õî2õïÒsïÒî:„ïÒrïÒî:Üî=eî=eïÒsïÒîBoïÒrïÒîBÇîG«îG«ïÒî	ôïFî
YîîN
îîŽ	îïFsïFî“ïFî	ôïY	îZïYrïYî²î
î0 î5öî9óïYî¢ï
ÍîKî–
î!î!Rî!Rï
Ísï
Í	î)¸ï
Írï
Íî*î/y
î0·�î1´î3Â
î5M
î71
î8±î;†îAh�îAáï
Íuï
ÍîFåîFåï
Íî¢ïAîMî"ï	î*˜ïArïA
î+Àî,î.Áî1jî3çî9qî;—îAn
îB¡îDÒîH6îJ³îJ³ïAî¢ï
¾îÈîî 5î$î&üî,Cî/
î1î6î6fî9î>™î@¿
îB@îFëï
¾uï
¾îFñï
¾ÿ�������	M����
êq?€`½Í��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������10READFNThisisafunctionofthreearguments,(STREAMPROGRAMTYPE).ThefunctioniscalledbyCourierwhenitneedstoreadavalueofthistypefromSTREAMaspartofaCouriertransaction.ThefunctionreadsandreturnsthevaluefromSTREAM,possiblyusingsomeofthefunctionsdescribedinsectionX.XX.PROGRAMandTYPEarethenameoftheCourierprogramandthetype.Inthecaseofatomictypes,TYPEisalitatom,andisprovidedfortypediscriminationincasetheprogrammerhassuppliedasinglereadingfunctionforseveraldifferenttypes.Inthecaseofconstructedtypes,TYPEisalist,CARofwhichisthetypename.WRITEFNThisisafunctionoffourarguments,(STREAMVALUEPROGRAMTYPE).ThefunctioniscalledbyCourierwhenitneedstowriteVALUEtoSTREAM.PROGRAMandTYPEareaswiththereadingfunction.ThefunctionshouldwriteVALUEonSTREAM.Theresultreturnedfromthisfunctionisignored.LENGTHFNThisfunctioniscalledwhenCourierwantstowriteavalueofthistypeintheform(SEQUENCEUNSPECIFIED),andthenonlyiftheWRITEREPFNisomitted.Thefunctionisofthreearguments,(VALUEPROGRAMTYPE).Itshouldreturn,asaninteger,thenumberof16-bitwordsthattheWRITEFNwouldrequiretowriteoutthisvalue.Ifvaluesofthistypeareallthesamelength,theLENGTHFNcanbeasimpleintegerinsteadofafunction.SeediscussionofCOURIER.WRITE.SEQUENCE.UNSPECIFIED(sectionX.XX.WRITEREPFNThisfunctioniscalledwhenCourierwantstowriteavalueofthistypeintheform(SEQUENCEUNSPECIFIED).ThefunctiontakesthesameargumentsastheWRITEFN,butmustwritethevaluetothestreamprecededbyitslength.Ifthisfunctionisomitted,CourierinvokestheLENGTHFNtofindouthowlongthevalueis,andtheninvokestheWRITEFN.IftheLENGTHFNisomitted,CourierinvokestheWRITEFNonascratchstreamtofindouthowlongthevalueis.1.6.3PerformingCourierTransactionsThenormaluseofCourieristoopenaconnectionwitharemotesystemelementusingCOURIER.OPEN,performoneormoreremoteprocedurecallsusingCOURIER.CALL,thenclosetheconnectionwithCLOSEF.(COURIER.OPENHOSTNAMESERVERTYPENOERRORFLGNAMEWHENCLOSEDFN)[Function]OpensaCourierconnectiontotheCouriersocketonHOST,andreturnsanSPPstreamthatcanbepassedtoCOURIER.CALL.HOSTcanbeanNSaddress,orasymbolicClearinghousenameintheformofastring,litatomorNSNAME.Inthecaseofasymbolicname,SERVERTYPEspecifiestheClearinghousepropertyunderwhichtheserver'saddressmaybefound;normally,thisisNIL,inwhichcasetheADDRESS.LISTpropertyisused.IfNOERRORFLGistrue,NILisreturnedifaconnectioncannotbemade,ortheserversupportsthewrongversionofCourier.TheCourierconnectionprocessisnamedNAME,ifspecified.WHENCLOSEDFNisafunctionofoneargument,theCourierstream,thatwillbecalledwhentheconnectionisclosed,eitherbyuserorserver.(COURIER.CALLSTREAMPROGRAMPROCEDUREARG1...ARGNNOERRORFLG)[NoSpreadFunction]ThisfunctioncallstheremoteprocedurePROCEDUREoftheCourierprogramPROGRAM.STREAMisthestreamreturnedbyCOURIER.OPEN.TheargumentsshouldbeLispvaluesappropriatefortheCouriertypesofthecorrespondingformalparametersoftheprocedure.Theremustbethesamenumberofactualandformalarguments.Ifthe��îFñï
¾î
êïgDuî	ôïh„s
î¢ïh„î¢ïb
uî`ïb
rïb
î¸îîhî Ôî#¾
î$ü�î%ùî+@
î,Ëî0%	î6ú�î7sïb
uïb
î<‡îB™îE•ïb
rïb

îF½îGîI¾îI¾ïb
î Ôï`~î&
î'Yî+
î,íî1Ñî5W
î6î:1
î;±î>�î?šîC
îDŸîGîIòîIòï`~î Ôï^ûî$î$ï^ûuï^ûî(Úï^ûrï^ûî)2
î*³î-h
î.ó�î/ðî4Ôî;óî<Kî>ôîD;îG«îJ4îJ4ï^ûî Ôï]xî%Wî'ˆî+î.:î.:ï]xuï]xî3ï]xrï]x�î3¸î8Òî<Lî?°
îA;îClîI7îI7ï]xî Ôï[õî&Ì
î(Lî,·î0Õî1-î1-ï[õuï[õî6ùï[õrï[õî7Qî9Úî9Úï[õuï[õî<Öï[õrï[õî=.î?TîA…îE
îF¡îHÒîHÒï[õî ÔïZrî%¸î+î-Ÿî/Ðî3î3`
î5î73î9ó
î;~î?ÈîC…îC…ïZruïZrîFïZrrïZrîFÙ
îH�îIîIïZrî ÔïXïî%¬î(5
î)sî/î1!î4
î<Ì
î>LîAîC=îC=ïXïî ÔïWl	î(„î*Ëî0(�î1%î4àî9¤î>ëî@úîE[îE[ïWlî ÔïUéî&Hî*î*\
î+þî./î0ï
î2z
î9›î=Xî=XïUéuïUéî@TïUérïUéî@¬
îAê�îBçîEMîEMïUésïUéîGÒïUérïUéîH*
îIµîIµïUéî ÔïT]î$±
î%ïî( î+
î.‘ïT]uïT]î.—ïT]î¢ïQyîïQyrïQyî_î·îî Ôî#¾
î$ü�î%ùî+@
î,Ëî/ 	î6u�î6îïQyuïQyî<î@<îFNîIJïQyrïQy
îJrîJÊîJÊïQyî ÔïOöî#}î(Ä
î*î-È
î/–î4zî8�
î9(î<Ú
î>ZîA¨îA¨ïOöuïOöîEœïOörïOöîEô
îGtîGtïOöî ÔïNsuî%¢ïNsrïNs�î&Qî&QïNsuïNsî,ïNsrïNsî,uî.þî.þïNsuïNsî1úïNsrïNsî2Rî4x
î5ùî8äî;î?ÙîEwîEÏîHxîHxïNsî ÔïLðî&î*eî-³î-³ïLðuïLðî1§ïLðrïLðî1ÿ
î3×î3×ïLðuïLðî8¥ïLðrïLð�î9Tî9¬î<Uî?ðîEZîH’îH’ïLðî ÔïKmî#Fî(
î)Ëî.£ïKmuïKmî.©ïKmî¢ïH‰îþïH‰rïH‰îVî®îî Ôî#¾î)
î*Cî.	î1î6sî:%
î;¥î>ó�î?ðîCj
îDõîGgîJHîJHïH‰î ÔïG
î"Tî$…î'½î'½ïGsïGî0#î:7ïGrïG�î:çî=pî@gîCQ
îD„îFµîFµïGî ÔïEzu	î(}ïEzrïEzî(Õ
î*î/Nî/¦î2Oî7–
î8Ô
î:_î=¹	îDŽ�îEïEzuïEzîIAîIAïEzî ÔïC÷î&æî)âïC÷rïC÷
î+
î+b
î,¬î0öî5M
î6Î
î8‘î=Uî?†îD‚
îF
îIÔîIÔïC÷î ÔïBtî$±î'Pî)î)ïBtuïBtî.æïBtrïBtî/>î3;î7Ó
î9Sî<¡î>çîAYîE*îE‚
îF×îF×ïBtî Ôï@ñî$Ò
î&]î(Ïî+°î-Öî/—î1Èî5î9xî;©î;©ï@ñuï@ñîBï@ñrï@ñîB]îDº
îF}�îGzîGzï@ñî Ôï?nî%î)tî-ö
î/�î0~î6î6tî8Ü	î?*
î@µî@µï?nî Ôï=ësð"î=bï=ërï=ëî=ºîBžîFdï=ëuï=ëîFjï=ëî¢ï:þ	îKï:þrï:þî£îûîSî Ôî#¾î)
î*Cî.	î1î6sî:%
î;¥î>ó�î?ðîCj
îDõîGgîJHîJHï:þî Ôï9{
î"Tî$…î'½î'½ï9{sï9{î0#î:7ï9{rï9{�î:æî;>î=çîC.îF|îH­îH­ï9{î Ôï7ïî$#î* 
î,!î.Rî.Rï7ïuï7ïî3·ï7ïrï7ï�î4gî6¹î9òî=@î?qîBë
îDkîFœîFœï7ïî Ôï6lî%î*Ì
î,šî.Fî2¦î2þ
î4Sî6Åî<
î=JîB†îGjîGjï6lî Ôï4éî%¡î'Òî'Òï4éuï4éî..ï4érï4éî.†
î0î2Åî5î7àî:Êî<ûî@uîBîD”îG‹îG‹ï4éî Ôï3fî%¡î'Òî'Òï3fuï3fî-7ï3frï3f�î-æî.>
î/“î1Äî1Äï3fuï3fî8 ï3frï3fî8x
î9¶î>òîCÖîH£îH£ï3fî Ôï1ãî#î#ï1ãuï1ãî(jï1ãrï1ãî(Â
î*š�î+—î0î4E
î5Åî8„î:Êî=Ÿî@‰îBºîF4îGqï1ãqï1ãîGwï1ãî	ôï,î
î
dîw	îgî4î"Õï,rï,î"Ûï,î	ôï)îî)îp
îûîß
î
îîà�î Ý	î'¤î*�î+Œî0î4Oî9Uî<Ïî<Ïï)sï)îFãï)rï)�îG“îG“ï)î	ôï'Œîî˜
î.î’î	î!Yî$8î'²î'²ï'Œsï'Œî1Æï'Œrï'Œ�î2vî5mî8¤î:Õ	îAœîD‡îD‡ï'Œsï'ŒîI‘ï'Œrï'Œ�îIèï'Œsï'ŒîIîï'Œî	ôï$Ÿî¶î¶ï$Ÿuï$Ÿî¦	î$z	î,°î0nî:Vï$Ÿsï$Ÿ�î;-ï$Ÿrï$Ÿî;…î;Ýî@†	îF¬ï$Ÿî¢ï#îÁ�î¾î ¢	î'i
î(éî+î/þî3û
î5Óî5Óï#uï#î9ï#rï#�î9µî<>î@Á
îB„îEDîI…îI…ï#î¢ï!îAîž
îaî!—
î#î#ï!sï!î-+ï!rï!�î-Úî.2î.2ï!uï!î1dï!rï!î1¼î4
î5Ü
î7Ÿ
î9ßî>ñ
î@‡�îA„îGîGï!î¢ï înî"ÿ
î$î&°î)è
î+s�î,pî0nî4î
î6„î6„ï sï î;Žï rï �î<=î<•
î>7î@hîC(
îD³�îE°îE°ï î¢ïxî5î î ïxuïx	î'¬ïxrïxî(î-Kî/|î8Hî=±îA„îEaîG’îG’ïxî¢ïõî\î î"ì
î$¯î)î.ûî1m
î2«î2«ïõsïõî50ïõrïõ�î5à
î7`î;=î=ýî@.î@.ïõsïõîJBïõrïõîJšîJšïõî¢ïiî
îIî ­î!
î"Zî"Zïiuïi	î*Jïirïiî*¢
î+àî.íî.íïisïiî1rïirïiî1Ê
î3î8r
î9¥�î:¢	îAiîE´
îGwîGwïiî¢ïÝî‹
î!îRî"0î'Žî)¿î-Èî2_
î3êî9%î9}î<&îA
	îGÑîGÑïÝî¢ïZîE
îƒî Úî ÚïZuïZî$RïZrïZ�î%
î&5	î,î,mî,mïZuïZî6UïZrïZî6­
î7ë�î8èî>/
î?ºîB7îHˆîJ¹îJ¹ïZî¢ï×î†î î"¾î%9
î&üî*Âî.Hî0y	î7@
î8~î<Óî@
îB]îE(
îF¾îF¾ï×î¢ïTîïTsïTî…ïTî	ôïgî¶î¶ïguïgîÊî Üî(Pî*®ïgï·�î+;ïgïgî+î,™î.÷ïgï·�î/Óïgïgî0	î8	ïgsïg�î8àïgrïgî98î9î;îBFîH
ïgî¢ï5îŒîÓî!²î#ãî(Zî.ªî.ªï5uï5î5Øï5rï5î60
î7»î9ìî>ÐîD.îD.ï5uï5îIúï5rï5�îJ©îK
îK
ï5î¢ï²uîpï²rï²îÈ
îî7î#xî(â
î*°î*°ï²sï²î4Äï²rï²�î5sî5Ëî8tî>ñîC;
îDþîGèîGèï²î¢ï
&î 
î!Ëî#Úî&î*ïî.T
î/ßî2î:Ñî?	îEå
îGpîI¡îI¡ï
&î¢ï£	îIî¡î!sî$¬
î&oî( î+ïî0ë
î2vî6Hî8Ñî=	îCäîD<
îE‘îGÂîGÂï£ÿ�����������
êq?€`½
����������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������11procedurecallissuccessful,Courierreturnstheresult(s)ofthecallasspecifiedintheRETURNSsectionoftheproceduredefinition.Ifthereisonlyasingleresult,itisreturneddirectly,otherwisealistofresultsisreturned.ProceduresthattakeaBulkDataargument(sourceorsink)aretreatedspecially;seesectionX.XX.Iftheprocedurecallresultsinanerror,oneofthreepossiblecoursesisavailable.ThedefaultbehavioristocauseaLisperror.Tosuppresstheerror,anoptionalkeywordcanbeappendedtotheargumentlist,asifanextraargument.ThisNOERRORFLGargumentcanbetheatomNOERROR,inwhichcaseNILisreturnedastheresultofthecall.IfNOERRORFLGisRETURNERRORS,theresultofthecallisalist(ERRORERRORNAME.ERRORARGS).IfthefailurewasaCourierReject,ratherthanError,thenERRORNAMEistheatomREJECT.Examples:(COURIERPROGRAMPERSONNEL(171)TYPES((PERSON.NAME(RECORD(FIRST.NAMESTRING)(MIDDLEMIDDLE.PART)(LAST.NAMESTRING)))(MIDDLE.PART(CHOICE(NAME0STRING)(INITIAL1STRING)))(BIRTHDAY(RECORD(YEARCARDINAL)(MONTHSTRING)(DAYCARDINAL))))PROCEDURES((GETBIRTHDAY3(PERSON.NAME)RETURNS(BIRTHDAY)REPORTS(NO.SUCH.PERSON)))ERRORS((NO.SUCH.PERSON1)))ThisexpressiondefinesPERSONNELtobeCourierprogramnumber17,versionnumber1.Theexampledefinesthreetypes,PERSON.NAME,MIDDLE.PARTandBIRTHDAY,andoneprocedure,GETBIRTHDAY,whoseprocedurenumberis3.ThefollowingcodecouldbeusedtocalltheremoteGETBIRTHDAYprocedureonthehostwithaddressHOSTADDRESS.(SETQSTREAM(COURIER.OPENHOSTADDRESS))(PROG1(COURIER.CALLSTREAM'PERSONNEL'GETBIRTHDAY(COURIER.CREATE(PERSONNEL.BIRTHDAY)FIRST.NAME_"Eric"MIDDLE_'(INITIAL"C")LAST.NAME_"Cooper"))(CLOSEFSTREAM))COURIER.CALLinthisexamplemightreturnavaluesuchas(1959"January"10).1.6.3.1ExpeditedProcedureCallSomeCourierserverssupport"ExpeditedProcedureCall",whichisawayofperformingasingleCouriertransactionbyaPacketExchangeprotocol,ratherthangoingtotheexpenseofsettingupafullCourierconnection.Expeditedcallsmusthavenobulkdataarguments,andtheirargumentsandresultsmusteachfitintoasinglepacket.(COURIER.EXPEDITED.CALLADDRESSSOCKET#PROGRAMPROCEDUREARG1...ARGNNOERRORFLG)[NoSpreadFunction]��îGÂï£î
êïførîH¼ïh„s
îJjïh„î¢ïb
rîòîM
î ‹
î'î+ëî0nî2Ÿî7°
î9;î;lî=Ç
î?HîDÑ
îFQîH‚îH‚ïb
î¢ï`~sîƒï`~rï`~îÛî!F
î"Ñî%î+R
î1¿î2
î3lî6Æ
î8î:î�î;ëî?¦îC™
îDÁ
îEÿîEÿï`~î¢ï^òîî!'î'�î(î*)
î+´î/Ó
î1î6€ï^òî¢ï\	îî  î"ê�î#çî'î*5î0.î4Æ
î6\î9“î;¹î@&	îEûîH!îH!ï\î¢ïZ‹î
îÙïZ‹î¢ïW§
î÷î(î xî"Óî&ò
î(r
î*5î-Ðî0M
î1Øî52î:Aî>ä
î@"	îF
îFYîIîIïW§î¢ïV$îî —
î!Õ
î#Uî&Û�î'Øî*Âî.\î.´
î0¬î6î8<î;×
î=šîBÉîH1îJŽîJŽïV$î¢ïT¡
îeîŠ
î 
î";î(4î*š
î,
î-N
î/î2Uî8¥î8ýî;çî;çïT¡uïT¡	îC×ïT¡rïT¡îD/îJ(îJ(ïT¡î¢ïSîÿ
îÂîóî Aî AïSsïSî&"ïSrïS�î&Ò
î(Rî,/î.ïî.ïïSsïSî1tïSrïSî1Ì
î3
î8t
î9õî<&î?Á
îALîC}îF/îF‡
îGÜîGÜïSî¢ïQ’u	î’ïQ’rïQ’îê
î (î (ïQ’sïQ’î*<ïQ’rïQ’�î*ìî-î0¸
î2Cî4tî6Ï
î8
�î9
î;î;ïQ’sïQ’î@ùî@ùïQ’uïQ’îH³�îI?îI?ïQ’î¢ïPî¬ïPsïP�îƒïPrïP�î2îŠ
î ßî#î'9î)·�î*´î/˜î4î7âî:Ùî>µîA¬îA¬ïPuïPîI ïPrïPîIx
îJ¶îJ¶ïPî¢ïNzîÓî!î!ïNzsïNzî!+ïNzrïNz�î!ˆïNzî	ôïKî"ïKsïKî(ïKî	ôïHÔîdîÊî#&
î$ÚïHÔî	ôïG|î
Ëî¢îyî²ïG|î	ôïF$î
Ëî¢îyî;îó
î)î/¿î/ÅïF$î	ôïDÌî
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înîEîîóî%«î/ÅïDÌî	ôïCtî
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înîEîîó	î(0î/ÅïCtî	ôïBî
Ëî¢îyî
Pî;îóî#ý�î%«î+’ïBî	ôï@Äî
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înîEîîóî&‚�î(0î/Åï@Äî	ôï?lî
Ëî¢îyî
Pî¶înî!xî)Þî)äï?lî	ôï>î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înî"Oî(6ï>î	ôï<¼î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înî ¡î*»ï<¼î	ôï;dî
Ëî¢îy	îåï;dî	ôï:î
Ëî¢îyî;�îéî$Úï:î	ôï8´î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîÀ	î#ýî*µî9Ùï8´î	ôï7\î
Ëî¢îyî‰ï7\î	ôï6î
Ëî¢îyîÀîKï6î	ôï4x�î
Ëï4xrï4xî
Ñï4xî	ôï1‹îÞ	îdîñîñï1‹sï1‹î€ï1‹rï1‹îØ
î!X
î#î'ÿî-]î2Yî4iî9�î=ü
î?[î?³îB\îG¤îG¤ï1‹î	ôï/ÿîîÛî˜î˜ï/ÿsï/ÿ
îÕï/ÿrï/ÿ�î…î…ï/ÿsï/ÿ
î(Âï/ÿrï/ÿî)î+£î+£ï/ÿsï/ÿî2[ï/ÿrï/ÿ�î3î5”î8	î>¹î>¹ï/ÿsï/ÿ
îGöï/ÿrï/ÿ�îH¦îH¦ï/ÿî	ôï.sî
òîBî>
î|
îÛî3îÜî$ºî'Ñî+k
î-.î0;
î1»î4î6Gî:¾î:¾ï.ssï.s
îCûï.srï.sîDSîJ£îJ£ï.sî	ôï,ç
îÌî
ýîÇî²îlîlï,çsï,ç
î!©ï,çrï,ç�î"�ï,çsï,çî"ï,çî	ôï*.îþîßî ¡î+’ï*.î	ôï(ÖîÕî—î!x	î*µî4Ïï(Öî	ôï'~î
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—î)	î2D�î3òî;‡ï'~î	ôï&&îêîÁî˜îoîFîîôîËî¢îyîPî'îþîÕî¬îƒîZî1îîßî¶î î!dî";î#	î,O�î-ýî3
ï&&î	ôï$Îî
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înîEîîóîÊî ¡î!xî"Oî(0�î)Þî2Dî6wî6}ï$Îî	ôï#vî
Ëî¢îyî
Pî'îþîÕî¬îƒîZî1îîßî¶îîdî;îîéîÀî—înîEîîóîÊî ¡î!xî"Oî*µ�î,c	î4Ïï#vî	ôï"î
Ëî¢îyî
Pî'îþîÕîîKï"î	ôï Æî	úï Æî	ôïÙîïÙrïÙî`
îàîRîšî!aî%`�î&]î)×î,Ù
î.Zî.ZïÙsïÙî3dî;Êî>OïÙrïÙ�î>¦ïÙqïÙî>¬ïÙî	ôïîîlîwî¤îýîcïrïîiïî	ôïî
šî~îàîº	î"Äî)î,åî0Â
î2��î2ýî5§
î72	î>1�î?.îBéîGÍîGÍïî	ôï‹
î¼
îŠ�î‡î¼îÊî#\î':î*1î-Ë
î/Kî1|î6ƒ
î8î<C
î>'�î?$îAîFcîFcï‹î	ôï
îîjîÄî£îÜî ô
î"Ìî%Ìî(¢	î/wî2�î5î;”î>îB<îEuîHwîJîJïî	ôï…îœ�î
™îTî}ï…sï…îƒï…î	ôï
˜îîï
˜uï
˜î#Ðî)Óî/åî7Yî9·ï
˜ïè�î:Dï
˜ï
˜î:Šî;¢î>�ï
˜ïè�î>Üï
˜ï
˜î?"	îGï
˜sï
˜�îGéï
˜rï
˜îHAîH™îJrîJrï
˜îêïfî îdïfÿ�������Î����
êq?€`½j������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������12AttemptstoperformaCouriercallusingtheExpeditedProcedureCall.ADDRESSistheNSaddressoftheremotehostandSOCKET#isthesocketonwhichitisknowntolistenforexpeditedcalls.TheremainingargumentsareexactlyaswithCOURIER.CALL.Iftheargumentstotheproceduredonotfitinonepacket,orifthereisnoresponsetothecall,orifthecallreturnstheerrorUSE.COURIER(whichmustbedefinedbyexactlythatnameinPROGRAM),thenthecallisattemptedinsteadbythenormal,non-expeditedmethod---aCourierconnectionisopenedwithADDRESS,andCOURIER.CALLisinvokedontheargumentsgiven.1.6.3.2ExpandingRingBroadcast"ExpandingRingBroadcast"isamethodoflocatingaserverofaparticulartypewhoseaddressisnotknowninadvance.Thesystembroadcastssomesortofrequestpacketonthedirectly-connectednetwork,thenonnetworksonehopaway,thenonnetworkstwohopsaway,etc.,untilapositiveresponseisreceived.ForuseinlocatingaserverforaparticularCourierprogram,astylizedformofExpandingRingBroadcastisdefined.TherequestpacketisessentiallythecallportionofanExpeditedProcedureCallforsomeproceduredefinedintheprogram.TheresponsepacketisaCourierresponse,andtypicallycontainsatleasttheserver'saddressastheresultofthecall.Thedesigneroftheprotocolmust,ofcourse,specifywhichproceduretouseinthebroadcast(usuallyitisprocedurenumberzero)andonwhatsockettheservershouldlistenforbroadcasts.START.CLEARINGHOUSEusesthisproceduretolocatethenearestClearinghouseserver.(COURIER.BROADCAST.CALLDESTSOCKET#PROGRAMPROCEDUREARGSRESULTFNNETHINTMESSAGE)[Function]PerformsanexpandingringbroadcastforserverswillingtoimplementPROCEDUREinCourierprogramPROGRAM.DESTSOCKET#isthesocketonwhichsuchserversofthistypeareknowntolistenforbroadcasts,typicallythesamesocketonwhichtheylistenforexpeditedcalls.ARGSistheargumentlist,ifany,totheprocedure(notethatitisnotspread,unlikewithCOURIER.CALL).Ifahostrespondspositively,thenthefunctionRESULTFNiscalledwithoneargument,theCourierresultsoftheprocedurecall.IfRESULTFNreturnsanon-nullvalue,thevalueisreturnedasthevalueofCOURIER.BROADCAST.CALLandthesearchstopsthere;otherwise,thesearchforaresponsivehostcontinues.IfRESULTFNisnotsupplied(orisNIL),thentheresultsoftheprocedurecallarereturneddirectlyfromCOURIER.BROADCAST.CALL;i.e.,RESULTFNdefaultstotheidentityfunction.NETHINT,ifsupplied,isanetnumberorlistofnetnumbersasahintconcerningwhichnet(s)totryfirstbeforeperformingapureexpanding-ringbroadcast.IfMESSAGEisnon-NIL,itisadescription(string)ofwhatthebroadcastislookingfor,tobeprintedinthepromptwindowtoinformtheuserofwhatishappening.Forexample,START.CLEARINGHOUSEpassesinthemessage"Clearinghouseservers"andthehintCH.NET.HINT.1.6.3.3UsingBulkDataTransferWhenaCourierprogramneedstotransferanarbitraryamountofinformationasanargumentorresultofaCourierprocedure,theprocedureisusuallydefinedtohaveoneargumentoftype"BulkData".Theargumentisa"source"ifitisinformationtransferredfromcallertoserver(asthoughaprocedureargument),a"sink"ifitisinformationtransferredfromservertocaller(asthoughaprocedureresult).Thesetwo"types"areindicatedinaCourierprocedure'sformalargumentlistasBULK.DATA.SOURCEandBULK.DATA.SINK,respectively.ACourierproceduremayhaveatmostonesuchargument.���îdïfî
êïførî	ôïh„s
î¢ïh„î¢ïb
rîc
îãî#
�î$î(ëî+Fî.Àî0ñî7Kî=¦î@»îAîAïb
uïb
îFïb
rïb
îFÙ
îHîJHîJHïb
î¢ï`~
îâîœ
î'î!Xî%Ïî(™î+"î+"ï`~uï`~î0ßï`~rï`~î17
î2uî4¦î8£
î:{î>X
î?€
î@¾îE
îF“îJîJï`~î¢ï^ûî±îÊî"�î"Xî%
î+Pî1Íî3óî8_
î9àî<Ëî<Ëï^ûsï^ûîFßï^ûrï^û�îGŽîGæ
îI;îI;ï^ûî¢ï]oîÓîP
î Ðî#
î)Q
î+)î-oî/
î0î3
î7
î9%
î:Xî=²
î>ð
î@ÈîF<
îG¼îIíîIíï]oî¢ï[ìîU
îë
îîOî ªî%-î'^î*¡î*¡ï[ìsï[ì
î3Þï[ìrï[ìî46î8Œî;Å
î=ˆîBW
îD%îH‘îH‘ï[ìî¢ïZ`îAîÒ
îRîRïZ`uïZ`î$ïZ`rïZ`
î%Gî(>î*oî,Ê
î.î4Nî8Ð
î:žî<ÏîA³îJ‹îJ‹ïZ`î¢ïXÝ	îŒî"p	î)7
î*uî/#î2î2ïXÝuïXÝî7|ïXÝrïXÝ�î8,î:µî:µïXÝsïXÝîDÉïXÝrïXÝîE!
îF_îF_ïXÝî¢ïWQî±
î‰îºî&7î)»ïWQqïWQî)ÁïWQî	ôïQ‹îîlîwîî&îïQ‹rïQ‹îïQ‹î	ôïN†	îaî™	îa
îŸ�îœî"v
î$
î(ú�î)÷î-Õ
î/`�î0]	î6_î9@î=>îAø
îC6îE|îIÑîIÑïN†î	ôïM
îtîèî@îéî5	î±î"î$
î&(î*Ìî.ö
î0Îî2ÿî>3îC±îF¨
îH€îH€ïMî	ôïK€îžîî¹î`îW
î/î"Ùî%Vî(xî,î.Óî1é�î2æî7Éî==
î>{îC½ïK€î	ôïHœîpî·
î7î0�î-îî�î	î#î'ýî-³�î.°î3rî6ª
î85î>òîB*îHB
îI€îI€ïHœî	ôïGîîrîî¿îé
î'
î"€î$±î'î+¸
î-C
î/î5`î;»î>yî@ˆîCìîJ<îJ<ïGî	ôïE–îÃ
îCîtî)îî*î žî$È
î&�î'î+çî1³î4<î9î>¾
î@)îCîEPîJ
îJ
ïE–î	ôïDî®
î/î`îû
î†î·îiîÁîjî$²
î&=î(nî-¨î19
î2Äî7;î;§î?„îEÔ
îGTîI›îI›ïDî	ôïB
îtî
¥îî—
î¿
îýî!Mî&Iî)–î,
î-÷î1%î5"î7Sî;1î?{îBôîEîEïBî	ôïA
îoïA
sïA
îuïA
î	ôï> îéï> rï> îAîî~î%Î
î'Nî+î-Eî1Èî:”î>qï> sï> î>wï> î	ôï;3îîï;3uï;3
î'%î-7î4«î7ÿî>cîCüîI„ï;3sï;3�îJ[ï;3rï;3îJ³îKîOhîOhï;3îêï9§	îï9§î¢ï8$îX
îî$—î'Kî-Cî/Rî3´î8
î9‡î@9î@9ï8$uï8$îGgï8$rï8$îG¿
îI?îI?ï8$î¢ï6¡î†î äî äï6¡uï6¡î&°ï6¡rï6¡�î'_î'·î'·ï6¡uï6¡
î0zï6¡rï6¡î0Ò
î2î4Aî8>
î:î=óî@õîEW
îFâîITîITï6¡î¢ï5îƒî©îþ
î!~î$÷î'
î-Úî3+î5\î8«î<¨
î>€îB]îE>îH·îH·ï5î¢ï3›î±îÊî"�î"Xî"Xï3›uï3›î%fï3›rï3›î%¾
î&üî)-î/&î1Œ
î2¿î5Š
î7
î9;î?‹îBïîEŽ
îF¶
îGôîJ:îJ:ï3›î¢ï2î0î7î""î""ï2sï2î,6ï2rï2
î-ï2î¢ï/+
î÷�îôî¾î!S
î' î*—î,Èî2î2ï/+uï/+î8-ï/+rï/+î8…
î9Ãî=‰î@tîBñîIBîIBï/+î¢ï-¨îÓî·î!Ö
î#aî%’î+âî.”î.ì
î0Aî0Aï-¨uï-¨î6_ï-¨rï-¨î6·î;:�î<7îAžîEpîG¡îG¡ï-¨î¢ï,%î
îZî Ä
î"Eî$vî'ð
î){î){ï,%sï,%î;õï,%rï,%î<Mî>ÖîAîEîH_îH_ï,%î¢ï*™îu	î Äî"õî&ÿî)�î*	î0‘î3[	î9©î:

î;Vî;Vï*™uï*™îAtï*™rï*™îAÌ
îC
îEPîJ­îJ­ï*™î¢ï)î±
îïîïï)sï)îtï)rï)
îî ”î"Åî&ä
î(oî* î0ðî3Kî5qî:Ûî?žîBÖîBÖï)î¢ï'Šsî)ï'Šrï'Š�î)íî,Rî,Rï'Šuï'Šî2pï'Šrï'Šî2Èî7Ã
î9Cî;tî@MîE“ï'Šuï'ŠîE™ï'Šî¢ï$îõï$rï$�î¥
îØî#
î$Ë�î%Èî'ùî,õ
î.‹î0™
î2$î4Uî9Õ
î;V�î<Sî?	îEÚîI·îI·ï$î¢ï#îI
îÉîÃî lî$‹	î+Š�î,‡î/”
î8å	î?4î?Œ
î@áî@áï#uï#îFiï#rï#îFÁ
îGÿîGÿï#î¢ï!—î
îÅ
î�î �
î&Ýî+u
î-�î0.î2_î8W
î9•î>Uî@¼
îB<
îCÿîH¢
îJ"îJ"ï!—î¢ï îÓîŒî"†
î$î(fî*—î-b
î.íî2
î3Y	î:Bî:šî=îB¶îB¶ï î¢ï‘sî&—ï‘rï‘î&ïî*ã
î,cî.”î3¼î3¼ï‘sï‘
î@UîG
ï‘rï‘îGeîIîîIîï‘î¢ïîÓî‡î‡ïsï
î$Äïrï�î%ïqïî%!ïî	ôï?îîlîwî;î[îžî£ï?rï?î©ï?î	ôï:î
Ý�îÚî¾îîÎ
îNî#)
î$ìî*`î/:
î0Å
î8
î9›
î;^îAW
îBíîFˆ
îH�îIîIï:î	ôï·îØ	î€î±î

î?î#Àî(
î*î-'î/¤î5
î7(î:	î=ÙîBîBfîEîEï·î	ôï4îí
î+�î(î§
îÚ
î
î@
î"•
î)_î,—î0
î1›î5yî7sî;õ�î<òîCB	îJîJï4î	ôï±�î
ñî
îB
îj
î¨
îý
î Çî#ÿî'Ý
î)]î,áî.Ûî3]�î4Zî:ªî?î?mîC?îE¼îJîJï±î	ôï.îîÚ
îZ�îWî;
î gî$¦î*Ÿî,­
î..î..ï.sï.î;žï.rï.î;öî>î>ï.î	ôï¢s
î¶ï¢rï¢�îfîþîV�îµî$™î*éî-¿î0×
î2Bî5oî7ìî:îîA>îADï¢�������÷����
êq?€`½ú������������������13InaCouriercall,thebulkdataistransmittedinaspecialway,betweentheargumentsandtheresults.Therearetwobasicwaystohandlethisinthecall.Thecallercanspecifyhowthebulkdataistobeinterpreted(howtoreadorwriteit),orthecallercanrequesttobegivenabulkdatastreamastheresultoftheCouriercall.Theformeristhepreferredway;botharedescribedbelow.Inthefirstmethod,thecallerpassesastheactualargumenttotheCouriercall(i.e.,inthepositionintheargumentlistoccupiedbyBULK.DATA.SOURCEorBULK.DATA.SINK)afunctiontoperformthetransfer.Couriersetsupthetransaction,thencallsthesuppliedfunctionwithoneargument,astreamonwhichtowrite(ifasourceargument)orread(ifasink)thebulkdata.Ifthefunctionreturnsnormally,theCouriertransactionproceedsasusual;ifiterrorsout,CouriersendsaBulkDataAborttoabortthetransaction.Inthecaseofasinkargument,ifthevaluereturnedfromthesinkfunctionisnon-NIL,itisreturnedastheresultofCOURIER.CALL;otherwise,theresultofCOURIER.CALListheusualprocedureresult,asdeclaredintheCourierprogram.Forconvenience,aBulkDatasinkargumenttoaCouriercallcanbespecifiedasafullyqualifiedCouriertype,e.g.,(CLEARINGHOUSE.NAME),inwhichcasetheBulkDatastreamisreadasa"streamof"thattype(seeCOURIER.READ.BULKDATA,below).ThesecondmethodforhandlingbulkdataistopassNILasthebulkdata"argument"toCOURIER.CALL.Inthiscase,Couriersetsupthecall,thenreturnsastreamthatisopenforOUTPUT(ifasourceargument)orINPUT(ifasink).Thecallerisresponsiblefortransferringthebulkdataonthestream,thenclosingthestreamtocompletethetransaction.ThevaluereturnedfromCLOSEFistheCourierresult.Thismethodisrequiredifthecaller'scontrolstructureisopen-endedinawaysuchthatthebulkdatacannotbetransferredwithinthescopeofthecalltoCOURIER.CALL.Ineithermethod,thestreamonwhichthebulkdataistransferredisastandardInterlispstream,soBIN,BOUT,COPYBYTESareallappropriate.ManyCourierprogramsdefinea"Streamof<type>"asameansoftransferringanarbitrarynumberofobjects,allofthesametype.AlthoughthisistypicallyspecifiedformallyintheprintedCourierdocumentationasarecursivedefinition,therecursionisinpracticeunnecessaryandunwieldy;instead,thefollowingfunctionshouldbeused.(COURIER.READ.BULKDATASTREAMPROGRAMTYPE)[Function]ReadsfromSTREAMa"StreamofTYPE"forCourierprogramPROGRAM,andreturnsalistoftheobjectsread.Passing(X.Y)asthebulkargumenttoaCouriercallisthusequivalenttopassingthefunction(LAMBDA(STREAM)(COURIER.READ.BULKDATASTREAMXY)).1.6.3.4CourierSubfunctionsforDataTransferThefollowingfunctionsareofinteresttothosewhotransferdatainCourierrepresentations,e.g.,aspartofafunctiontoimplementauser-definedCouriertype.(COURIER.READSTREAMPROGRAMTYPE)[Function]ReadsfromthestreamSTREAMaCouriervalueoftypeTYPEforprogramPROGRAM.IfTYPEisapredefinedtype,thenPROGRAMisirrelevant;otherwise,itisrequiredinordertoqualifyTYPE.(COURIER.WRITESTREAMITEMPROGRAMTYPE)[Function]WritesITEMtothestreamSTREAMasaCouriervalueoftypeTYPEforprogramPROGRAM.(COURIER.READ.SEQUENCESTREAMPROGRAMBASETYPE)[Function]���îADï¢î
êïførîH¼ïh„s
îJjïh„î	ôïb
r
î–�î“îwî*î[î[î1
îo
î$z
î%ú�î&÷î+Aî.Cî3î5²î</î>¸î@éîE_îE·îI‰îI‰ïb
î	ôï`~îî—îÚî
îˆîÞîP
îÐî!
î#³î$î&´î*8î,•î1
î3Öî6î9î;Ý
î=
î>›
î@^
îG=îJ‹îJ‹ï`~î	ôï^û
îtî`
îöîDî=
îÓîîˆîåî#‰
î%	
î&Ìî*Q�î+Nî.Nî1$î5e
î6æî9î<²
î>=î@nîERîHîH\îH\ï^ûî	ôï]xîîþ
î<îmîEîhî tî"šî(’î,sï]xî	ôïZ”
î–î
Çîpî¢îÓîWîK
î Ìî"ýî&Ïî,È
î.Hî0yî5]î7¸î:–
î<î>GîCU
îDÕîGîGïZ”î	ôïYîíîûîš
îhîhïYsïYî&ØïYrïYî'0
î(Æî(ÆïYsïY
î4ˆïYrïY�î5Y�î6Vî;
î=îBDîDuîI§îIÿîIÿïYî	ôïW…îØîK
î/î`î€îwî"Vî$‡î)äî/+î2î4“î:ä�î;áî@"
îAúîE×
îGWîJ¥îJ¥ïW…î	ôïVî �îî¼î.
îÄî°î\�îYî!î#Áî&Áî)îî*F
î+›î-Ìî3î7–î=Œî?½îD¡îD¡ïVî	ôïT
î¼îF
îÇî¯
îâ
î
î!Ñî$oî)Sî,ä�î-áî1
î4/î8�
î9€î<ïî? îEíïTî	ôïQ›
î–î
Çî‡
î�îîÍî
îQî‚î"üî(fî+žî-Ïî0î5Ô
î7î9ÑïQ›sïQ›î<VïQ›rïQ›�î=
î>.
î?lîDÖ
îFWîHˆîHˆïQ›î	ôïPî

îîïPsïPî.ïPrïP�îÿ	î Nî"î&
î'¥î'¥ïPsïPî1¹ïPrïPî2
î3Oî5€î8ïî??îC2
îD³îJîJïPî	ôïNƒ
îtî
¥î‰îìïNƒî	ôïKŸîpîa�î^î~î¬îjî$c
î%ã�î&àî+Äî.î0|
î2?î7È
î9I�î:Fî=QîBäîGÈîGÈïKŸî	ôïJî
-îàîàïJsïJ
îy�î'î"ZïJrïJ�î#

î$Šî(gî+'î-Xî0xî3¦î7ç
î9%î<
î=’�î>îC€îE»îHZîHZïJî	ôïHîÕîtîtïHsïHî!ïHrïH�î!Çî&!ïHî	ôïE£îîþîØîçîpî pî#F
î$„
î&î(Ïî(ÏïE£sïE£î+TïE£rïE£î+¬
î--î/^î2^î54	î<
î>
î>
ïE£sïE£îH!ïE£rïE£�îHÐîI(îI(ïE£î	ôïD
î–îî îîw
î[îŒî?î"6î&¹�î'¶î+÷î.–
î/Ôî3î5&î5&ïDsïDî:0ïDrïDî:ˆî<4�î=1îAPîGÂ
îIXîIXïDî	ôïB‹sî'ïB‹rïB‹îî+�î(î¶îî·î;
îy
î#wî%†î,½î.îî1îî4Ä
î6œî8Íî=fî@]îDÇîFøîFøïB‹î	ôï@ÿî5
îµîjî›îºîî!»î%5î*Ÿî-×î-×ï@ÿsï@ÿî2áï@ÿrï@ÿî39
î4wî6¨î;Œî?~î?ÖîBÀîGš
îHØîHØï@ÿî	ôï?sîR
î…î¶îî–î!!
î"_	î)·
î+7�î,4î.Þî1àî4î6°î9°î<†î@Ñ
îB”
îI^îI^ï?sî	ôï=ðîî8îÓ
î^îîê
îjîjï=ðsï=ðî%~ï=ðrï=ð�î%Ûï=ðî	ôï;
î–îRî„îµîö
îÎî «î"Üî%Üî(²
î)ð
î0º
î1ø�î2õî8_î=¦îB?
îCÕîCÕï;sï;îFZï;rï;�îG
îG
ï;î	ôï9wsî
Pï9wrï9w�î�î�ï9wsï9wîï9wrï9wîçî
îÎî þï9wî	ôï6Šî
¼î î‚î‹�îˆî"»
î$Fî)7
î*¸�î+µî/Ê
î1Uî8Œ
î:Oî?ÃîD¿
îFJîFJï6Šî	ôï5î·îx
îî4îƒî»îî þî#p
î$®î)ÿî/ˆî4Ù
î6Yî8Šî=-îBîBï5î	ôï3„î#
î¤�î¡îA
î!¯î#àî)«
î*é
î,iî1Y
î8Èî;QîAŠîFdîH•îH•ï3„î	ôï2
îÒîîc
î&î2ï2
sï2
î8ï2
î	ôï/îEîEï/uï/î"Yî(kî+gï/sï/�î,>ï/rï/î,–î,îî0 	î6Fï/î¢ï-ˆî–îÎîÎï-ˆuï-ˆî"œï-ˆrï-ˆî"ô�î#ñî)$
î*¯î*¯ï-ˆuï-ˆî-«ï-ˆrï-ˆ�î.³î0Âî5¦î;î;ï-ˆuï-ˆî@Ðï-ˆrï-ˆ�îA€îD	îHŒ�îI‰îI‰ï-ˆî¢ï,î°
î;îlî ×î#Èï,î¢ï)!îPîPï)!sï)!
îÕ�îƒ
î!1ï)!rï)!î!‰
î#
î%;î(;î.4
î/´�î0±î5•î7ð
î9.î<	îB
îCÿîH¢îH¢ï)!î¢ï'•îÓîîï'•sï'•î$Òî,aî?²îE“�îGAîIÆï'•rï'•�îJï'•qï'•îJ#ï'•î	ôï!ÏîîlîwîDîEîHî!‹î&ï!Ïrï!Ïî&–ï!Ïî	ôïÊîî{îFîl
î÷î ¥
î"%î%”î(iî-Dî0
î1šî6~î@îBÏ
îDPîG
îH�îIîIïÊî	ôïGî;
î»îm�îjî %î%	î'éïGsïGî'ïïGî	ôïZî¶î¶ïZuïZîÊî Üî#ØïZsïZ�î$¯ïZrïZî%î%_î0 	î6FïZî¢ïÎî–îÎîÿî$@î$@ïÎuïÎî)ïÎrïÎî)f�î*cî/Gî2Á
î4Lî7-î7-ïÎuïÎî:)ïÎrïÎî:î<îAîîAîïÎuïÎîGºïÎrïÎ�îHiîHÁ
îJîJïÎî¢ïKuîžïKrïKîö
î4�î1	î"ïî&(î)î)ïKuïKî.ëïKrïKî/C
î0
î6ñ	î=@
î>h
î?¦îE
îF„îJ	îJ	ïKî¢ïÈ
î"î˜î˜ïÈuïÈî”ïÈrïÈ�îëïÈsïÈîñïÈî	ôïÛ
îîïÛuïÛî¡îìî$þî'úïÛsïÛ�î(ÑïÛrïÛî))î)î0 	î6FïÛî¢ïOî×î×ïOuïOîÜïOrïOî4
î´î!åî&&î&&ïOuïOî*ôïOrïOî+L
î,Í�î-Êî2®î6(
î7³î:”î:”ïOuïOî=ïOrïOî=èî?÷îEUîEUïOî¢ïÌuînïÌrïÌ�îÅïÌsïÌîËïÌî	ôïßîEîEïßuïßî"Yî(kî.eïßsïß�î/<ïßrïßî/”î/ìî0 	î6Fïß�������;����
êq?€`½*��������������������������������������������������������������������������������������������������������������14ReadsfromthestreamSTREAMaCouriervalueSEQUENCEofvaluesoftypeTYPEforprogramPROGRAM.Equivalentto(COURIER.READSTREAMPROGRAM(SEQUENCEBASETYPE)).(COURIER.WRITE.SEQUENCESTREAMITEMPROGRAMBASETYPE)[Function]Equivalentto(COURIER.WRITESTREAMITEMPROGRAM(SEQUENCEBASETYPE)).SomeCourierprogramstrafficinvalueswhoseinterpretationisleftuptotheclientsoftheprogram;thevaluesaretransferredinCouriertransactionsasvaluesoftype(SEQUENCEUNSPECIFIED).Forexample,theClearinghouseprogramtransfersthevalueofadatabasepropertyasanuninterpretedsequence,leavingituptothecaller,whoknowswhattypeofvaluetheparticularpropertytakes,tointerpretthesequenceofrawbitsassomeotherCourierrepresentation.Thefollowingfunctionsareusefulwhendealingwithsuchvalues.(COURIER.WRITE.REPVALUEPROGRAMTYPE)[Function]Producesalistof16-bitintegers,i.e.,avalueoftype(SEQUENCEUNSPECIFIED),thatrepresentsVALUEwheninterpretedasaCouriervalueoftypeTYPEinPROGRAM.Examples:(COURIER.WRITE.REPTNIL'BOOLEAN)=>(1)(COURIER.WRITE.REP"Thing"NIL'STRING)=>(552150Q64556Q63400Q)(COURIER.WRITE.REP'(1025)NIL'(SEQUENCEINTEGER))=>(21025)(COURIER.READ.REPLIST.OF.WORDSPROGRAMTYPE)[Function]InterpretsLIST.OF.WORDS,alistof16-bitintegers,asaCourierobjectoftypeTYPEintheCourierprogramPROGRAM.(COURIER.WRITE.SEQUENCE.UNSPECIFIEDSTREAMITEMPROGRAMTYPE)[Function]WritestothestreamSTREAMintheform(SEQUENCEUNSPECIFIED)theobjectITEM,whosevalueisreallyaCouriervalueoftypeTYPEforprogramPROGRAM.Equivalentto,butusuallymuchmoreefficientthan,(COURIER.WRITESTREAM(COURIER.WRITE.REPITEMPROGRAMTYPE)NIL'(SEQUENCEUNSPECIFIED)).���î6Fïßî
êïførî	ôïh„s
î¢ïh„î¢ïb
rî–îÎîÿî$@î$@ïb
uïb
î)ïb
rïb
î)f�î*cî/Gî2Áî2Áïb
sïb
î9yïb
rïb
î9Ñ
î;\î?Z
î@åîCÆîCÆïb
uïb
îFÂïb
rïb
îGîI)îI)ïb
î¢ï`uî�î�ï`uuï`uî!Ìï`urï`u�î"{î"Ó	î)
î+î+ï`usï`uî6Ñî6Ñï`uuï`uî;Ÿï`usï`uî<vî<vï`uuï`uîBBï`usï`uîCîCï`uî¢ï^éîîï^éuï^éî%ï^ésï^é
î&°ï^érï^é�î'ï^ésï^éî'
ï^éî	ôï[üîîï[üuï[üî#0î&{î,î2‡ï[üsï[ü�î3^ï[ürï[üî3¶î4î6š	î<Àï[üî¢ïZp	î^
îÞîÞïZpsïZp
î+wî+wïZpuïZpî0EïZpsïZpî1î1ïZpuïZpî4!ïZpsïZpî4øî4øïZpuïZpî:ÄïZpsïZpî;›îD
îD
ïZpî¢ïXäuîœïXäsïXä
îJïXärïXä�î§ïXäî	ôïU÷î
šî~î`î=
î½î!»î%¹
î."
î/`î1¦
î3Š
î5
î7;î;N
î<Ùî?
îDáîGîGïU÷î	ôïTtî
òî
îâ
îbîFî$’
î&î*
î+œî.}î.}ïTtsïTtî6ãî@÷ïTtrïTt�îA¦îAþîDzîJîJïTtî	ôïRèî%îñîOî®î!ßî%Y
î&ä�î'áî-Kî2´
î45
î5øî>cîDrîHþ
îJ&îJ&ïRèî	ôïQe
îØ
î
Xî‰îeî:îMî{î \
î!çî%aî'’	î-”î2ýî6£
î8#î=—î?ÈîE
îG
îIˆîIˆïQeî	ôïOâîf
î
çîKîºîžî"·î#î%¸î+–î1aî3‡î7oî:õî?—îB‚îE„îIïOâsïOâîI‡ïOâî	ôïLõîéîéïLõuïLõî#î$5î'1ïLõsïLõ�î(ïLõrïLõî(`î(¸î0 	î6FïLõî¢ïKiîX�îUîc
î îî$µî)ýî,b�î-_î0Ù
î2dî5Eî5EïKisïKiî=«îG¿ïKirïKi�îHoîHoïKiî¢ïIÝîA	î’î’ïIÝuïIÝî#†ïIÝrïIÝî#Þî'd
î.C
î/Ä�î0Áî5¥î9
î:ªî=‹î=‹ïIÝuïIÝî@‡ïIÝrïIÝî@ß
îB_îB_ïIÝuïIÝîH+ïIÝrïIÝ�îHÚîI2îI2ïIÝî¢ïHZîÐïHZsïHZîÖïHZî¢ïEmî&—�î(Eî+¡î4î4ïEmrïEm
î6ïEmsïEmî6îî9yïEmî¢ïB€î&—î-Oî0«î8:î8:ïB€rïB€
î:JïB€sïB€î:PïB€î¢ïA(îÖîÌ
î Qî&2î,î1úïA(î¢ï>;î&—î*Êî.&î1‚	î:¿îC%îC%ï>;rï>;
îE5ï>;sï>;îFîFãîFéï>;î¢ï<ãîÖîÌ
î Q
î"Öî%aï<ãî	ôï9öîîï9öuï9öî"aî(sî+oï9ösï9ö�î,Fï9örï9öî,žî,öî0 	î6Fï9öî¢ï8j	î¼î¼ï8juï8jî%Åï8jrï8j�î&u�î'rî)€
î+î.Òî4
î5›�î6˜î;|î?c
î@îîCÏîCÏï8juï8jîFËï8jrï8jîG#
îH£îH£ï8jî¢ï6çîÓî·î#î#ï6çuï6çî(áï6çrï6ç�î)8ï6çsï6çî)>ï6çî	ôï3úð#î(0î(0ï3úuï3úî-Dî0î6¡î9ï3úsï3ú�î:tï3úrï3úî:Ìî;$î;	îA¶ï3úî¢ï2nî×
îWîˆî"Éî"Éï2nuï2nî'—ï2nrï2nî'ï
î)oî+ î.Øî.Øï2nsï2nî7>îARï2nrï2nîAªîCÛîGÂîGÂï2nî¢ï0âuî§ï0ârï0â�îWîUî!Ï
î#
î&§�î'¤î,ˆî0
î1î4nî4nï0âuï0âî7jï0ârï0âî7Âî9Ñî?/î?/ï0âuï0âîDûï0ârï0â�îEªîFîFï0âî¢ï/_	î^î6î!ˆî&	î)°î-î2:î5‰î5‰ï/_sï/_
îB"îB"ï/_uï/_îFðï/_sï/_îGÇîGÇï/_î¢ï.î&—î&—ï.uï.î)œï.sï.î*sî*sï.uï.î0?ï.sï.î1î1ï.uï.î4ï.sï.�î5Àî9	îBYîBYï.î¢ï,{î!ï,{rï,{�î!äï,{sï,{î!êï,{ÿ�������û����
êq?€`½r������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������
é
TIMESROMAN���������

�����
é
TIMESROMAN���������

�
����~GACHA����������������
����
é
TIMESROMAN����������
�
����

é
TIMESROMAN���������
�
�����~GACHA�������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������
�X���
�
�Z��������&��K���1��-���=�����I�
�T���V��Z���a��‹���m��z���{��®���†�
�	���“�
�7��� ���
�¨�
�Ÿ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������j/�«��©�
ÿÿÞEº�
�
ÿÿÿÿÿÿ��������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������������'{ERIS}<LISP>HARMONY>DOC>ETHERNS.TEDIT;2������������SANNELLA����������������������� 5-Dec-84 15:20:50���������������������������������������������������������������������������������������������������������������������������������������������������������