%!PS %%Title: The XPA Help Facility %%Creator: html2ps version 1.0 beta5 %%EndComments save 2000 dict begin /d {bind def} bind def /D {def} d /t true D /f false D /FL [/Times-Roman /Times-Italic /Times-Bold /Times-BoldItalic /Courier /Courier-Oblique /Courier-Bold /Courier-BoldOblique /Helvetica /Helvetica-Oblique /Helvetica-Bold /Helvetica-BoldOblique] D /WF t D /WI 0 D /F 1 D /IW 471 F div D /IL 621 F div D /PS 791 D /EF [0 1 0 0 0 0 0 0 0 0 1 1 0 0 0 0 0 0 0 0 0 0 2 2] D /EZ [11 9 19 17 15 13 12 11 11 11 11 11 11 11 11 11 11 11 11 11 11 11 8 8] D /Ey [0 0 2 2 2 2 2 2 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0] D /EG [-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1] D /Tm [1 1 0.8 0.8 0.8 0.8 0.8 0.8 0 0 0 0 0 0 0.5 1 1 1 1 0 0 1.3 0 0] D /Bm [1 1 0.5 0.5 0.5 0.5 0.5 0.5 0 0 0 0 0 0 0.5 1 1 1 1 0 0 1 0 0] D /Lm [0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 2 2 0 0 2 0 0 0] D /Rm [0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0] D /EU [-1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 -1 0 0] D /NO t D /YY [[{()}1][{()}0][{()}2]] D /ZZ [[{()}1][{()}0][{()}2]] D /Ts EZ 0 get D /TU f D /Xp t D /AU t D /SN 0 D /Cf f D /Tp f D /Fe f D /TI 1 Ts mul D /Fm 14 D /xL 71 D /xR 71 D /yL 706 D /yR 706 D /Wl 471 F div D /Wr 471 F div D /hL 621 F div D /hR 621 F div D /FE {newpath Fm neg Fm M CP BB IW Fm add Fm L IW Fm add IL Fm add neg L CP BB Fm neg IL Fm add neg L closepath} D /LA {PM 0 eq{/IW Wl D /IL hL D}{/IW Wr D /IL hR D}ie /W IW D /LL W D /LS W D TU PM 0 eq and{IW 56 F div add SA{Sf div}if 0 translate} {PM 0 eq{xL yL}{xR yR}ie translate F SA{Sf mul}if dup scale CS CF FS Cf{CA CL get VC}if /Bb f D}ie 0 0 M TF not Tc or {Cf{gsave SA{1 Sf div dup scale}if Cb VC FE fill grestore}if}if}D /Pi 0 Ts mul D /SG [0.8 1 1] D /Ab 15 D /J 0 D /Tc t D /NH 6 D /Nf f D /Pa f D /LH 1.2 D /XR f D /Xr {/pN E D ( [p ) WB pN WB (] )WB} D /Db [16#FF 16#FF 16#FF] D /Dt [16#00 16#00 16#00] D /eA f D /Fi f D /bT f D /Lc t D /Dl [16#00 16#00 16#00] D /LX f D /Br 0.25 D /IA ([IMAGE]) D /DS {/PF f D()WB NL NP()pop RC ZF} D /Gb f D /Mb t D /Hc [16#00 16#00 16#00] D /Bl 3 D /MI -15.2 D /DX (DRAFT) D /Di 0 D /Tt 113.385826771654 D /Th {()2 Al()BR ( ) 0 1 -1 H()4 FZ Ti ES()EH ( ) 0 2 -1 H() ME 0 get join EH()Ea()BR()} D /tH {()0 1 -1 H (Table of Contents) EH()} D /FD 2 D /Dy 2 D /cD [16#F0 16#F0 16#F0] D /FW 0.6 D /FU [16#00 16#00 16#00] D /ET {/RM f D /A0 0 D /PN SN D /OU t D /Ou t D /W IW D /LL W D D1 Ms not TP and{Ip}if /TF f D} D [{true statusdict/setduplexmode get exec} stopped cleartomark %-- End of variable part -- /MySymbol 10 dict dup begin /FontType 3 D /FontMatrix [.001 0 0 .001 0 0 ] D /FontBBox [25 -10 600 600] D /Encoding 256 array D 0 1 255{Encoding exch /.notdef put}for Encoding (e) 0 get /euro put /Metrics 2 dict D Metrics begin /.notdef 0 D /euro 651 D end /BBox 2 dict D BBox begin /.notdef [0 0 0 0] D /euro [25 -10 600 600] D end /CharacterDefs 2 dict D CharacterDefs begin /.notdef {} D /euro{newpath 114 600 moveto 631 600 lineto 464 200 lineto 573 200 lineto 573 0 lineto -94 0 lineto 31 300 lineto -10 300 lineto closepath clip 50 setlinewidth newpath 656 300 moveto 381 300 275 0 360 arc stroke -19 350 moveto 600 0 rlineto -19 250 moveto 600 0 rlineto stroke}d end /BuildChar{0 begin /char E D /fontdict E D /charname fontdict /Encoding get char get D fontdict begin Metrics charname get 0 BBox charname get aload pop setcachedevice CharacterDefs charname get exec end end}D /BuildChar load 0 3 dict put /UniqueID 1 D end definefont pop /Cd {aload length 2 idiv dup dict begin {D} repeat currentdict end} D /EX {EC cvx exec} D /DU {} d /BB {pop pop}d /ie {ifelse} d /E {exch} d /M {moveto} d /R {rmoveto} d /L {lineto} d /RL {rlineto} d /CP {currentpoint} d /SW {stringwidth} d /GI {getinterval} d /PI {putinterval} d /Sg {setgray} d /LW {setlinewidth} d /S {dup () ne OU and{0 Co R AT 3 eq LB and HF not and A1 0 ne A2 0 ne or and {A2 0 32 A1 0 6 -1 roll awidthshow}{show}ie 0 Co neg R}{pop}ie OU PH 3 eq or{/Ms t D}if} D /U {OU{gsave CP currentfont /FontInfo get /UnderlinePosition get 0 E currentfont /FontMatrix get dtransform E pop add newpath M dup SW pop CJ 0 RL stroke grestore}if} D /B {OU Br 0 gt and{CP Ts neg Ts .33 mul R gsave 0 Sg CP newpath Ts Br mul 0 360 arc closepath UI 2 mod 0 eq{stroke}{fill}ie grestore M CP E Ts Br 1 add mul sub E BB /Ms t D}if}D /NP {Ms TP not or PA and OU and{TP{OR}if f1{mF k2 /mF E D /YC 0 D}if TP TU not PM 0 eq or and{showpage}if DU Ip TE not{LA}if 0.6 LW /CI 0 D /TP t D /Hs f D /hl 6 D /Hv 6 D /HI hi D /Ms f D}if Bs XO BO M} D /Np {LE sub CP E pop gt PL 0 eq and{NP}if}D /Ip {/PN PN 1 add D /Pn RM{1}{4}ie PN Ns D /PM PN SN sub 2 mod D} D /GP {E dup 3 -1 roll get PN 1 add 2 mod get dup type /integertype eq {get 0 get}{E pop}ie}d /Fc {dup 2 GP exec SW pop /S1 E D dup 1 GP exec SW pop /S2 E D 0 GP exec SW pop /S3 E D S1 0 gt{S2 2 mul S1 add S3 2 mul S1 add 2 copy lt{E}if pop}{0}ie S2 S3 add 2 copy lt{E}if pop IW .9 mul div dup 1 gt{1 E div}{pop 1}ie}D /OR {Df{Sd}if tp not{gsave SA{1 Sf div dup scale}if Fe{Cf{FU VC}if FW LW 1 setlinejoin FE stroke}if /YO {60 F div dup 40 gt{pop 40}if}D /cs CS D /cf CF D /CF 0 D /pf PF D /PF f D /Fn FN D /At AT D /AT 0 D /FN EF Hf 1 add get D Fz Fs FS ZZ Fc Fz mul Fs FS EU Hf 1 add get dup type /arraytype eq Cf and{VC}{pop 0 Sg}ie IW IL neg YO sub M ZZ 1 GP exec dup SW pop neg 0 R Sh 0 IL neg YO sub M ZZ 0 GP exec Sh ZZ 2 GP exec dup SW pop IW E sub 2 div IL neg YO sub M Sh Fz Fs FS NO{/AW IW Pn SW pop sub D AW 2 div IL neg YO sub S1 0 gt S2 AW .45 mul gt or S3 AW .45 mul gt or{Fz 2 mul sub}if M Pn Sh}if EU Hf get dup type /arraytype eq Cf and{VC}{pop 0 Sg}ie YY Fc /FN EF Hf get D Hz mul HS FS IW YO M YY 1 GP exec dup SW pop neg 0 R Sh 0 YO M YY 0 GP exec Sh YY 2 GP exec dup SW pop IW E sub 2 div YO M Sh /FN Fn D /AT At D t Pb XO SZ SL get neg R /PF pf D grestore /CF 0 D cs cf FS}if}D /Sh {dup () ne{CP Hz 4 div sub BB show CP CS add BB}{pop}ie}D /Pb {/OU E D /Ou OU D /PB t D 0 0 M Ba{/Sa save D /BP t D /Fl t D RC /PL 0 D /PH 0 D /W IW D /LE IL .7 mul D /EO 0 D SI ZF /YA 0 D /BO 0 D /C1 () D BA 0 Ts neg R Bb{Xl Yl Xh Yh}if Bb CP Sa restore M {/Yh E D /Xh E D /Yl E D /Xl E D}if /Fl t D}if BL /OU t D /HM f D /Ou t D /PB f D} D /Bs {/BP Ba not D}D /reencodeISO { dup dup findfont dup length dict begin{1 index /FID ne{D}{pop pop}ie}forall /Encoding ISOLatin1Encoding D currentdict end definefont} D /ISOLatin1Encoding [ /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /space/exclam/quotedbl/numbersign/dollar/percent/ampersand/quoteright /parenleft/parenright/asterisk/plus/comma/hyphen/period/slash /zero/one/two/three/four/five/six/seven/eight/nine/colon/semicolon /less/equal/greater/question/at/A/B/C/D/E/F/G/H/I/J/K/L/M/N /O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash/bracketright /asciicircum/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m /n/o/p/q/r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/asciitilde /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef /.notdef/space/exclamdown/cent/sterling/currency/yen/brokenbar /section/dieresis/copyright/ordfeminine/guillemotleft/logicalnot /hyphen/registered/macron/degree/plusminus/twosuperior/threesuperior /acute/mu/paragraph/periodcentered/cedilla/onesuperior/ordmasculine /guillemotright/onequarter/onehalf/threequarters/questiondown /Agrave/Aacute/Acircumflex/Atilde/Adieresis/Aring/AE/Ccedilla /Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute/Icircumflex /Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis /multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute /Thorn/germandbls/agrave/aacute/acircumflex/atilde/adieresis /aring/ae/ccedilla/egrave/eacute/ecircumflex/edieresis/igrave /iacute/icircumflex/idieresis/eth/ntilde/ograve/oacute/ocircumflex /otilde/odieresis/divide/oslash/ugrave/uacute/ucircumflex/udieresis /yacute/thorn/ydieresis ] D [128/backslash 129/parenleft 130/parenright 141/circumflex 142/tilde 143/perthousand 144/dagger 145/daggerdbl 146/Ydieresis 147/scaron 148/Scaron 149/oe 150/OE 151/guilsinglleft 152/guilsinglright 153/quotesinglbase 154/quotedblbase 155/quotedblleft 156/quotedblright 157/endash 158/emdash 159/trademark] aload length 2 idiv 1 1 3 -1 roll{pop ISOLatin1Encoding 3 1 roll put}for /colorimage where{pop}{ /colorimage { pop pop /Pr E D {/Cv Pr D /Gr Cv length 3 idiv string D 0 1 Gr length 1 sub {Gr E dup /i E 3 mul D Cv i get 0.299 mul Cv i 1 add get 0.587 mul add Cv i 2 add get 0.114 mul add cvi put}for Gr} image} D }ie /pdfmark where{pop}{userdict /pdfmark /cleartomark load put}ie WF{FL{reencodeISO D}forall}{4 1 FL length 1 sub{FL E get reencodeISO D}for}ie /Symbol dup dup findfont dup length dict begin {1 index /FID ne{D}{pop pop}ie}forall /Encoding [Encoding aload pop] dup 128 /therefore put D currentdict end definefont D /SF {/CS E D SZ SL CS put FO SL FN put /YI CS LH neg mul D dup ST cvs ( ) join CS ST cvs join C1 E join ( NF ) join /C1 E D CS NF /Wf WF FN 0 gt or D /BW Wf{( ) SW pop}{0}ie D}D /NF {/cS E D /cF E D cF 0 ge{FL cF get}{cF -1 eq{/Symbol}{/MySymbol}ie}ie findfont cS scalefont setfont} D /FS {CF or /CF E D FR SL CF put CF CF 0 ge{FN 4 mul add}if E SF} D /PC {SH /BP f D fin not GL not and{NL}if /HM t D /LL LS D} D /BS {/TX E D Wf{/fin f D /CW 0 D /LK 0 D /SC 0 D /RT TX D {RT ( ) search{/NW E D pop /RT E D /WH NW SW pop D CW WH add LL gt {TX SC LK SC sub 1 sub NN GI GL{SH cF cS OC 2 copy cS ne E cF ne or{NF}{pop pop}ie}{PC /CW WH BW add D}ie /SC LK D} {GL{JC}if /CW CW WH add BW add D /HM t D}ie /GL f D /Ph f D /LK LK NW length 1 add add D}{pop exit}ie}loop /fin t D TX SC LK SC sub GI SH RT () ne{GL not{CC}if}if /LC TX length D /WH RT SW pop D CW WH add Hy{HC SW pop add}if LL gt {RT GL{SH cF cS OC 2 copy cS ne E cF ne or{NF}{pop pop}ie Hy{/Ph t D}if /LL LS D}{NL /LL LS D SH}ie} {RT PC Hy{CC}if /Ph Ph Hy or D}ie RT () ne{/GL t D /HM t D}if} {TX SW pop LL le{TX SH}{/NW () D 0 2 TX length 1 sub {/CW E D TX 0 CW GI dup SW pop LL gt{pop NW SH /HM t D NL/LL W XO sub MR sub D /CW CW 2 sub NN D /TX TX CW TX length CW sub GI D TX BS exit} {/NW E D}ie}for}ie}ie /HM t D}D /CC {C0 length 0 gt{JC}if /C0 [C1 L1 YA YB Mf NS NB TB AF Bw] D /C1 () D /L0 L1 D /YA 0 D /YB 0 D /Mf 0 D /NS 0 D /NB 0 D}D /JC {C0 aload length 0 gt{pop pop pop NB add /NB E D NS add /NS E D dup Mf gt{/Mf E D}{pop}ie dup YB gt{/YB E D}{pop}ie dup YA gt{/YA E D}{pop}ie pop C1 join /C1 E D /C0 [] D}if}D /OC {C0 length 0 gt{C1 L1 L0 sub YA YB Mf NS NB TB AF Bw GL C0 aload pop /Bw E D /AF E D /TB E D /NB E D /NS E D /Mf E D /YB E D /YA E D /C0 [] D /L1 E D /C1 E D Ph{HC SH}if NL /GL E D /Bw E D /AF E D /TB E D /NB E D /NS E D /Mf E D /YB E D /YA E D /L1 E D /LL W L1 sub XO sub MR sub WH sub D /CW 0 D C1 E join /C1 E D}if}D /BT {/LB t D dup length string copy RS dup dup () ne E ( ) ne and {/CI 0 D /LS LL D /LL W L1 sub XO sub MR sub D BS} {dup ( ) eq{/GL f D}if dup () eq L1 0 eq or{pop}{SH /BP f D /Ph f D}ie}ie /LB f D} D /BL {CP E pop XO E M} D /NL {JC /GL f D /SK W XO sub MR sub L1 sub TB{Bw add}if D /YA LF{Mf HM Fl not and PF or{LH mul}if}{0 /LF t D}ie YA 2 copy lt{E}if pop D C1 () ne{/FB YB Mf SA{Sf mul}if 4 div 2 copy lt{E}if pop D}if Fl{/Ya YA D}if CP E pop YA sub YB sub LE neg lt Fl not and PB not and{NP}if NT TL BL OU PF not and PB or{/RE L1 TB{Bw sub}if W XO sub MR sub div YA YB add LE BO add div 2 copy lt{E}if pop D RE 1 gt{BL 1 RE div dup scale}if}if AT 2 le{SK AT mul 2 div YA neg R}if AT 3 eq{0 YA neg R TB{/NB NB 1 sub D /NS NS 1 sub D}if /NB NB 1 sub NN D /A3 NS 6 mul NB add D NS NB add 0 eq {/A1 0 D /A2 0 D} {NS 0 eq{/A1 SK NB div dup J gt{pop 0}if D /A2 0 D}{J A3 mul SK lt {/A1 J D /A2 SK J NB mul sub NS div dup Ab gt{/A1 0 D pop 0}if D} {/A1 SK A3 div D /A2 A1 6 mul D}ie}ie}ie /A1 A1 NN D /A2 A2 NN D}if AT 4 eq{0 YA neg R PH 2 le{PD 0 lt{/PD L1 D}if PD M1 gt{/M1 PD D}if L1 PD sub M2 gt{/M2 L1 PD sub D}if}{DV ID 1 sub get 0 ge{Lo 0 R}if}ie}if F0 cF ne Cs cS ne or{F0 Cs NF}if /ms Ms D /Ms f D CP FB sub C1 cvx exec XO EO sub L1 add TB{BW sub}if dup LM gt{/LM E D}{pop}ie PH 0 eq PH 4 eq or Ms and{HF not{/PO t D /AH t D}if BB CP YA add E AT 3 eq LB and{A1 sub}if TB{BW sub}if E BB} {pop pop}ie Ms HM PH 3 eq and or{/BP f D /Fl f D}if /Lo 0 D /L1 0 D /F0 cF D /Cs cS D BP not{0 YB NN neg R}if OU f1 and mF not and{k2 /f1 f D}if OU PF not and PB or{RE 1 gt{RE dup scale}if}if /Ms ms Ms or D /C1 AF{(Cp )}{()}ie D /YA 0 D /YB 0 D BL AT 4 eq LB not and PH 3 ge and {ID DV length lt{DV ID get dup 0 ge{DO E sub /Lo E D /L1 Lo D}{pop}ie /ID ID 1 add D}if}if /T t D CD{/LN LN 1 add D PD}if /PD -1 D /NS 0 D /NB 0 D /TB f D /Ph f D /Mf 0 D /HM f D} D /RS {/TM E D /CN 0 D TM{10 eq{TM CN ( ) PI}if /CN CN 1 add D}forall /CN 0 D /BK HM EN and{0}{1}ie D TM {dup 32 ne{TM CN 3 2 roll put /CN CN 1 add D /BK 0 D} {pop BK 0 eq{TM CN 32 put /CN CN 1 add D}if /BK 1 D}ie}forall TM 0 CN GI dup dup () ne E ( ) ne and {dup CN 1 sub get 32 eq{/EN f D}{/EN t D}ie}if} D /join {2 copy length E length add string dup 4 2 roll 2 index 0 3 index PI E length E PI}d /WR {(\n) search{dup () ne BP not or {Li 4 le CP E pop YI Li mul add LE add 0 lt and PL 0 eq and{NP}if SH NL pop /Li Li 1 sub D WR}{pop pop WR}ie}{SH}ie /CI 0 D /BP f D} D /SH {dup dup () ne E ( ) ne and PF or CS Mf gt and{/Mf CS D}if T not Wf and{( ) E join /T t D}if dup BP{/MF CS D}if AT 3 eq{2 copy length dup 0 gt{/NB E NB add D {( ) search{/NS NS 1 add D pop pop}{pop exit}ie}loop}{pop pop}ie}if CD PD 0 lt and{dup DC search{SW pop /PD E L1 add D pop pop}{pop}ie}if 0 Np dup SW pop L1 add /L1 E D dup () ne {C1 (\() join E join (\)) join AU AF and UF or Wf and{( U ) join}if sF{( s ) join}if ( S ) join /C1 E D dup length 1 sub get 32 eq /TB E D /Bw BW D}{pop pop}ie} D /BG {AI LG BC add add 0 eq} D /ON {OU{Ty AR AI NN get dup 1 add Ln Ns Ty 2 mod 0 eq{(. )}{(\) )}ie join dup SW pop neg 0 R CP E 0 lt{0 E M}{pop}ie CP BB show /Ms t D}if} D /Ln {AR AI 3 -1 roll put}D /SP {dup CI lt BP not and{dup CI sub 0 E R /CI E D}{pop}ie} D /BN {PF{WR /HM f D}{BT NL}ie} D /NN {dup 0 lt{pop 0}if} D /h {(h) HI ST cvs join cvx exec dup 1 get E Nf{0 get E join}{pop}ie} D /H {/fn FN D /Hi E 1 add D 1 sub /HL E D /H2 HL 2 add D /GS EZ H2 get D E Tm H2 get GS mul BE dup 0 gt{1 sub}{pop EG H2 get dup 0 lt{pop AT}if}ie NA WW Np /SL SL 1 add D /FN EF H2 get D GS Ey H2 get FS EU H2 get Sc Hs not HL Hl lt and Hs HL hl lt and or Hi 0 eq or {/HI Hi D /Hs t D /hl HL D /Hv HL D}if HL Hl lt{/hi Hi D}if Nf HI 0 gt and{(h) Hi ST cvs join cvx exec 0 get WB}if /HF t D /AH f D /PO f D} D /EH {Bm H2 get GS mul BE OA /SL SL 1 sub NN D /CF 0 D /FN fn D SZ SL get FR SL get FS /HF f D /GS Ts D ()Ec} D /P {E PF{WR}{PO{EP}{BN}ie Ts 4 mul Np AE not{Tm 0 get Ts mul neg SP}if dup 0 ge AH and{Pi Pd}if}ie 1 sub dup 0 lt{pop AV AL get}if /AT E D /PO t D} D /EP {PF{WR}{BN Ts 4 mul Np}ie AE not{Bm 0 get Ts mul neg SP}if /AT AV AL get D /PO f D} D /BE {E PO{EP}{BN}ie Ts 4 mul Np neg SP} D /HR {/Aw W EO sub D /RW E dup 0 gt{Aw mul}{neg}ie dup Aw gt{pop Aw}if D /RZ E D E BN Ts neg SP 1 sub 2 div Aw RW sub mul EO add CP E pop M PF{0 Ps neg R}if 0 Np OU{gsave RZ LW Cf{Hc VC}{0 Sg}ie CP BB RW 0 RL CP BB stroke grestore}if /CI 0 D /BP f D PF not{Ts neg SP}if /Ms t D} D /AD {I NL EG 14 get dup 0 lt{pop AT}if NA /AE t D Tm 14 get Ts mul neg SP Cf{EU 14 get dup -1 eq{pop CA CL get}if Sc}if} D /DA {BN ()ES OA /AE f D ()Ec Bm 14 get Ts mul neg SP} D /PR {/MW E D /Li E D Tm 1 get Ps mul BE 0 NA /FN Fp D /PF t D SI /SL SL 1 add D /CF 0 D Ps CS mul Ts div MW WC mul CS mul Ts div dup LL gt PL 0 eq and {LL div div}{pop}ie Ey 1 get FS CP E pop LE add YI neg div cvi dup Li lt AH and{4 lt YI Li mul 5 mul LE add 0 gt or PL 0 eq and{NP}if}{pop}ie EU 1 get Sc /GS Ps D}D /RP {WR NL () /PF f D SI /FN 0 D ES Bm 1 get Ps mul neg SP OA /GS Ts D} D /SI {/XO Lm 15 get BC NN mul Lm 16 get AI UI sub NN mul add Lm 17 get UI NN mul add Lm 20 get LG NN mul add Ts mul PF{Lm 1 get Ps mul add}if EO add D /MR Rm 15 get BC NN mul Rm 16 get AI UI sub NN mul add Rm 17 get UI NN mul add Rm 20 get LG NN mul add Ts mul PF{Rm 1 get Ps mul add}if D /LL W XO sub MR sub D} D /DT {/cC E D BN /LG LG 1 sub D SI /LG LG 1 add D WW 2 div Np BL} D /DD {WB Cc 0 eq cC 0 eq and L1 0 eq or Lm 20 get Ts mul L1 sub TB{BW add}if Ts 2 div lt or NL /LF E D SI BL /cC 0 D} D /DL {Dc LG Cc put /Cc E D BG{Tm 18 get Ts mul BE}{BN}ie /LG LG 1 add D BL} D /LD {BN LG 0 gt{/LG LG 1 sub D}if /Cc Dc LG get D SI BG{()Bm 18 get Ts mul BE}if BL} D /UL {BG{Tm 17 get Ts mul BE}{BN}ie NR AI NN 0 put /UI UI 1 add D /AI AI 1 add D SI BL} D /LU {BN /UI UI 1 sub D /AI AI 1 sub D SI BG{()Bm 17 get Ts mul BE}if BL} D /OL {E BG{Tm 16 get Ts mul BE}{BN}ie TR AI NN Ty put /Ty E D NR AI NN 1 put /AI AI 1 add D SI BL 1 Ln} D /LO {BN /AI AI 1 sub D /Ty TR AI get D SI BG{()Bm 16 get Ts mul BE}if BL} D /LI {E BN -1 SP /BP f D /CI 0 D 0 Np NR AI 1 sub NN get 1 eq {dup dup 0 gt E 4 le and{/Ty E D}{pop}ie /L1 L1 Ty AR AI NN get Ns SW pop XO sub dup 0 lt{pop 0}if add D ( ON )} {pop ( B )}ie C1 E join /C1 E D CS Mf gt{/Mf CS D}if BL} D /BQ {Tm 15 get Ts mul BE /BC BC 1 add D SI BL} D /QB {Bm 15 get Ts mul BE /BC BC 1 sub D SI BL} D /Al {E EP 1 sub dup 0 lt{pop AV AL get}if NA} D /Ea {EP OA} D /WB {PF{WR}{BT}ie} D /F1 {WB /FN 0 D CS 0 FS} D /F2 {WB /FN WI D CS 0 FS} D /HY {/Hy t D WB /Hy f D} D /YH {WB} D /A {/LT E D LT 1 eq{/RN E D}if /Lh E D WB /C1 C1 ( Cp ) join D Lc AF not and{Cl Sc}if /AF t D} D /EA {Lc AF and{Ec}{WB}ie TL Pa AF and Lh 0 ne and {( \() Lh join (\)) join /AF f D WB}if /AF f D} D /TL {C1 ( Tl ) apa /C1 E D} d /apa {AF OU and Lh 0 ne LT 1 eq or and{LT 1 eq{RN ( /) E ST cvs join} {(\() Lh join (\)) join}ie E join join}{pop}ie} d /Cp {/Xc CP /Yc E D D} D /SS {Cf{dup 0 ge{EU E get dup -1 eq{pop CA CL get}if}{pop CA CL get}ie Sc} {pop}ie SZ SL get /SL SL 1 add D} D /I {WB 8 SS 1 FS} D /EM {WB 8 SS /CF CF 1 xor D 0 FS} D /BD {WB 9 SS 2 FS} D /TT {WB 10 SS /FN Fp D 0 FS} D /KB {WB 11 SS /FN Fp D 2 FS} D /CT {WB 12 SS 1 FS} D /SM {WB 13 SS /FN Fp D 0 FS} D /Q {/QL QL 1 add D QO QL 2 mod get La get join WB} D /EQ {QC QL 2 mod get La get join WB /QL QL 1 sub D} D /RO {WB -1 SS /CF 0 D 0 FS} D /SY {WB -1 SS -1 FS} D /MY {WB -1 SS -2 FS} D /ES {WB /SL SL 1 sub NN D /CF 0 D /FN FO SL get D SZ SL get FR SL get FS ()Ec}D /FZ {3 sub 1.2 E exp GS mul E WB TL /C1 C1 ( Cp ) join D /SL SL 1 add D 0 FS} D /Ef {WB TL ()ES /C1 C1 ( Cp ) join D} D /BZ {dup /Bf E D FZ}D /Sc {dup -1 ne Cf and{/CL CL 1 add D dup 0 eq{pop [0 0 0]}if dup CA E CL E put VS ( VC ) join C1 E join /C1 E D}{pop}ie} D /Ec {WB Cf{/CL CL 1 sub NN D CA CL get VS ( VC ) join C1 E join /C1 E D}if} D /VS {dup type /arraytype eq{([) E {ST cvs join ( ) join}forall (]) join}if} D /VC {{255 div}forall setrgbcolor} D /Sl {dup type /integertype ne{Ds}if /La E D WB}d /UN {WB /UF t D} D /NU {WB /UF f D} D /SE {WB /sF t D} D /XE {WB /sF f D} D /sM {/C1 C1 ( k1 ) join D}d /eM {/C1 C1 ( k2 ) join D}d /k1 {/YC CP E pop Ts add D /mF t D /f1 t D}d /k2 {gsave 3 LW -9 CP E pop Ts 0.2 mul sub M -9 YC L stroke grestore /mF f D}d /Ac {/AC E D WB}d /Ca {eA{( \()join AC join(\) )join}if WB}d /s {OU{gsave 0 CS .25 mul R dup SW pop CJ 0 RL stroke grestore}if}D /CJ {AT 3 eq LB and{E dup dup length 1 sub A1 mul E {( ) search{pop pop E A2 add E}{pop exit}ie}loop 3 -1 roll add W CP pop sub 2 copy gt{E}if pop}if}D /So {/Co E D} D /SO {C1 Yo ST cvs join ( So ) join /C1 E D (j) SW pop 2 div Pd} D /Se {E WB CS E div Pd}D /Pd {dup type /stringtype eq{SW pop}if dup /L1 E L1 add D ST cvs ( 0 R ) join C1 E join /C1 E D} D /Sp {0.35 CO} D /Sb {-0.2 CO} D /CO {OV Io Yo put /Yo E CS mul Yo add D /Io Io 1 add D -1.5 Io mul 3 add FZ SO CS Yo add dup YA gt{/YA E D}{pop}ie Yo neg dup YB gt{/YB E D}{pop}ie} D /Es {ES /Io Io 1 sub NN D /Yo OV Io get D SO} D /SB {/N2 0 D 0 1 NI{/N E D{IX N2 get 0 lt{/N2 N2 1 add D}{exit}ie}loop /K WS N get FC N get mul D /NY AY N2 get D /BV NY array D 0 1 NY 1 sub{/TM K string D currentfile TM readhexstring pop pop BV E TM put} for BM N BV put /N2 N2 1 add D}for} D /IC [{/MA E D /MB 0 D}{2 div /MA E D /MB MA D}{/MB E CS sub D /MA CS D} {pop /MA YS AB mul D /MB 1 AB sub YS mul D}{pop /MA 0 D /MB 0 D}] D /IP {BV N get /N N 1 add D} D /II {/K E D IX K get 0 lt{/EC E D}if /TY E D TY 4 eq{/Y E D /X E D}if TY 3 eq{/AB E D}if /XW AX K get D /YW AY K get D /IS SG IT K get get D /XS XW IS mul D /YS YW IS mul D YS IC TY get exec /MA MA Fl not{3 add}if D} D /IM {II /ty TY D /xs XS D /ys YS D /ya YA D /yb YB D /ma MA D /mb MB D /k K D /ec EC D /BP f D /CI 0 D WB TL L1 xs add dup XO add MR add W gt {pop /ma ma Fl{3 add}if D NL /YA ma D /YB mb D /YS ys D /L1 xs D} {/L1 E D ma YA gt{/YA ma D}if mb YB gt{/YB mb D}if}ie /TB f D OU{CP E pop YS sub LE neg lt Fl not and PB not and{NP /YA ma D /YB mb D}if /BP f D ty ST cvs ( ) join IX k get 0 lt{(\() join ec join (\) ) join}if k ST cvs join ty 3 eq{AB ST cvs ( ) join E join}if ty 4 eq{X ST cvs ( ) join Y ST cvs join ( ) join E join}if C1 E join ( DI ) join FP 2 eq FP 1 eq AF and or{( FM ) join}if ( Il Cp ) apa /C1 E D /EN f D}if /HM t D /T f D} D /DI {II /Xc CP /Yc E D D /YN YW neg D /HM t D /CI 0 D /K2 IX K get D gsave TY 4 eq{OX X IS mul add OY FY add YS sub Y IS mul sub} {/FY YS D CP MB sub 2 copy /OY E D /OX E D}ie translate K2 0 ge{/DP AZ K2 get D /BV BM K2 get D XS YS scale /N 0 D XW YW DP [XW 0 0 YN 0 YW] {IP} FC K2 get 1 eq{image}{f 3 colorimage}ie} {EX}ie grestore XS 0 R /Ms t D} D /FM {gsave 0 Sg CP MB sub translate XS neg 0 M 0 YS RL XS 0 RL 0 YS neg RL XS neg 0 RL stroke grestore} D /NA {/AT E D /AL AL 1 add D AV AL AT put} D /OA {AL 0 gt{/AL AL 1 sub D /AT AV AL get D}if} D /D1 {/BR {CP E pop E BN Mb{CP E pop eq{0 YI R}if}{pop}ie} D /Sn {OU{C1 E ST cvs join ( Ld ) join /C1 E D}{pop}ie} D} D /D1 {/BR {BN} D /Sn {OU {C1 E ST cvs join ( Ld ) join /C1 E D} {pop} ie} D} D /TC {/TF t D /ML 0 D HN{SW pop dup ML gt{/ML E D}{pop}ie}forall NP /RM RM not D RC /OU Tc D Ep /PN 0 D Ms not TP and{Ip}if /W IW ML sub Ts sub D /A0 0 D TH{/BR {( ) join BT} D /Sn {pop} D /Au () D}if} D /TN {0 eq{E EA PF HF or not XR and{HN E get Xr}{pop}ie} {OU{Tn 0 ge{() BN}if /Tn E D}{pop}ie WB}ie} D /NT {OU LB not and Tn 0 ge and{PL 0 eq{Ms not{CS CF FS}if CP dup /y E YA sub D W 9 sub CS -1.8 mul XO L1 add 2 add{y M (.) show}for HN Tn get dup SW pop IW E sub y M show CP BB M}if /Tn -1 D}if} D /Ld {/DN E D HN DN Pn put [/View [/XYZ -4 Fl{PS}{CP YA add US E pop}ie null] /Dest DN ST cvs cvn /DEST pdfmark} D /C {ND 1 eq{1 sub}if TI mul /XO E D NL Nf not{pop()}if 0 3 -1 roll 1 A} D /OP {BP not{NP}if PN 2 mod 0 eq{/Ms t D NP}if}D /Ep {Xp PN 2 mod 0 eq and OU and{/Pn (-) D showpage /PM 1 D LA}if}D /Dg [73 86 88 76 67 68 77] D /Rd [0 [1 1 0][2 1 0][3 1 0][2 1 1][1 1 1][2 2 1][3 3 1][4 4 1][2 1 2]] D /Ns {/m E D /c E 32 mul D /j m 1000 idiv D /p j 12 add string D c 96 le m 0 gt and{c 32 le {/i 0 D /d 77 D /l 100 D /m m j 1000 mul sub D j -1 1 {pop p i d c add put /i i 1 add D}for 4 -2 0 {/j E D /n m l idiv D /m m n l mul sub D /d Dg j get D n 0 gt {/x Rd n get D x 0 get -1 1 {pop p i d c add put /i i 1 add D}for p i x 1 get sub Dg x 2 get j add get c add put}if /l l 10 idiv D }for p 0 i GI} {/i ST length 1 sub D m {1 sub dup 0 ge{dup 26 mod c add 1 add ST i 3 -1 roll put 26 idiv dup 0 eq{pop exit}if}if /i i 1 sub D}loop ST i ST length i sub GI}ie} {m p cvs}ie} D /US {matrix currentmatrix matrix defaultmatrix matrix invertmatrix matrix concatmatrix transform} D /GB {Gb{US}if}D /Tl {/Rn E D Xc CP pop ne{ [/Rect [Xc 1 sub Yc cS 0.25 mul sub GB CP E 1 add E cS 0.85 mul add GB] /Subtype /Link /Border [0 0 Cf Lc and LX and AU or{0}{1}ie] Rn type /nametype eq {/Dest Rn}{/Action [/Subtype /URI /URI Rn] Cd}ie /ANN pdfmark}if} D /Il {/Rn E D [/Rect [Xc Yc GB Xc XS add Yc YS add GB] /Subtype /Link /Border [0 0 0] Rn type /nametype eq{/Dest Rn} {/Action [/Subtype /URI /URI Rn] Cd}ie /ANN pdfmark} D /XP {[{/Z Bz 2 div D Z 0 R Z Z RL Z neg Z RL Z neg Z neg RL Z Z neg RL Fi cH 1 eq and{fill}if} {Bz 0 RL 0 Bz RL Bz neg 0 RL 0 Bz neg RL Fi cH 1 eq and{fill}if} {0 -5 R Bz 0 RL 0 21 RL Bz neg 0 RL 0 -21 RL}]} D /MS {/Sm E D WB}D /O {BN()Sm BX} D /O {BN()0 Sm BX} D /BX {/Bt E D Bt 2 lt{/Ch E D CS 0.8 mul}{11 mul}ie W XO sub MR sub 2 copy gt{E}if pop /HZ E D Bt 2 eq{Fi not{pop()}if ( )E join /Ft E D TT /PF t D /MW 1 D /Li 1 D /Fw Ft SW pop D Fw HZ gt{/HZ Fw 8 add D}if HZ ST cvs( )join}{WB Ch ST cvs( )join}ie L1 HZ add XO add MR add W gt{NL}if Bt 2 eq{Ft ES Fw neg HM{CS sub}if Pd}if Bt ST cvs join( Bx )join Bt 2 eq HM and{CS Pd}if C1 E join /C1 E D /L1 L1 HZ add D /T f D ( ) Pd /PF f D Bt 2 lt{YA CS .8 mul lt{/YA CS .8 mul D}if} {YB 5 lt{/YB 5 D}if YA 21 lt{/YA 21 D}if}ie /CI 0 D} D /Bx {dup 2 eq{E /Bz E D}{E /cH E D /Bz CS .8 mul D}ie OU {gsave 0 Sg XP E get exec stroke grestore}{pop}ie Bz 0 R /Ms t D}D /SD {FD 4 mul Dy add DZ NF newpath 0 0 M DX t charpath pathbbox 3 -1 roll sub /DY E D E dup /X1 E D sub WM mul WX DY mul add WM DG mul E div /DF E D /DR WX DF mul DY mul WM div 2 div D} d /Sd {gsave 0 IL Di mul neg translate IL IW atan Di 0 eq{neg}if rotate FD 4 mul Dy add DZ NF DR X1 sub DY 2 div neg M cD VC DX show grestore} d /Pt {/tp t D Tp{NP /Pn (TP) D 0 Tt neg R Th BN NP Ep ET RC ZF}if /tp f D} D /RC {/AI 0 D /LG 0 D /BC 0 D /UI 0 D /PF f D /Cc 0 D /cC 0 D /Dc 10 array D /NR [0 1 9{pop 0}for] D /La Ds D /AR 10 array D /TR 10 array D /AV 30 array D SI /AL -1 D /AT A0 D AT NA /OV 9 array D /Yo 0 D /Co 0 D /Io 0 D /Hy f D /Ph f D /CL -1 D Ct Sc}D /ZF {/FR [0 1 30{pop 0}for] D /SZ [0 1 30{pop 0}for] D /FO [0 1 30{pop 0}for] D /SL 0 D /CF 0 D /FN 0 D 0 Ts SF}D /QO [[(\234)(\233)(\253\240)(\232)(\273)(\253)][(')(`)(\253\240)(\231)(\273)(\253)]] D /QC [[(\234)(\234)(\240\273)(\233)(\253)(\273)][(')(')(\240\273)(`)(\253)(\273)]] D /Hf EF length 2 sub D /Hz EZ Hf get D /HS Ey Hf get D /Fz EZ Hf 1 add get D /Fs Ey Hf 1 add get D /LE IL D /Ps EZ 1 get D /Fp EF 1 get D /XO 0 D /YI 0 D /CI 0 D /FP 0 D /WW Ts 7 mul D /Mf 0 D /YA 0 D /YB 0 D /Cs Ts D /GS Ts D /F0 0 D /NS 0 D /NB 0 D /N 0 D /C0 [] D /C1 () D /Lo 0 D /L1 0 D /LM 0 D /PH 0 D /EC 0 D /Lh 0 D /LT 0 D /CH 1 string D /ST 16 string D /CA 9 array D /HC (\255) D /HM f D /PF f D /EN f D /TB f D /UF f D /sF f D /AE f D /AF f D /BP t D /CD f D /PA t D /GL f D /T t D /HF f D /AH f D /SA f D /PB f D /f1 f D /mF f D /OX 0 D /OY 0 D /FY 0 D /EO 0 D /FB 0 D /PL 0 D /Bw 0 D /PD -1 D /TP f D /tp f D /TH f D /Ty 4 D /Tn -1 D /Fl t D /LB t D /PM 1 D /Ms f D /Ba f D /Bb f D /Hl 3 D /hl 6 D /Hv 6 D /Hs f D /HI 0 D /hi 0 D /PO t D /TE f D /LF t D /BO 0 D /Sm 1 D /Bf 3 D /A1 0 D /A2 0 D /Ds 1 D /QL -1 D /Cb Db D /Ct Dt D /Cl Dl D [/Creator (html2ps version 1.0 beta5) /Author () /Keywords () /Subject () /Title (The XPA Help Facility) /DOCINFO pdfmark /ND 22 D /HN [(1) (1) (1) (3) (5) (8) (10) (14) (15) (16) (15) (16) (17) (19) (22) (25) (26) (29) (30) (30) (31) (32) (32) (33) (34) (34) (35) (37) (38) (46) (46) (39) (40) (42) (43) (44) (47) (48) (50) (51) (55) (61) (63) (75) (76) (77) (80) (1) (1) (1) (2) (1) (??) (??) (1) (1) (1) (2) (3) (3) (3) (3) (4) (5) (5) (5) (5) (7) (8) (8) (8) (8) (9) (10) (10) (10) (10) (10) (11) (12) (13) (14) (14) (14) (14) (14) (15) (15) (15) (16) (16) (17) (18) (19) (19) (19) (19) (20) (21) (22) (22) (22) (24) (25) (25) (33) (25) (25) (25) (25) (26) (29) (30) (30) (31) (32) (32) (33) (33) (34) (34) (35) (36) (37) (37) (37) (37) (37) (38) (38) (38) (38) (38) (38) (39) (40) (42) (43) (44) (46) (46) (47) (48) (49) (50) (50) (50) (50) (50) (51) (53) (51) (51) (51) (51) (51) (52) (53) (54) (55) (55) (55) (55) (60) (61) (61) (61) (61) (62) (63) (63) (63) (63) (63) (63) (64) (64) (64) (65) (65) (66) (67) (67) (67) (68) (68) (68) (68) (69) (69) (69) (70) (70) (70) (70) (70) (71) (71) (71) (71) (72) (72) (73) (73) (73) (74) (74) (74) (74) (75) (75) (75) (75) (75) (76) (76) (76) (76) (76) (77) (77) (77) (77) (79) (80) (80) (80) (80) (80)] D /h0 [()(Table of Contents)] D /h1 [(0.1\240\240)(XPA: Public Access to Data and Algorithms)] D /h2 [(0.2\240\240)(Summary)] D /h3 [(0.3\240\240)(Description)] D /h4 [(0.3.0.0.1\240\240)(Last updated: September 10, 2003)] D /h5 [(0.4\240\240)(XPAIntro: Introduction to the XPA Messaging System)] D /h6 [(0.5\240\240)(Summary)] D /h7 [(0.6\240\240)(Description)] D /h8 [(0.6.0.0.1\240\240)(Last updated: March 10, 2007)] D /h9 [(0.7\240\240)(XPATemplate: Access Point Names and Templates)] D /h10 [(0.8\240\240)(Summary)] D /h11 [(0.9\240\240)(Description)] D /h12 [(0.9.0.0.1\240\240)(Last updated: September 10, 2003)] D /h13 [(0.10\240\240)(XPACommon: Getting Common Information About Access Points)] D /h14 [(0.11\240\240)(Summary)] D /h15 [(0.12\240\240)(Description)] D /h16 [(0.12.0.0.1\240\240)(Last updated: September 10, 2003)] D /h17 [(0.13\240\240)(XPAMethod: XPA Communication Methods)] D /h18 [(0.14\240\240)(Summary)] D /h19 [(0.15\240\240)(Description)] D /h20 [(0.15.0.0.1\240\240)(Last updated: September 10, 2003)] D /h21 [(0.16\240\240)(XPAInet: XPA Communication Between Hosts)] D /h22 [(0.17\240\240)(Summary)] D /h23 [(0.18\240\240)(Description)] D /h24 [(0.19\240\240)(Manual Registration)] D /h25 [(0.20\240\240)(Remote Registration)] D /h26 [(0.21\240\240)(XPANS Proxy Registration)] D /h27 [(0.21.0.0.1\240\240)(Last updated: September 10, 2003)] D /h28 [(0.22\240\240)(XPAUsers: Distinguishing Users)] D /h29 [(0.23\240\240)(Summary)] D /h30 [(0.24\240\240)(Description)] D /h31 [(0.24.0.0.1\240\240)(Last updated: September 10, 2003)] D /h32 [(0.25\240\240)(XPA Programs)] D /h33 [(0.26\240\240)(Summary)] D /h34 [(0.27\240\240)(xpaset: send data to one or more XPA servers)] D /h35 [(0.28\240\240)(xpaget: retrieve data from one or more XPA servers)] D /h36 [(0.29\240\240)(xpainfo: send short message to one or more XPA servers)] D /h37 [(0.30\240\240)(xpaaccess: see if template matches registered XPA access points)] D /h38 [(0.30.0.0.1\240\240)(Last updated: September 10, 2003)] D /h39 [(0.31\240\240)(xpamb: the XPA Message Bus)] D /h40 [(0.32\240\240)(Summary)] D /h41 [(0.33\240\240)(Description)] D /h42 [(0.34\240\240)(Options)] D /h43 [(0.34.0.0.1\240\240)(Last updated: September 10, 2003)] D /h44 [(0.35\240\240)(xpans: the XPA Name Server)] D /h45 [(0.36\240\240)(Summary)] D /h46 [(0.36.0.0.1\240\240)(Last updated: January 24, 2005)] D /h47 [(0.37\240\240)(XPAServer: The XPA Server-side Programming Interface)] D /h48 [(0.38\240\240)(Summary)] D /h49 [(0.39\240\240)(Introduction to XPA Server Programming)] D /h50 [(0.40\240\240)(Introduction)] D /h51 [(0.41\240\240)(XPANew: create a new XPA access point)] D /h52 [(0.42\240\240)(XPACmdNew: create a new XPA public access point for commands)] D /h53 [(0.43\240\240)(XPACmdAdd: add a command to an XPA command public access point)] D /h54 [(0.44\240\240)(XPACmdDel: remove a command from an XPA command public access point)] D /h55 [(0.45\240\240)(XPAInfoNew: define an XPA info public access point)] D /h56 [(0.46\240\240)(XPAFree: remove an XPA public access point)] D /h57 [(0.47\240\240)(XPAMainLoop: optional main loop for XPA)] D /h58 [(0.48\240\240)(XPAPoll: execute existing XPA requests)] D /h59 [(0.49\240\240)(XPAAtExit: install exit handler)] D /h60 [(0.50\240\240)(XPACleanup: release reserved XPA memory)] D /h61 [(0.51\240\240)(XPA Server Callback Macros)] D /h62 [(0.52\240\240)(XPA Race Conditions)] D /h63 [(0.52.0.0.1\240\240)(Last updated: September 10, 2003)] D /h64 [(0.53\240\240)(Xpaoom: What happens when XPA runs out of memory?)] D /h65 [(0.54\240\240)(Summary)] D /h66 [(0.55\240\240)(Description)] D /h67 [(0.55.0.0.1\240\240)(Last updated: April 7, 2009)] D /h68 [(0.56\240\240)(XPAClient: The XPA Client-side Programming Interface)] D /h69 [(0.57\240\240)(Summary)] D /h70 [(0.58\240\240)(Introduction to XPA Client Programming)] D /h71 [(0.59\240\240)(Introduction)] D /h72 [(0.60\240\240)(XPAGet: retrieve data from one or more XPA servers)] D /h73 [(0.61\240\240)(XPASet: send data to one or more XPA servers)] D /h74 [(0.62\240\240)(XPAInfo: send short message to one or more XPA servers)] D /h75 [(0.63\240\240)(XPAGetFd: retrieve data from one or more XPA servers and write to files)] D /h76 [(0.64\240\240)(XPASetFd: send data from stdin to one or more XPA servers)] D /h77 [(0.65\240\240)(XPAOpen: allocate a persistent client handle)] D /h78 [(0.66\240\240)(XPAClose: close a persistent XPA client handle)] D /h79 [(0.67\240\240)(XPANSLookup: lookup registered XPA access points)] D /h80 [(0.68\240\240)(XPAAccess: return XPA access points matching template \(XPA 2.1 and above\))] D /h81 [(0.68.0.0.1\240\240)(Last updated: March 10, 2007)] D /h82 [(0.69\240\240)(XPAXt: the XPA Interface to Xt \(X Windows\))] D /h83 [(0.70\240\240)(Summary)] D /h84 [(0.71\240\240)(Description)] D /h85 [(0.71.0.0.1\240\240)(Last updated: September 10, 2003)] D /h86 [(0.72\240\240)(XPATcl: the XPA Interface to the Tcl/Tk Environment)] D /h87 [(0.73\240\240)(Summary)] D /h88 [(0.74\240\240)(Server Routines)] D /h89 [(0.75\240\240)(Client Routines)] D /h90 [(0.76\240\240)(Description)] D /h91 [(0.77\240\240)(XPANew)] D /h92 [(0.78\240\240)(XPARec)] D /h93 [(0.78.0.0.1\240\240)(Last updated: September 10, 2003)] D /h94 [(0.79\240\240)(XPAEnv: Environment Variables for XPA Messaging)] D /h95 [(0.80\240\240)(Summary)] D /h96 [(0.81\240\240)(Description)] D /h97 [(0.81.0.0.1\240\240)(Last updated: December 23, 2009)] D /h98 [(0.82\240\240)(XPAAcl: Access Control for XPA Messaging)] D /h99 [(0.83\240\240)(Summary)] D /h100 [(0.84\240\240)(Description)] D /h101 [(0.84.0.0.1\240\240)(Last updated: September 10, 2003)] D /h102 [(0.85\240\240)(XPA ChangeLog)] D /h103 [(0.86\240\240)(Public Release 2.1.15 \(July 23, 2013\))] D /h104 [(0.87\240\240)(Public Release 2.1.14 \(June 7, 2012\))] D /h105 [(0.88\240\240)(Public Release 2.1.13 \(April 14, 2011\))] D /h106 [(0.89\240\240)(Public Release 2.1.12 \(January 26, 2010\))] D /h107 [(0.90\240\240)(Public Release 2.1.11 \(December 7, 2009\))] D /h108 [(0.91\240\240)(Public Release 2.1.10 \(September 1, 2009\))] D /h109 [(0.92\240\240)(Internal Release 2.1.9)] D /h110 [(0.93\240\240)(Public Release 2.1.8 \(1 November 2007\))] D /h111 [(0.94\240\240)(Patch Release 2.1.7b[1,2] \(Feb 22, 2006; March 8, 2007\))] D /h112 [(0.95\240\240)(Patch Release 2.1.6 \(4 May 2005\))] D /h113 [(0.96\240\240)(Patch Release 2.1.5 \(12 January 2004\))] D /h114 [(0.97\240\240)(Patch Release 2.1.4 \(24 March 2003\))] D /h115 [(0.98\240\240)(Patch Release 2.1.3 \(26 September 2002\))] D /h116 [(0.99\240\240)(Patch Release 2.1.2 \(18 July 2002\))] D /h117 [(0.100\240\240)(Patch Release 2.1.1 \(20 June 2002\))] D /h118 [(0.101\240\240)(Public Release 2.1.0 \(22 April 2002\))] D /h119 [(0.102\240\240)(Pre-Release 2.1.0e \(2 April 2002\))] D /h120 [(0.103\240\240)(Pre-Release 2.1.0e \(1 April 2002\))] D /h121 [(0.104\240\240)(Pre-Release 2.1.0e \(25 March 2002\))] D /h122 [(0.105\240\240)(Pre-Release 2.1.0e \(19 March 2002\))] D /h123 [(0.106\240\240)(Pre-Release 2.1.0e \(14 February 2002\))] D /h124 [(0.107\240\240)(Pre-Release 2.1.0e \(11 February 2002\))] D /h125 [(0.108\240\240)(Beta Release 2.1.0b10 \(31 January 2002\))] D /h126 [(0.109\240\240)(Beta Release 2.1.0b9 \(26 January 2002\))] D /h127 [(0.110\240\240)(Beta Release 2.1.0b8 \(4 January 2002\))] D /h128 [(0.111\240\240)(Beta Release 2.1.0b7 \(21 December 2001\))] D /h129 [(0.112\240\240)(Beta Release 2.1.0b6 \(29 October 2001\))] D /h130 [(0.113\240\240)(Beta Release 2.1.0b5 \(22 October 2001\))] D /h131 [(0.114\240\240)(Beta Release 2.1.0b4 \(24 September 2001\))] D /h132 [(0.115\240\240)(Beta Release 2.1.0b3 \(6 September 2001\))] D /h133 [(0.116\240\240)(Beta Release 2.1.0b2 \(17 August 2001\))] D /h134 [(0.117\240\240)(Beta Release 2.1.0b1 \(6 August 2001\))] D /h135 [(0.118\240\240)(Patch Release 2.0.5 \(10 November 2000\))] D /h136 [(0.119\240\240)(Patch Release 2.0.4 \(20 September 2000\))] D /h137 [(0.120\240\240)(Patch Release 2.0.3 \(15 June 2000\))] D /h138 [(0.121\240\240)(Patch Release 2.0.2 \(9 September 1999\))] D /h139 [(0.122\240\240)(Patch Release 2.0.1 \(6 August 1999\))] D /h140 [(0.123\240\240)(Public Release 2.0 \(27 May 1999\))] D /h141 [(0.123.0.0.1\240\240)(Last updated: 22 April 2002)] D /h142 [(0.124\240\240)(XPACode: Where to Find Example/Test Code)] D /h143 [(0.125\240\240)(Summary)] D /h144 [(0.126\240\240)(Description)] D /h145 [(0.126.0.0.1\240\240)(Last updated: September 10, 2003)] D /h146 [(0.127\240\240)(XPA Changes: Changes For Users from XPA 1.0 and 2.0)] D /h147 [(0.128\240\240)(Summary)] D /h148 [(0.129\240\240)(Description)] D /h149 [(0.129.0.0.1\240\240)(Last updated: September 10, 2003)] D /h150 [(0.130\240\240)(XPAConvert: Converting the XPA API to 2.0)] D /h151 [(0.131\240\240)(Summary)] D /h152 [(0.132\240\240)(Description)] D /h153 [(0.132.0.0.1\240\240)(Last updated: September 10, 2003)] D /h154 [(0.133\240\240)(XPAName: What does XPA stand for?)] D /h155 [(0.134\240\240)(Summary)] D /h156 [(0.135\240\240)(Description)] D /h157 [(0.135.0.0.1\240\240)(Last updated: September 10, 2003)] D /Hr [-47 47 48 49 -50 -50 50 -54 54 55 56 -57 -57 57 -59 59 60 61 -62 -62 62 -64 64 65 66 -67 -67 67 -69 69 70 71 -72 -72 72 -74 74 75 76 77 78 79 -80 -80 80 -82 82 83 84 -85 -85 85 -86 86 87 88 89 90 91 -92 -92 92 -94 94 95 96 97 -98 -98 98 -100 100 101 -102 -102 102 -106 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 -122 -122 122 -124 124 125 126 -127 -127 127 -130 130 131 132 133 134 135 136 137 138 139 140 141 142 -143 -143 143 -145 145 146 147 -148 -148 148 -151 151 152 153 154 155 156 157 -158 -158 158 -160 160 161 162 -163 -163 163 -165 165 166 167 -168 -168 168 -169 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 -208 -208 208 -210 210 211 212 -213 -213 213 -215 215 216 217 -218 -218 218 -220 220 221 222 -223 -223 223 -225 225 226 227 -228 -228 228]D /HV [1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 2 2 2 3 4 5 1 2 2 2 2 3 4 5 1 2 2 3 4 5 1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 2 2 2 2 2 2 2 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 2 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5 1 2 2 2 3 4 5]D /Cn [3 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0 6 0 0 0 0 0 1 1 1 0 3 0 0 1 1 1 0 6 0 0 0 0 0 1 1 1 0 4 0 0 0 1 1 1 0 2 0 1 1 1 0 16 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0 3 0 0 1 1 1 0 13 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0 3 0 0 1 1 1 0 7 0 0 0 0 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0 39 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0 3 0 0 1 1 1 0]D Hr length 0 gt{[/PageMode /UseOutlines /DOCVIEW pdfmark}if /Hn 1 D 0 1 Hr length 1 sub{ /Bn E D [Cn Bn get dup 0 gt{/Count E HV Bn get Bl ge{neg}if}{pop}ie /Dest Hr Bn get dup abs ST cvs cvn E 0 ge{(h)Hn ST cvs join cvx exec dup 1 get E Nf{0 get E join}{pop}ie /Hn Hn 1 add D}{()}ie /Title E dup length 255 gt{0 255 getinterval}if /OUT pdfmark}for ZF /FN Fp D Ps 0 FS /WC Wf{( )}{}ie SW pop D ET RC ZF /Df f D /R1 (http://hea-www.harvard.edu/RD/xpa/changelog.html) D /Ba f D /BO 0 D Bs /UR (help.html) D /Ti (The XPA Help Facility) D /Au () D /Df f D /ME [()] D TC /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc /Ba f D /BO 0 D Bs /UR (help.html) D /Ti (The XPA Help Facility) D /Au () D /Df f D /ME [()] D TC NP RC ZF ()1 Sl()WB 0 Sn( )0 2 0 H(XPA:)WB 47 Sn()WB 1 Sn( Public Access to Data and Algorithms)EA()EH( )0 2 1 H(Summary)WB 48 Sn()EH( This document is the Table of Contents for XPA. )0 2 2 H(Description)WB 49 Sn()EH( )0 P(The XPA messaging system provides seamless communication between many kinds of Unix programs, including X programs and Tcl/Tk programs. It also provides an easy way for users to communicate with XPA-enabled programs by executing XPA client commands in the shell or by utilizing such commands in scripts. Because XPA works both at the programming level and the shell level, it is a powerful tool for unifying any analysis environment: users and programmers have great flexibility in choosing the best level or levels at which to access XPA services, and client access can be extended or modified easily at any time. )0 P(A program becomes an XPA-enabled server by defining named points of public access through which data and commands can be exchanged with other client programs \201and users\202. Using standard TCP sockets as a transport mechanism, XPA supports both single-point and broadcast messaging to and from these servers. It supports direct communication between clients and servers, or indirect communication via an intermediate message bus emulation program. Host-based access control is implemented, as is as the ability to communicate with XPA servers across a network. )0 P(XPA implements a layered interface that is designed to be useful both to software developers and to users. The interface consists of a library of XPA client and server routines for use in C/C++ programs and a suite of high-level user programs built on top of these libraries. Using the XPA library, access points can be added to Tcl/Tk programs, Xt programs, or to Unix programs that use the XPA event loop or any event loop based on select\201\202. Client access subroutines can be added to any Tcl/Tk, Xt, or Unix program. Client access also is supported at the command line via a suite of high-level programs. )0 P(Choose from the following topics: )UL( )-1 LI()0 2 1 A(Introduction to XPA)2 1 TN TL()Ec /AF f D( )-1 LI()0 3 1 A(Access Point Names and Templates)3 1 TN TL()Ec /AF f D( )-1 LI()0 4 1 A(Getting Common Information About Access Points)4 1 TN TL()Ec /AF f D( )-1 LI()0 5 1 A(Communication Methods)5 1 TN TL()Ec /AF f D( )-1 LI()0 6 1 A(Communication Between Hosts)6 1 TN TL()Ec /AF f D( )-1 LI()0 7 1 A(Distinguishing Users)7 1 TN TL()Ec /AF f D( )-1 LI()0 8 1 A(XPA User Programs)8 1 TN TL()Ec /AF f D( )UL()-1 LI()0 9 1 A(xpaget: get data and info)9 1 TN TL()Ec /AF f D( )-1 LI()0 10 1 A(xpaset: send data and info)10 1 TN TL()Ec /AF f D( )-1 LI()0 11 1 A(xpainfo: send info alert)11 1 TN TL()Ec /AF f D( )-1 LI()0 12 1 A(xpaaccess: get access point info)12 1 TN TL()Ec /AF f D( )-1 LI()0 13 1 A(xpamb: message bus emulation)13 1 TN TL()Ec /AF f D( )-1 LI()0 14 1 A(xpans: the XPA name server)14 1 TN TL()Ec /AF f D( )LU( )-1 LI()0 15 1 A(XPA Server Routines)15 1 TN TL()Ec /AF f D( )UL()-1 LI()0 16 1 A(XPANew: define a new access point)16 1 TN TL()Ec /AF f D( )-1 LI()0 17 1 A(XPACmdNew: define a new command access point)17 1 TN TL()Ec /AF f D( )-1 LI()0 18 1 A(XPACmdAdd: add a command)18 1 TN TL()Ec /AF f D( )-1 LI()0 19 1 A(XPACmdDel: delete a command)19 1 TN TL()Ec /AF f D( )-1 LI()0 20 1 A(XPAInfoNew: define an info access point)20 1 TN TL()Ec /AF f D( )-1 LI()0 21 1 A(XPAFree: free an access point)21 1 TN TL()Ec /AF f D( )-1 LI()0 22 1 A(XPAMainLoop: event loop for select server)22 1 TN TL()Ec /AF f D( )-1 LI()0 23 1 A(XPAPoll: poll for XPA events)23 1 TN TL()Ec /AF f D( )-1 LI()0 24 1 A(XPACleanup: release reserved XPA memory)24 1 TN TL()Ec /AF f D( )-1 LI()0 25 1 A(XPA Server Macros: accessing structure internals)25 1 TN TL()Ec /AF f D( )-1 LI()0 26 1 A(XPA Race Conditions: how to avoid them)26 1 TN TL()Ec /AF f D( )-1 LI()0 27 1 A(XPA Out of Memory \201OOM\202 errors)27 1 TN TL()Ec /AF f D( )LU( )-1 LI()0 28 1 A(XPA Client Routines)28 1 TN TL()Ec /AF f D( )UL()-1 LI()0 29 1 A(XPAOpen: open a persistent client connection)29 1 TN TL()Ec /AF f D( )-1 LI()0 30 1 A(XPAClose: close persistent client connection)30 1 TN TL()Ec /AF f D( )-1 LI()0 31 1 A(XPAGet: get data)31 1 TN TL()Ec /AF f D( )-1 LI()0 32 1 A(XPASet: send data or commands)32 1 TN TL()Ec /AF f D( )-1 LI()0 33 1 A(XPAInfo: send an info alert)33 1 TN TL()Ec /AF f D( )-1 LI()0 34 1 A(XPAGetFd: get data and write to an fd)34 1 TN TL()Ec /AF f D( )-1 LI()0 35 1 A(XPASetFd: read data from and fd and send)35 1 TN TL()Ec /AF f D( )-1 LI()0 36 1 A(XPANSLookup: look up an access point)36 1 TN TL()Ec /AF f D( )-1 LI()0 37 1 A(XPAAccess: get access info)37 1 TN TL()Ec /AF f D( )-1 LI()0 38 1 A(The XPA/Xt Interface: Xt interface to XPA)38 1 TN TL()Ec /AF f D( )-1 LI()0 39 1 A(The XPA/Tcl Interface: Tcl interface to XPA)39 1 TN TL()Ec /AF f D( )LU( )-1 LI( Tailoring the XPA Environment )UL()-1 LI()0 40 1 A(Environment Variables)40 1 TN TL()Ec /AF f D( )-1 LI()0 41 1 A(Access Control)41 1 TN TL()Ec /AF f D( )LU( )-1 LI( Miscellaneous )UL( )-1 LI()0 42 1 A(XPA ChangeLog)42 1 TN TL()Ec /AF f D( )-1 LI()0 43 1 A(Where to Find Example/Test Code)43 1 TN TL()Ec /AF f D( )-1 LI()0 44 1 A(User Changes Between XPA 1.0 and 2.0)44 1 TN TL()Ec /AF f D( )-1 LI()0 45 1 A(API Changes Between XPA 1.0 and 2.0)45 1 TN TL()Ec /AF f D( )-1 LI()0 46 1 A(What Does XPA Stand For, Anyway?)46 1 TN TL()Ec /AF f D()LU( )LU( )0 5 3 H(Last)WB 50 Sn( updated: September 10, 2003)EH( )WB NL NP Ep ET /Tc f D /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (intro.html) D /Ti (Introduction to XPA) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 2 Sn( )0 2 4 H(XPAIntro:)WB 54 Sn()WB 51 Sn( Introduction to the XPA Messaging System)EA()EH( )0 2 5 H(Summary)WB 55 Sn()EH( )0 P(A brief introduction to the XPA messaging system, which provides seamless communication between all kinds of Unix event-driven programs, including X programs, Tcl/Tk programs, and Perl programs. )0 2 6 H(Description)WB 56 Sn()EH( )0 P(The XPA messaging system provides seamless communication between all kinds of Unix programs, including X programs, Tcl/Tk programs, and Perl programs. It also provides an easy way for users to communicate with these XPA-enabled programs by executing XPA client commands in the shell or by utilizing such commands in scripts. Because XPA works both at the programming level and the shell level, it is a powerful tool for unifying any analysis environment: users and programmers have great flexibility in choosing the best level or levels at which to access XPA services, and client access can be extended or modified easily at any time. )0 P(A program becomes an XPA-enabled server by defining named points of public access through which data and commands can be exchanged with other client programs \201and users\202. Using standard TCP sockets as a transport mechanism, XPA supports both single-point and broadcast messaging to and from these servers. It supports direct communication between clients and servers, or indirect communication via an intermediate message bus emulation program. Host-based access control is implemented, as is as the ability to communicate with XPA servers across a network. )0 P(XPA implements a layered interface that is designed to be useful both to software developers and to users. The interface consists of a library of XPA client and server routines for use in programs and a suite of high-level user programs built on top of these libraries. Using the XPA library, access points can be added to )0 52 1 A(Tcl/Tk)52 0 TN TL()Ec /AF f D( programs, )0 53 1 A(Xt)53 0 TN TL()Ec /AF f D( programs, or to Unix programs that use the XPA event loop or any event loop based on select\201\202. Client access subroutines can be added to any Tcl/Tk or Unix program. Client access also is supported at the command line via a suite of high-level programs. )0 P(The major components of the XPA layered interface are: )UL()-1 LI(A set of XPA server routines, centered on )0 16 1 A(XPANew\201\202,)16 0 TN TL()Ec /AF f D( which are used by XPA server programs to tag public access points with string identifiers and to register send and receive callbacks for these access points. )-1 LI(A set of XPA client routines, centered on the )0 32 1 A(XPASet\201\202)32 0 TN TL()Ec /AF f D( and )0 31 1 A(XPAGet\201\202,)31 0 TN TL()Ec /AF f D( which are used by external client applications to exchange data and commands with an XPA server. )-1 LI(High-level programs, centered on )0 10 1 A(xpaset)10 0 TN TL()Ec /AF f D( and )0 9 1 A(xpaget,)9 0 TN TL()Ec /AF f D( which allow data and information to be exchanged with XPA server programs from the command line and from scripts. These programs have the command syntax: ) 2 35 PR( [data] | xpaset [qualifiers ...] xpaget [qualifiers ...])RP( )-1 LI(An XPA name server program, )0 14 1 A(xpans,)14 0 TN TL()Ec /AF f D( through which XPA access point names are registered by servers and distributed to clients.)LU( )0 P(Defining an XPA access point is easy: a server application calls )0 16 1 A(XPANew\201\202,)16 0 TN TL()Ec /AF f D( )0 17 1 A(XPACmdNew\201\202,)17 0 TN TL()Ec /AF f D( or the experimental )0 20 1 A(XPAInfoNew\201\202)20 0 TN TL()Ec /AF f D( routine to create a named public access point. An XPA service can specify "send" and "receive" callback procedures \201or an "info" procedure in the case of XPAInfoNew\201\202\202 to be executed by the program when an external process either sends data or commands to this access point or requests data or information from this access point. Either of the callbacks can be omitted, so that a particular access point can be specified as read-only, read-write, or write-only. Application-specific client data can be associated with these callbacks. Having defined one or more public access points in this way, an XPA server program enters its usual event loop \201or uses the standard XPA event loop\202. )0 P(Clients communicate with these XPA public access points using programs such as )0 9 1 A(xpaget)9 0 TN TL()Ec /AF f D(, )0 10 1 A(xpaset)10 0 TN TL()Ec /AF f D(, and )0 11 1 A(xpainfo)11 0 TN TL()Ec /AF f D( \201at the command line\202, or routines such as )0 31 1 A(XPAGet\201\202,)31 0 TN TL()Ec /AF f D( )0 32 1 A(XPASet\201\202,)32 0 TN TL()Ec /AF f D( and )0 33 1 A(XPAInfo\201\202)33 0 TN TL()Ec /AF f D( within a program. Both methods require specification of the name of the access point. The xpaget program returns data or other information from an XPA server to its standard output, while the xpaset program sends data or commands from its standard input to an XPA application. The corresponding API routines set/get data to/from memory, returning error messages and other info as needed. If a )0 3 1 A(template)3 0 TN TL()Ec /AF f D( is used to specify the access point name \201e.g., "ds9*"\202, then communication will take place with all servers matching that template. )0 P(Please note that XPA currently is not thread-safe. All XPA calls must be in the same thread. )0 P()0 0 1 A(Go to XPA Help Index)0 0 TN TL()Ec /AF f D( )0 5 7 H(Last)WB 57 Sn( updated: March 10, 2007)EH( )WB NL /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (template.html) D /Ti (Access Point Names and Templates) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 3 Sn( )0 2 8 H(XPATemplate:)WB 59 Sn()WB 58 Sn( Access Point Names and Templates)EA()EH( )0 2 9 H(Summary)WB 60 Sn()EH( )0 P(XPA access points are composed of two parts: a general class and a specific name. Both parts accept template characters so that you can send/retrieve data to/from multiple servers at one time. )0 2 10 H(Description)WB 61 Sn()EH( )0 P(When XPA servers call )0 16 1 A(XPANew\201\202,)16 0 TN TL()Ec /AF f D( or )0 17 1 A(XPACmdNew\201\202)17 0 TN TL()Ec /AF f D( to define XPA access points, they specify a string identifier composed of a class and a name. When clients communicate with XPA access points, they specify which access points to communicate with using an identifier of the form: ) 1 12 PR( class:name)RP( All registered XPA access points that match the specified identifier will be available for communication \201subject to access control rules, etc.\202 )0 P(As of XPA 2.1.5, the length of both the class and name designations are limited to 1024 characters. )0 P(The XPA class:name identifier actually is a template: it accepts wild cards in its syntax, so a single specifier can match more than one XPA access point. \201Note that the class is optional and defaults to "*".\202 The allowed syntax for clients to specify the class:name template is of the form shown below. \201Note that "*" is used to denote a generic wild card, but other wild cards characters are supported, as described below\202. ) 7 46 PR( template explanation -------- ----------- class:name exact match of class and name name match any class with this name *:name match any class with this name class:* match any name of this class *:* match any access point)RP( )0 P(In general, the following wild-cards can be applied to class and name: ) 5 58 PR( wildcard explanation -------- ----------- ? match any character, but there must be one * match anything, or nothing [...] match an inclusive set)RP( )0 P(Although the class:name template normally is used to refer to XPA access points, these also can be specified using their individual socket identifiers. For inet sockets, the socket identifier is )BD(ip:port)ES(, where ip can be the DNS-registered name, the ASCII IP number \201e.g. 123.45.67.890\202 or the hex IP number \201e.g. 838f3a60\202. For unix sockets, the identifier is the )BD(socket file name)ES(. These socket identifiers are displayed as the fourth argument in the xpans display of registered access points. For example, consider the ds9 program started using inet sockets. The xpans name server will register something like this: ) 2 40 PR( csh> xpaget xpans DS9 ds9 gs saord.harvard.edu:3236 eric)RP( You can access ds9 using ip:3236 in any of the three forms: ) 8 37 PR( csh> xpaget saord:3236 file /home/eric/data/snr.ev csh> xpaget 123.45.67.890:3236 file /home/eric/data/snr.ev csh> xpaget 838f3a60:3236 file /home/eric/data/snr.ev)RP( In the case of unix sockets, the socket identifier is a file: ) 5 41 PR( csh> xpaget xpans DS9 ds9 gs /tmp/.xpa/DS9_ds9.2631 eric csh> xpaget /tmp/.xpa/DS9_ds9.2631 file /home/eric/data/snr.ev)RP( This feature can be useful in distinguishing between multiple instances of a program that all have the same class:name designation. )0 P()0 0 1 A(Go to XPA Help Index)0 0 TN TL()Ec /AF f D( )0 5 11 H(Last)WB 62 Sn( updated: September 10, 2003)EH( )WB NL /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (info.html) D /Ti (Getting Common Information About Access Points) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 4 Sn( )0 2 12 H(XPACommon:)WB 64 Sn()WB 63 Sn( Getting Common Information About Access Points)EA()EH( )0 2 13 H(Summary)WB 65 Sn()EH( )0 P(There are various kinds of generic information you can retrieve about an XPA access point by using the xpaget command. )0 2 14 H(Description)WB 66 Sn()EH( )0 P(You can find out which XPA access points have been registered with the currently running )0 14 1 A(XPA name server)14 0 TN TL()Ec /AF f D( by executing the )0 9 1 A(xpaget)9 0 TN TL()Ec /AF f D( command to retrieve info from the XPA name server: ) 1 14 PR( xpaget xpans)RP( If, for example, the )0 43 1 A(stest)43 0 TN TL()Ec /AF f D( test server program is running, the following XPA access points will be returned \201the specifics of the returned info will vary for different machines and users\202: ) 4 33 PR( XPA xpa gs 838e2f67:1262 eric XPA xpa1 gs 838e2f67:1266 eric XPA c_xpa gs 838e2f67:1267 eric XPA i_xpa i 838e2f67:1268 eric)RP( Note that access to this information is subject to the usual )0 41 1 A(XPA Access Control)41 0 TN TL()Ec /AF f D( restrictions. )0 P(Each XPA access point supports a number of reserved sub-commands that provide access to different kinds of information, e.g. the access control for that access point. These sub-commands can be executed by using )0 10 1 A(xpaset)10 0 TN TL()Ec /AF f D( or )0 9 1 A(xpaget)9 0 TN TL()Ec /AF f D( at the command line, or )0 31 1 A(XPAGet\201\202)31 0 TN TL()Ec /AF f D( or )0 32 1 A(XPASet\201\202)32 0 TN TL()Ec /AF f D( in programs, e.g: ) 5 30 PR( xpaget ds9 -acl xpaget ds9 -help xpaget ds9 env FOO xpaset -p ds9 env FOO foofoo)RP( With the exception of )BD(-help)ES( and )BD(-version)ES(, reserved sub-commands are available only on the machine on which the XPA server itself is running. The following reserved sub-commands are defined for all access points: )0 DL( )0 P()0 DT()BD(-acl)ES( get \201set\202 the access control list [options: host type acl, for set] )DD( The 'xpaset' option allows you to add a new acl for a given host, or change the acl for an existing host. See )0 41 1 A(XPA Access Control)41 0 TN TL()Ec /AF f D( for more information. This access point is available only on the server machine. )0 P()0 DT()BD(-env)ES( get \201set\202 an environment variable [options: name \201value, for set\202] )DD(The 'xpaget' option will return the value of the named environment variable. The 'xpaset' option will set the value of the names variable to the specified value. This access point is available only on the server machine. \201Please be advised that we have had problems setting environment variables in static Tcl/Tk programs such as ds9 running under Linux.\202 )0 P()0 DT( )BD(-clipboard)ES( set\201get\202 information on a named clipboard )DD( Clients can store ASCII state information on any number of named clipboards. Clipboards of the same name created by clients on different machines are kept separate. The syntax for creating a clipboard is: ) 2 65 PR( [data] | xpaset [server] -clipboard add|append [clipboard_name] xpaset -p [server] -clipboard delete [clipboard_name])RP( Use "add" to create a new clipboard or replace the contents of an existing one. Use "append" to append to an existing clipboard. )0 P(Information on a named clipboard is retrieved using: ) 1 45 PR( xpaget [server] -clipboard [clipboard_name])RP( )0 P()0 DT()BD(-exec)ES( set: execute commands from buffer [options: none] )DD(If -exec is specified in the paramlist of an 'xpaset' call, then further sub-commands will be retrieved from the data buffer. )0 P()0 DT()BD(-help)ES( get: return help string for this XPA or sub-command [options: name \201for sub-commands\202] )DD(Each XPA access point and each XPA sub-command can have a help string associated with it that is specified when the access point is defined. The -help option will return this help string. For XPA access points that contain user-defined sub-commands, you can get the help string for a particular sub-command by specifying its name, or else get the help strings for all sub-commands if not name is specified. )0 P()0 DT()BD(-ltimeout)ES( get \201set\202 the long timeout value [options: seconds|reset] )DD(The 'xpaget' option will return the value of the long timeout \201in seconds\202. The 'xpaset' option will set the value of the long timeout. If "reset" is specified, then the timeout value will be reset to the default value. )0 P()0 DT()BD(-nsconnect)ES( set: re-establish name server connection to all XPA's [options: none] )DD(If the )0 14 1 A(XPA Name Server \201xpans\202)14 0 TN TL()Ec /AF f D( process has terminated unexpectedly and then re-started, this sub-command can be used to re-establish the connection. You use it by sending the command to the [name:port] or [file] of the access point instead of to the XPA name \201since the latter requires the xpans connection!\202: ) 1 36 PR( xpaset -p 838e2f67:1268 -nsconnect)RP( See )0 14 1 A(xpans)14 0 TN TL()Ec /AF f D( for more information. )0 P()0 DT()BD(-nsdisconnect)ES( set: break name server connection to all XPA's [options: none] )DD(This sub-command will terminate the connection to the )0 14 1 A(XPA Name Server \201xpans\202)14 0 TN TL()Ec /AF f D(, thereby making all access points inaccessible except through their underlying [name:port] or [file] identifiers. I forget why we added it, it seems pretty useless. )0 P()0 DT()BD(-stimeout)ES( get \201set\202 the short timeout value [options: seconds|reset] )DD(The 'xpaget' option will return the value of the short timeout \201in seconds\202. The 'xpaset' option will set the value of the short timeout. If "reset" is specified, then the timeout value will be reset to the default value. )0 P()0 DT()BD(-remote)ES( set: register xpa with remote server [options: host[:port] [acl]] [-proxy] )DD(This sub-command will register the XPA access point with the XPA name server \201xpans\202 on the specified host \201which must already be running\202. The specified host also is given access control to the access point, using the specified acl or the default acl of "+" \201meaning the remote host can xpaset, xpaget, xpainfo or xpaaccess\202. If the acl is specified as "-", then the access point is unregistered. See )0 6 1 A(Communication Between Machines)6 0 TN TL()Ec /AF f D( for more information on how this sub-command is used. )0 P()0 DT()BD(-version)ES( get: return XPA version string [options: none] )DD(The version refers to the version of XPA used to define this access point \201currently something like 2.0\202. )LD( )0 P(You can add your own reserved commands to all XPA access points by using the )0 18 1 A(XPACmdAdd\201\202)18 0 TN TL()Ec /AF f D( routine, passing the XPA handle returned by )EM(XPA XPAGetReserved\201void\202)ES( as the first argument. Note again that these will only be available on the machine where the XPA service is running. )0 P()0 0 1 A(Go to XPA Help Index)0 0 TN TL()Ec /AF f D( )0 5 15 H(Last)WB 67 Sn( updated: September 10, 2003)EH( )WB NL /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (method.html) D /Ti (XPA Communication Methods) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 5 Sn( )0 2 16 H(XPAMethod:)WB 69 Sn()WB 68 Sn( )EA(XPA Communication Methods)EH( )0 2 17 H(Summary)WB 70 Sn()EH( )0 P(XPA supports both inet and unix \201local\202 socket communication. )0 2 18 H(Description)WB 71 Sn()EH( )0 P(XPA uses sockets for communication between processes. It supports three methods of socket communication: inet, localhost, and unix. In general, the same method should be employed for all XPA processes in a session and the global environment variable XPA_METHOD should be used to set up the desired method. By default, the preferred method is "inet", which is appropriate for most users. You can set up a different method by typing something like: ) 3 70 PR( setenv XPA_METHOD local # unix csh XPA_METHOD=local; export XPA_METHOD # unix sh, bash, windows/cygwin set XPA_METHOD=localhost # dos/windows)RP( The options for XPA_METHOD are: )BD(inet)ES(, )BD(unix)ES( \201or )BD(local)ES(\202, and )BD(localhost)ES(. On Unix machines, this environment setup command can be placed in your shell init file \201.cshrc, .profile, .bashrc, etc.\202 On Windows platforms, it can be placed in your AUTOEXEC.BAT file \201I think!\202. )0 P(By default, )BD(inet)ES( sockets are used by XPA. These are the standard Internet sockets that are used by programs such as Netscape, ftp. etc. Inet sockets utilize the IP address of the given machine and a \201usually random\202 port number to communicate between processes on the same machine or between different machines on the Internet. \201Note that XPA has an )0 41 1 A(Access Control)41 0 TN TL()Ec /AF f D( mechanism to prevent unauthorized access of XPA access points by other computers on the Net\202. For users connected to the Internet, this usually is the appropriate communication method. For more information about setting up XPA communication between machines, see )0 6 1 A(Communication Between Machines)6 0 TN TL()Ec /AF f D(. )0 P(In you are using XPA on a machine without an Internet connection, then inet sockets are not appropriate. In fact, an XPA process often will hang for many seconds while waiting for a response from the Domain Name Service \201DNS\202 when using inet sockets. Instead of inet sockets, users on Unix platforms can also use )BD(unix)ES( sockets \201also known as local sockets\202. These sockets are based on the local file system and do not make use of the DNS. They generally are considered to be faster than inet sockets, but they are not implemented under Windows. Use local sockets as a first resort if you are on a Unix machine that is not connected to the Internet. )0 P(Users not connected to the Internet also can use )BD(localhost)ES( sockets. These are also inet-type sockets but the IP address used for the local machine is the )BD(localhost)ES( address, 0x7F000001, instead of the real IP of the machine. Depending on how sockets are set up for a given platform, communication with the DNS usually is not required in this case \201though of course, XPA cannot interact with other machines\202. The localhost method will generally work on both Unix and Windows platforms, but whether the DNS is required or not is subject to individual configurations. )0 P(A final warning/reminder: if your XPA-enabled server hangs at startup time and your XPA_METHOD is )BD(inet)ES(, the problem probably is related to an incorrect Internet configuration. This can be confirmed by using the )BD(unix)ES( method or \201usually\202 the )BD(localhost)ES( method. You can use these alternate methods if other hosts do not need access to the XPA server. )0 P()0 0 1 A(Go to XPA Help Index)0 0 TN TL()Ec /AF f D( )0 5 19 H(Last)WB 72 Sn( updated: September 10, 2003)EH( )WB NL /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (inet.html) D /Ti (XPA Communication Between Hosts) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 6 Sn( )0 2 20 H(XPAInet:)WB 74 Sn()WB 73 Sn( XPA Communication Between Hosts)EA()EH( )0 2 21 H(Summary)WB 75 Sn()EH( XPA uses standard inet sockets to support communication between two or more host computers. )0 2 22 H(Description)WB 76 Sn()EH( )0 P(When the )0 5 1 A(Communication Method)5 0 TN TL()Ec /AF f D( is set to )BD(inet)ES( \201as it is by default\202, XPA can be used to communicate between different computers on the Internet. INET sockets utilize the IP address of the given machine and a \201usually random\202 port number to communicate between processes on the same machine or between different machines on the Internet. These standard Internet sockets are also used by programs such as Netscape, ftp. etc. )0 P(XPA supports a host-based )0 41 1 A(Access Control)41 0 TN TL()Ec /AF f D( mechanism to prevent unauthorized access of XPA access points by other computers on the Net. By default, only the machine on which the XPA server is running can access XPA services. Therefore, setting up communication between a local XPA server machine and a remote client machine requires a two-part registration process: )UL()-1 LI( the XPA service on the local machine must be made known to the remote machine )-1 LI( the remote machine must be given permission to access the local XPA service)LU( Three methods by which this remote registration can be accomplished are described below. )0 2 23 H(Manual)WB 77 Sn( Registration)EH( The first method is the most basic and does not require the remote client to have xpans running. To use it, the local server simply gives a remote client machine access to one or more XPA access points using xpaset and the )BD(-acl)ES( sub-command. For example, consider the XPA test program "stest" running on a local machine. By default the access control for the access point named "xpa" is restricted to that machine: ) 3 25 PR( [sh]$ xpaget xpa -acl *:* 123.456.78.910 gisa *:* localhost gisa)RP( Using xpaset and the )BD(-acl)ES( sub-command, a remote client machine can be given permission to perform xpaget, xpaset, xpaaccess, or xpainfo operations. For example, to allow the xpaget operation, the following command can be issued on the local machine: ) 1 45 PR( [sh]$ xpaset -p xpa -acl "remote_machine g")RP( This results in the following access permissions on the local machine: ) 4 26 PR( [sh]$ xpaget xpa -acl XPA:xpa 234.567.89.012 g *:* 123.456.78.910 gisa *:* localhost gisa)RP( The remote client can now use the local server's xpans name server to establish communication with the local XPA service. This can be done on a call-by-call basis using the )BD(-i)ES( switch on xpaset, xpaget, etc: ) 6 43 PR( [sh]$ xpaget -i "local_machine:12345" xpa class: XPA name: xpa method: 88877766:2778 sendian: little cendian: big)RP( Alternatively, the XPA_NSINET variable on the remote machine can be set to point directly to xpans on the local machine, removing the need to override this value each time an XPA program is run: ) 7 42 PR( [csh]$ setenv XPA_NSINET 'karapet:$port' [csh]$ xpaget xpa class: XPA name: xpa method: 88877766:2778 sendian: little cendian: big)RP( Here, '$port' means to use the default XPA name service port \20114285\202. not a port environment variable. )0 P(Access permission for remote client machines can be stored in a file on the local machine pointed to by the )BD(XPA_ACLFILE)ES( environment variable or using the )BD(XPA_DEFACL)ES( environment variable. See )0 41 1 A(XPA Access Control)41 0 TN TL()Ec /AF f D( for more information. )0 2 24 H(Remote)WB 78 Sn( Registration)EH( If xpans is running on the remote client machine, then a local xpaset command can be used with the )BD(-remote)ES( sub-command to register the local XPA service in the remote name service, while at the same time giving the remote machine permission to access the local service. For example, assume again that "stest" is running on the local machine and that xpans is also running on the remote machine. To register access of this local xpa on the remote machine, use the xpaset and the )BD(-remote)ES( sub-command: ) 1 56 PR( [sh]$ ./xpaset -p xpa -remote 'remote_machine:$port' +)RP( To register the local xpa access point on the remote machine with xpaget access only, execute: ) 1 56 PR( [sh]$ ./xpaset -p xpa -remote 'remote_machine:$port' g)RP( Once the remote registration command is executed, the remote client machine will have an entry such as the following in its own xpans name service: ) 2 31 PR( [csh]$ xpaget xpans XPA xpa gs 88877766:2839 eric)RP( The xpa access point can now be utilized on the remote machine without further setup: ) 6 23 PR( [csh]$ xpaget xpa class: XPA name: xpa method: 838e2f68:2839 sendian: little cendian: big)RP( To unregister remote access from the local machine, use the same command but with a '-' argument: ) 1 54 PR( [sh]$ xpaset -p xpa -remote 'remote_machine:$port' -)RP( The benefit of using remote registration is that communication with remote access points can be mixed with that of other access points on the remote machine. Using )0 3 1 A(Access Point Names and Templates)3 0 TN TL()Ec /AF f D(, one XPA command can be used to send or receive messages to the remote and local services. )0 2 25 H(XPANS)WB 79 Sn( Proxy Registration)EH( The two methods described above are useful when the local and remote machines are able to communicate freely to one another. This would be the case on most Local Area Networks \201LANs\202 where all machines are behind the same firewall and there is no port blocking between machines on the same LAN. The situation is more complicated when the XPA server is behind a firewall, where outgoing connections are allowed, but incoming port blocking is implemented to prevent machines outside the firewall from connecting to machines inside the firewall. Such incoming port blocking will prevent xpaset and xpaget from connecting to an XPA server inside a firewall. )0 P(To allow locally fire-walled XPA services to register with remote machines, we have implemented a proxy service within the xpans name server. To register remote proxy service, xpaset and the )BD(-remote)ES( sub-command is again used, but with an additional )BD(-proxy)ES( argument added to the end of the command: ) 1 63 PR( [sh]$ ./xpaset -p xpa -remote 'remote_machine:$port' g -proxy)RP( Once a remote proxy registration command is executed, the remote machine will have an entry such as the following in its own xpans name service: ) 2 32 PR( [csh]$ xpaget xpans XPA xpa gs @88877766:2839 eric)RP( The '@' sign in the name service entry indicates that xpans proxy processing is being used for this access point. Other than that, from the user's point of view, there is no difference in how this XPA access point is contacted using XPA programs \201xpaset, xpaget, etc.\202 or libraries: ) 6 23 PR( [csh]$ xpaget xpa class: XPA name: xpa method: 88877766:3053 sendian: little cendian: big)RP( )0 P(Of course, the underlying processing of the XPA requests is very much different when xpans proxy is involved. Instead of an XPA program such contacting the XPA service directly, it contacts the local xpans. Acting as a proxy server, xpans communicates with the XPA service using the command channel established at registration time. Commands \201including establishing a new data channel\202 are sent between xpans and the XPA service to set up a new message transfer, and then data is fed to/from the xpa request, through xpans, from/to the XPA service. In this way, it can be arranged so that connections between the fire-walled XPA service and the remote client are always initiated by the XPA service itself. Thus, incoming connections that would be blocked by the firewall are avoided. Note that there is a performance penalty for using the xpans/proxy service. Aside from extra overhead to set up proxy communication, all data must be sent through the intermediate proxy process. )0 P(The xpans proxy scheme requires that the remote client allow the local XPA server machine to connect to the remote xpans/proxy server. If the remote client machine also is behind a port-blocking firewall, such connections will be disallowed. In this case, the only solution is to open up some ports on the remote client machine to allow incoming connections to xpans/proxy. Two ports must be opened \201for command and data channel connections\202. By default, these two ports are 14285 and 14287. The port numbers can be changed using the )BD(XPA_NSINET)ES( environment variable. This variable takes the form: ) 1 49 PR( setenv XPA_NSINET machine:port1[,port2[,port3]])RP( where port1 is the main connecting port, port2 is the XPA access port, and port3 is the secondary data connecting port. The second and third ports are optional and default to port1+1 and port1+2, respectively. It is port1 and port3 that must be left open for incoming connections. )0 P(For example, to change the port assignments so that xpans listens for registration commands on port 12345 and data commands on port 28573: ) 1 32 PR( setenv XPA_NSINET myhost:12345)RP( Alternatively, all three ports can be assigned explicitly: ) 1 43 PR( setenv XPA_NSINET remote:12345,3000,12346)RP( In this case 12345 and 12346 should be open for incoming connections. The XPA access port \201which need not be open to the outside world\202 is set to 3000. )0 P(Finally, note that we currently have no mechanism to cope with Internet proxy servers \201such as SOCKS servers\202. If an XPA service is running on a machine that cannot connect directly to outside machines, but goes through a proxy server instead, there currently is no way to register that XPA service with a remote machine. We hope to implement support for SOCKS proxy in a future release. )0 P()0 0 1 A(Go to XPA Help Index)0 0 TN TL()Ec /AF f D( )0 5 26 H(Last)WB 80 Sn( updated: September 10, 2003)EH( )WB NL /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (users.html) D /Ti (Distinguishing Users) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 7 Sn( )0 2 27 H(XPAUsers:)WB 82 Sn()WB 81 Sn( Distinguishing Users)EA()EH( )0 2 28 H(Summary)WB 83 Sn()EH( )0 P(XPA normally distinguishes between users on a given host, but it is possible to send data to access points belonging to other users. )0 2 29 H(Description)WB 84 Sn()EH( )0 P(A single XPA name service typically serves all users on a given machine. Two users can register the same XPA access points on the same machine without conflict, because the user's username is registered with each access point and, by default, programs such as xpaget and xpaset only process access points of the appropriate user. For example: ) 4 32 PR( XPA xpa1 gs 838e2f67:1262 eric XPA xpa2 gs 838e2f67:1266 eric XPA xpa1 gs 838e2f67:2523 john XPA xpa2 gs 838e2f67:2527 john)RP( Here the users "eric" and "john" both have registered the access points xpa1 and xpa2. When either "john" or "eric" retrieves information from xpa1, they will process only the access point registered in their user name. )0 P(If you want to access another user's XPA access points on a single machine, use the -u [user] option on xpaset, xpaget, etc. For example, if eric executes: ) 1 21 PR( xpaget -u john xpa1)RP( he will access John's xpa1 access point.Use "*" to access all users on a given machine: ) 1 20 PR( xpaget -u "*" xpa1)RP( Note that the )0 40 1 A(XPA Environment Variable)40 0 TN TL()Ec /AF f D( XPA_NSUSERS can be used to specify the default list of users to process: ) 1 32 PR( setenv XPA_NSUSERS "eric,john")RP( will cause access points from both "eric" and "john" to be processed by default. )0 P()0 0 1 A(Go to XPA Help Index)0 0 TN TL()Ec /AF f D( )0 5 30 H(Last)WB 85 Sn( updated: September 10, 2003)EH( )WB NL /Cb Db D /Ct [16#00 16#00 16#00] D /Cl [16#00 16#00 16#00] D /CL -1 D Ct Sc DS /Ba f D /BO 0 D Bs /UR (programs.html) D /Ti (XPA Programs) D /Au () D /Df f D /ME [()] D 0 BO R ()1 Sl()WB 8 Sn( )0 2 31 H(XPA)WB 86 Sn( Programs)EH( )0 2 32 H(Summary)WB 87 Sn()EH( )0 P(Use the XPA programs to send/receive data to/from XPA servers from the command line or from scripts. )0 P() 7 116 PR( | xpaset [-h] [-i nsinet] [-m method] [-n] [-p] [-s] [-t sval,lval] [-u users] [-v]