[comp.binaries.mac] Macintosh Technical Notes - #132: AppleTalk Pascal Interface Update

bytebug@felix.UUCP (Roger L. Long) (08/22/87)

[Macintosh Technical Notes - #132: AppleTalk Pascal Interface Update]

Technical Note #121 announced  that  we  would  be  moving  to  a
simplified   AppleTalk  Manager  interface.   That  interface  is
available now, as part of MPW 2.0  (as  of  the  2.0B1  version).
This note serves as preliminary documentation for this interface.

---
(This file must be converted with BinHex 4.0)

:#P41-$%c-LjA8P3!9dp54%e"3d%!N!3@rJ!!!d&mA3!'!$)!!J!%!*!$r`$r!*!
$!3!!&TB!D!"S!!!@PJ"S!'J!!"D`!&J!!J#3!dJ!5!#3"!,D!LMriIrL![N#4J-
("5J$r!!#!*!$5!")!*!%!YS#+!!"!*!$C!#3!`%!!C!$!*!$!5F2!!%!!3!#1&J
!!MMJrrm!N!8C!C!!!*!K!J#3!`)!N!8"!!!4PJ"!!!!+lJ!D!!`!lrrb!)VrmJ%
arj!%!2q3"3!"!*!$!3#3"3%!!"(@!#!!!!GJ!!VrmJ!Hrr)!l2rb!EVrN!B-!!!
$!!)!N!-#!*!&!3!!%hB$)!!!%IB"J2rb!"lrmJ$Xrr)"Z[q3"3!1!3!9!!!#[2r
r!!N"l`!#!*!$#3$6rKm"l`([CA)JDA-JC(*KCfGTEL!JG!!"$@8!"J!!#J!!&3!
"$3%!"J!!$!!!&3!"$3B!"J!!$!!!&3!"$3)!"J!!$!!!&3#3!`B!!!S"!"8!&r8
'cfXC#@*JJNpe`[G8'2$3!!!'!!!1!3!9!"8!#3(K!!%!N!-*!@J'J!#3&`B!!!`
!!!-!)r69JJaUU!Y[GK"M"c)8eX%+IfXI1[$3!!!'!!!-!!!9!'"IN&m0!!B!!!N
!!"8!([6@ac*BX29"bcI'S26P)Bm*m*!!r`m0!"J!!!i"!"8!'3i&!"8!'`i"!"8
!("J4!"F!!3e[!!B!!!`!!"8!&3!K'"%!&`!"$@8!"J!!$J!!&J!"$3%!"J!!$!!
!&3#3!`%3%!#3!`%0r`!'!!!1!!!9!!%0!!!'!!!-!!!9!"MeT6%256)8eX%28%8
PaDm0!!B!!!i"!"8!&3!"$3B!"J!!$!!!&3!"$@m!"J!!$!%!&3!"$@%!"J!!$!%
!&3!"$4S!"J!!$!!!&3!"$3B!"J!!$!!!&3!"$3!!"J!!$J!!&3!Mp6pj2,46Ah@
!Bj!!p"MhNmY&0IGB$'USm0!!!!B!!!i"!"8!B&q3A`d!"J!!#3!!&3!"$3!!"J!
!$J!!&3#3"48$k!!068&(580358-4!Iqd!!%0"J!'!!!-!!!9$!%!&3!"$3)!"J!
!$!!!&3"%#8C96N0858p1)&"6EfeP3f&XE#KdD'933P"dFMSJ39438%*`G()l)'&
cH@jM4QaKCcSJ3Np26%9"6LNk)%p64A*b1`d!$!!!$!!!&3!"#J!!&J!"$3)!"J!
!$!!!&3!!$J!!&3"JAj"I$3!'!!!*!!!9!!%0!!!'!!!1!!!9!#Mb2c(c2c,cS23
HkKp8D[D`p3D-DJp*-K6@`3p9k@)I$3!'!!!1!!!9!!%0hJ!'!!!-!!!9#J!!&3&
ap8X3pRVh83ekU!F`+a$A'TJ-Md0C%'13!(Ae)Gp1pepY$hGbX#X3EZ4H4f)3pfD
[G4$93#X3aUS2H9per933pYEfYcpRmZ$dC8#1((em"ce8pYBR8`8`ekTcpR"c!V%
1C'pY%K32BUA2Di$93#XB%-DUMb`)%3+a$p,e@(2fF23HkKp8D[D`p'4IE3p"L"p
YpLVhN!$daMpRpeEfFId`JF*e-&d#X3p"lU(e4UpV$deMEfF8$,EL&2,Jp"U&mX#
"%#X3p0p3pA$e"SaU"c)8eX%0HK$p,d(ZSI9'Vf[bl[dr,!D!B0(hF&d#X3eaU30
[E4J,EhB3bf2fFCmZm0!!(J!!$!!!&3!G$!!!&J!M$!!!&3!S$!!!&J!`$!!!&3"
#m*m*p8(,0mDJp18K$b2c(c,c(p(e@(2fF#X3p)IfHr,I6"pf'Jm*m*m*m*p"lU(
e4UpV$e*IG5FaM`d!!!B!!!i!!"8!!3eS!!B!!!`!!"8!!3d"!!B!!!`!!"8!4[9
"bcI'S26P)3mMmamcmbm*j[Ca!*!$"G$c,`Rd(ZSI9'VfX28'M'S256)8eX%29HP
L(`d!"J!!#J!!&3!*!HB$"3#3!`N!+!"j!*!!!6m"Z3)3!K"TFb"KEQ&XEfG[!#G
AFQPdG'9Z)'*j1JP#FRPKEL"6G'9KFQjc#8TeE(NJ-5`J-6Ni0`d9!!B!!!i!!"8
!(28a%'U&mkm*p"lU(e4UpV$deMEfF8m0!!!'!!!1!!!9!*!$"J!!$!!!&3#3!`%
3%!#3"48-!!!9!3(d%0pe2#G6mX$dF5p#4jpR(d'C3BMb`(J14IGRNC!!*3Af)QF
`+a!eN3p*p%"G"JpL4jpR(b`09!peJ3F`pDp*p3!NBiE#G6J2+2HK43H!35pe3aN
(d$82BNHICa"i$N'"-J8`pjAh9!-5ph92Dr+I,JpCAh82E@pV%2@[5I8!aUU!peK
cpR$d(e6e!%(h(h8B+2,!D!NBa(pL'3F`+a$dNiH4$d(ZSI9'VfX-YZ)8"6$eVdR
e$bl`d!!H!!!-!!!9!!`-!!!@!"`-!!!9!1!-!J!9!2!-!!!9!2[e-IGK4U"G!V%
*BQ##6hA#pe3B$h@"N!$f,hN#X3-IG`Fb&0E"J'33jXpV'I1`p3D-DJP4Jre5#4D
Jph'U$hGbX#XB%)*2GF,h9"Mbi28q((DJaUU!C"$NAhCj'3e8$f,h9kPcpR$dcd(
e!'13!242828!ph4b(bf@*JJNpe`[G8'2,!p1p#p3!fpY'2,5Ef+K!D(fd6+2,!B
j$d(e6e!2B[GGd8#@*JJNpe`[G8'2,[$3!!B!!!`!!"8!N!-"%"!!N!89!"`-!!!
9!A6ePIG3aM##HU$fe[Da$'US#2H6bd8epeL[H3mSr5P3FJ0IGrdr+39!D2H6bd8
epeL[H3mSr5JQ3JFJ0IGr,!ecH,"b#&8rdr+I,Jp*d2H9pe$,9B%#82E@pV%'$'U
JD2H6bd8epeL[HI,!pL%)pe33*3j&pfH4"JaIEHS5G6"&pe*c%(-#X3GI3epYkK*
e-0FDN!$bJP$f)3aUSC!!phX6!V%-DU$A0UVhN!$A0iXBmTmX"8$PUJ+a"ep5'2G
D)0FDN!"G!V%1C'pY%K32BUA2D`mS+a$'UJH!P6%(d(Ae)BpeSJH!SBJ#YM"8!IF
IG@S#82-2+I,[$3!U!!!-!!!9!-8-!!!@!0%-!!!9!4--!!!@!4X-!!!9!8i-!!!
@!9B-!!!9!26e3FXhaU$dj5%2)r-I-[-3BcAh8m'3!#YL$hF3phAh@T!!pL%2E9p
fFrC`*3B)IfhUIA'3!23HkKp8D[D`p0BfpR&!Fb&0E"mZ$e5f)(-K6@`3H!EhCRT
[BU%$AhIb`'J1C#"G$dhe$eF2-[,[-!mSD!A3+a$c,blc$d,c%2GK5(8r+I,Jp8Y
i!e)3J8pf'!D!j"TrEA0Npj!!PFpepY%bBR8`e8!VH!Fb&0E"mZm0!!!'!!!1!!!
9!*!$!3`-!!%-$!!"$!`!N!d9!6,e5a!aph"c)8eX%2GB'!jNEfd5&!pLTFpVJ+I
fX3+eJ3peJC!!pLpj!V%24RS3Bj!!p%(hCm%26@0[Ca521`pjAh80HU"IG5!V%-D
UmYMKapI!eaUB"G!V%2BUA2Dr,!Bj"JMfeUS'pYAh8b"G$fH[G4$&N3mSj&pfH4N
2Gh+`NIGKTHpY%b!6pfG&2fd6+!TrDa$dhe$eIbN#pe3i!V%1C'pY%K32BUA2D`F
b8'$d06*&S-DU!P!V%'lNANGL%23HkKp8D[D`P(pf&2,[$3!5!!!-!!!9!3!-!!!
@!3F-!!!9!*!$"J!!$!!!&3#3!`%3%!#3"48!fI@9pe$fhh@#!e)2E9pf%&3*H1@
""G"JjNEfd5&!pLTFpV$f)G9"!V%-DU$A0iXBml$hHa-#X3aUS*8B$&pYkK)I,!p
jAh8'333Bj6KrBU%09!+dAhGcpR!V%1C'pY%K32BUA2D`EhG[H3mSI3pjAh8'UPa
L'3FJpeKcpR$ddIE96hN26@0[Ca3%Ah8R-BmTmZ$`d!!!"J!!$!!!&3!Tm*m*p*1
(N3p"lU(e4UpV$bM932@[5I8!Fp92E@*e2bR`d!!5!!!1!!!9!!)1!J!9!")1!!!
9!52dj5%#YL!V%'SK3f)3Fb&0E"J2Ca-8BKN'!a,hG8pV!IGK-J8`aIEHS5G6"G"
M"Spj2,46Ah@!aUVcX#Yi#"6hCm%(J$8Jj&pfH4N2B[H3!#X3j"d83C!!Fb&0E"M
b`1C#VhN2BKa[GB%&d0pe,h9"$&pYjLIf*kF[H3j&pLSIEBmZ$e-4$e3FXhaU$dj
5%2)r-I02-[,!r5p"pf9j$e@""G$di5ph92D`p&pf%bMbcp-09!pLE2DrCdAh8j!
!Fp92E@*e2bl`d!!!"J!!$!!!&3(6p'9!(hK[EHSI,!phX6""pRH#&(2fF'!fpY%
2+2GBFrC`p3p5(fGi)8p1EfdI+I,!pjAhAp@U$h@""Jp1EfdBp8Ef+Kp&-Npj##6
hA#pe3I,Jp8Yi##6hA#pe33a6Ki+!A3B0(hF2G6jXpV'3!0FDQ2,!eDTIGaN2B[H
3!'-"-R,hRbdfpY(cS#Y"%)*(2fH!mS3H3B%bFrC`+a"IB[DK`[,!,hRKmX"MN!$
hT6%0FDQ!A3+a!fpY(bN1E2DaN!!PpR%V&2,JpCAh8-B`aUS26[3[828a,dle6d8
#81E2D`+a##4cpRJ(-P!V%26QpY'29'pLSI46*2H3!)*2GF,h9"mZ$eHa-2H9pe"
"pYAhB3+a!fpY%2+2828KpYAhBI6QpY(bRb`2H9per9UJpeJ3+a!6*bpjmY0[E4$
f,hN(+"VI1`pjAh8-B`peJ3p1p#p3p6%[46*bpj!!*3jXpV"b"cmZm0!!6J!!$!!
!&3!X$!!!&J!k$!!!&3"*$!!!&J"B$!!!&3%E$!!!&J%N$!!!&3&#$!!!&J&4$!!
!&3&h$!!!&J'#$!!!&3'h$!!!&J($$!!!&3!9!EF-!!!@!F--!!!9!AAe5a"8IfG
cDJaUU!C"##HU#2GHj8)C$bKMN!$hGkS2BK$93'$hHhSI+3D!B`r5DL&$BKr6"c)
8eX(b`2B[G5$hF3MhAfIfFB)#YL$hPIG3a6Kj&!pYAhCcpR!P!V%$(hF2dZ3G&%'
Id`aUU2,Jp#%2Gf3aN!!VBJpeJ3A3+a"8IfGcDJaUU!pYEhN-Eh@"$&pYjLIf*kF
[H3j&pLSIEB$hGbX0pe,h9"#2HB)IE3KG,hGN(bi23DKI,!-IG`j&*F@S$bLRpV%
23I8r82,!+a$d(ZSI9'VfX28aL(8`p345A&VbN!"N%&1[H3j&pfH4N!$hGbX#X3-
IG`Fb&0E"Mbl`d!!!"J!!$!!!&3'%p8X39(pRFfS23HkKp8D[D`p3D-DJp*-K6@`
BmX$fXeph-'J23I3[8'MdNbhb`2Ga33NBIfFaN!!P#(pYkRhhN!$h@""G$d(ZSI9
'VfX04IE3YrClmYSIGKS+BrCrG@pR'2,Jp*1#&TmX!V(hRpAhB3a[GB'3!2GB"Jd
IG`aIEHBRpLHR,hN14IBU(ff2,JpA(pAhB3NFH4N#8"2&pe4[Ca$h@""G!V%)Efd
3Fb&0E"!VBJD)(fhf+[HI,DBrCrG@pR%23HkKp8D[D`peJBmX"JjNEfd5&2,IBUA
2D`Fb&0E""c!V%)Efd3J[HD%'J#X3TIGr,D(hBD"c)8eX'!*3+a$dCk%'13p%(hC
m%26@0[Ca52,[$3!5!!!-!!!9!$--!!!@!$`-!!!9!*!&!K6-)!!"-!!L!*!$$!#
3!`)8d#!!!9)!$$)"!!`!$!!#&03S!!DL!$ib!3!-!"J!!K6%)!!"JJ!+-J)!N!8
"M*3J!!'U!#)!N!-3!*!$!K5i)!!"c!!++`%!N!-"#`X!!5-M!!%2$`!"$`m!!3m
2!!%2$`!"$`m!!Jq#!!%2$`!"$`m!!3X,!!%2$`!#$i3!!3X,!!%2$`!#$S8!!3i
1!!)1K3!"$Ji!!Jk%!!%1$J!"$Ji!!3i1!!%1$J!"$Ji!!Jk&!!%1$J!"$Ji!!3m
2!!%1$J!#$S8!!3i1!!)1J`!"$Ji!!Jk%!!%1$J!"$Ji!!3m2!!%1$J!#$S-!!3i
1!!)1KJ!"$Ji!!3i1!!%2$`!"$Ji!!Jk$!!%1$J!"$Ji!N,m"M'JJ!!EJ!#)!N!-
,!*!$!Ba`)!!"q!"U-3%!)`!,!!'-E#J!!Q)!-M3#!!m!,J!"M'!J!!+S!!`N!3!
2!$d!!BaB+!!%l!!U0!%!$`"-!!'-8#!!!XJ!$$3"!!m!@`!"M%JS!!Fd!#)d!3!
2!'S!!Ba!+!!-S!!i0!!!(J"j!!'-1#J!"N3!4M3"!!m!P`!"M$!J!!-i!!`d!3!
2!+B!!B`S)!!(!J!b0!%!#`#e!!'-)#!!!fJ!DM%"!!m!`!!"M"JJ!!25!!`d!3!
m!-m!!B`3+!!+1!#f0!%!#`%,!!'-##!!"(B!DM%"!!m"&J!"M!!J!!6J!!`d!3"
'!58!!Tqk+!!3EJ%S!`%!$J&V!!+IXL!!"SS!$$-"!%B"H3!#Rk)S!!pQ!3Jc!3!
1!Em!!TpH)!!'PJ!--`%!1!(0!!+I@LJ!#`S!iJ-"!!i#"3!#ReBJ!!8@!!`c!3!
1!K-!!Tp5+!!"eJ!L-`%!$J)K!!+I6L!!"'3!$$-"!!i#,`!#RdSJ!!33!&3!!3!
1!Md!!Tp')!!%"!!--`%!4J*,!!+I3LJ!"5B"(J-"!!i#N3!#RciJ!!&f!!`c!Ir
T!Tm!!K6S)!!$hJ!@3`)!$`!!!3+I1LJ!!d3!*$3#!!i!$`%#RcBJ!!-)!!`c!J"
'!"d"!Tmb+!!*&J%L!`%!$J"M!3+I,L!!!T3!$$-"!#S!F3%#RbSS!!`#!*ic!3!
1!*X"!TmQ)!!"DJ!--`%!1!#T!3+I)LJ!$0J!d$-"!!i!i3%"M!`J!!&H!!`c!3!
1!1m"!B`F)!!$&!!--`)!$`$p!3'-,#J!!B`!($3#!!i"$!%"M$`J!!2d!!`c!3!
U!4S"!Ba-+!!)5J#k-`%!$J&%!3'-A#!!!b!!$$-"!&3"8J%#RaSS!!fS!E!$!3!
1!DB"!Tm@)!!#r!!--`%!$J'd!3+IML!!!V3!$$-"!!m"`J%#Rj)S!!,J!"Sd!J!
1!G%"!Tq')!!#e!!--`%!+J(I!3+ILLJ!"h!!fJ-!!!i##3%#RhiJ!!-X!!`c!3!
1!KF"!TpQ)!!(9J!+-`%!!!'S!*!$!J!!!U!!N!-)!!!#`!#3!`J!!!,k!*!$!J!
!"!#3"!3!!!4`!*!$"J!!"5)!N!-%!!!(DJ#3!`B!!!N%!*!$%J!!#`J!N!-#!!!
,l!#3!aB!!!pB!*!$$J!!&[i!X5S!U"B!!!%!N!-#e`!!!GF!N!0UHJ#3!a`%6J!
33d4&4J#3!iTA58j%!!-!PNe&6P8!"J!29%ia-c)J38*3BA0*ER4Q!J#3-CdUZ9F
!N!B$33!$@NC26P3!!30Q69GbG!!"!hj659T&!!!$PN024%8!#`1L!!)!!!3!N!F
",Irr*!!()!#3"!%ZrrmN!!Fr!*!%!5rrrb3!"e`!N!3"-2rr*!!(H3#3"3(rr`3
!"jN!N!8#rrm%!!I)!*!&!rrr"!!)0J#3"L!Z,$XN!!$3!!![rf!J38d!)&"0!$S
!N!S"!!!"6!p6G@jNBAN!N!N26@pZC'&j!*!*$e4eCA0NBAN!N!J29f9NEQ9cC'&
j!*!'$e4SGA*cC'&j!*!($dCbD@4KH3#3#3p6BA4eFQ4KH3#3"`p+B@jeBA*j!*!
)$dCPBR*eBA*j!*!($deKFQ0S!*!+$d&`FQPX!*!+$deKH3#3$!p+G@jP!*!,$dT
eE(N!N!X23A9RGA0d!*!*$e0PF(4PE@*PFJ#3"Jp2Bh4[BQ9b!*!)$dj[GQ9YBQ9
b!*!($d4PBf9YBQ9b!*!(rrm!!`#3"#`J!!!J!*!$,#!!N!F"6R8!N!-B!!X!&`!
@!"8!&!#3!`-!!J!%!!8!"J!(!*!$%!mJCA4ZFQpKDA0NE'KMCR!!N!-[!!m!)3!
1!*!$&J!$!"8!"!!2!#)!%!!b!"F!&!!5!!dX*J3rN!-&$"3d"$8r2$J!!!%!N!-
#e`!!!GF!N!0U!!'-k!,b!*!$(!"U!!&*6P4-!!%!%P088L!!!J!U!!$rrb!!N!J
"rrmJ!!!N!*!%!b$rr`!!!A3!N!3#[2rr!!!"N!!!N!3$)Irr!!!"T!!#RlDIe3:
---