[comp.sys.mac.programmer] Communications Toolbox

ranson@cnetlu.UUCP (Ranson) (10/16/89)

How does one do asynchronous calls to the Connection Manager?
The docs I have (Inside Special K) give a weird description of the
completion routines. They are passed a Connection HANDLE. Of course,
a handle may not be valid at completion time, so there is a warning
saying that the handle may be NIL. There is also a sentence about a
(undescribed) parameter block pointed to by A0, but that may also not
be available.
With this essentially parameter-less completion routine, I can see no
way to have several asynchronous calls pending at the same time (at
least one per connection would be useful). Am I missing something?

     Daniel Ranson
     ...!mcvax!inria!cnetlu!ranson (ranson@cnetlu.fr)

jdevoto@Apple.COM (Jeanne A. E. DeVoto) (10/31/89)

[really from austing@apple.com]

In article <1174@cnetlu.UUCP> ranson@cnetlu.UUCP (Ranson) writes:
>
>How does one do asynchronous calls to the Connection Manager?
>The docs I have (Inside Special K) give a weird description of the
>completion routines. They are passed a Connection HANDLE. Of course,
>a handle may not be valid at completion time, so there is a warning
>saying that the handle may be NIL. There is also a sentence about a
>(undescribed) parameter block pointed to by A0, but that may also not
>be available.
>With this essentially parameter-less completion routine, I can see no
>way to have several asynchronous calls pending at the same time (at
>least one per connection would be useful). Am I missing something?

Simple, just call it asynchronously.  You don't *HAVE* to supply a completion
routine to the call, just pass it as a NIL.  However, if you are intending
to do async Connection Manager calls, the first thing you should do after
a CMNew (or CMChoose) is do a MoveHHi and HLock of the Connection Handle.  I've
been using the toolbox asynchronously (and successfully) for over 4 months with
no problems.
The parameter block pointed to by A0 is a device manager param block.  If your
tool supports it (and it should), then you can get the device manager info.
However, since I don't really care (right now) what the device manager says, I
don't use it.
In summary, if you want to use the Connection Manager asynchronously, lock the
Connection Handle.  Because the tool's completion routine (and yours) could be
called during interrupt, you *MUST* follow the guidelines for accessing 
handles during an interrupt.

     -Glenn L. Austin
      CommToolbox Pickup Artist
-- 
====== jeanne a. e. devoto ========================================
 jdevoto@apple.com  |  You may not distribute this article under a
 jdevoto@well.UUCP  |  compilation copyright without my permission.
___________________________________________________________________
 Apple Computer and I are not authorized  |        CI$: 72411,165
 to speak for each other.                 |  AppleLink: SQA.TEST

han@apple.COM (Byron Han, Project Scapegoat) (03/14/90)

The Macintosh Communications Toolbox is an extension of the Toolbox into 
the communications environment, giving developers to three basic classes 
of communications functionality - terminal emulations, data connections, 
and file transfers.

Application developers write to new managers - the Connection Manager, 
Terminal Manager, and File Transfer Manager - to access communications 
tools which live in the Communications Folder inside the System Folder.  
These tools perform the actual communications function (e.g. a Serial 
Connection Tool, VT102 Terminal Tool, XMODEM File Transfer Tool, etc).

These tools can be dragged in and out of the Communications Folder and 
become accessible (or inaccessible) to all applications that are written 
using the Communications Toolbox.

It is currently available through APDA.  It runs under both System 6.0.x 
and System 7.0 and will be a standard part of System 7.0.

Hope this helps.

+-------------------------------------------------------------------------+
| Disclaimer: Apple has no connection with my postings.                   |
+-------------------------------------------------------------------------+
Byron Han, CommToolbox Scapegoat  "Working 100 hours a week and loving it!"
Apple Computer, Inc.              --------------------------------
20525 Mariani Ave, MS 69L         Internet: han@apple.COM
Cupertino, CA 95014               UUCP:{sun,voder,nsc,decwrl}!apple!han
--------------------------------  GENIE:BYRONHAN   CompuServe:72167,1664
ATTnet: 408-974-6450              Applelink:HAN1   HAN1@applelink.apple.COM
---------------------------------------------------------------------------

moreland@nic.cerf.net (John Moreland) (08/11/90)

How does one install the "Communications Toolbox" ?

Thanks,
John

ar4@sage.cc.purdue.edu (Piper Keairnes) (09/15/90)

Does anyone know if the Communications Toolbox is available to download
anywhere via ftp, or must it be ordered from ADPA or such?

-----
Piper Keairnes
ar4@sage.cc.purdue.edu

elk@python.cis.ohio-state.edu (Edwin L King) (10/09/90)

  Could anybody tell me where I can get hold of the Communications
Toolbox? I'm not a member of APDA, and I don't have the money now to
become one (heard it costs several hundred bucks -- is that right?).
I'm just a little hacker who wants to start working with it!
  I don't know if it is generally available to the public or if it
costs an arm and a leg or what -- I'm only interested in legal/ethical
means of obtaining it.

Please email responses to elk@cis.ohio-state.edu

rickf@Apple.COM (Rick Fleischman) (10/10/90)

In article <84519@tut.cis.ohio-state.edu> <elk@python.cis.ohio-state.edu> writes:
>  Could anybody tell me where I can get hold of the Communications
>Toolbox? I'm not a member of APDA, and I don't have the money now to
>become one (heard it costs several hundred bucks -- is that right?).
>I'm just a little hacker who wants to start working with it!
>  I don't know if it is generally available to the public or if it
>costs an arm and a leg or what -- I'm only interested in legal/ethical
>means of obtaining it.

Because the Communications Toolbox is a final, fully tested product, you don't
have to pay a "membership" fee in order to purchase it from APDA.

You do have to purchase an APDA membership ($20/year) if you want to purchase
any beta, or pre-release products.

The following are the fully tested Communications Toolbox products:
M0232LL/D -- Macintosh Communications Toolbox v.1.0 -- $80.00
M0379LL/B -- Macintosh Comm. Tools, Basic Connectivity Set, v.1.0 -- $50.00
M0800LL/A -- LAT: Local Access Transport Connection Tool, v.1.0 -- $50.00
M0801LL/A -- VT320 Terminal Emulation Tool, v.1.0 -- $50.00

The above products are available without paying an APDA membership fee.

The following are the beta/pre-release Communications Toolbox products:
M0380LL/A -- Macintosh Comm. Toolbox, Source Code Examples v.1.0B15 -- $30.00
M0950LL/A -- Serial NB Tool, v.1.0F11 -- $40.00

The above products are only available to APDA members.

You can reach APDA at:
(800) 282-2732 (in the U.S.)
(800) 637-0029 (in Canada)
(408) 562-3910 (International)

or via e-mail at: APDA@applelink.apple.com

Rick Fleischman
Developer Programs/APDA
Apple Computer, Inc.
e-mail: rickf@apple.com
AppleLink: FLEISCHMAN@applelink.apple.com

sharp@cs-sun-fsc.cpsc.ucalgary.ca (Maurice Sharp) (10/10/90)

In article <10638@goofy.Apple.COM> rickf@Apple.COM (Rick Fleischman) writes:

>The above products are only available to APDA members.

Hiya,

     The above statement is not correct. Anyone can buy the
communications toolbox stuff, including the Beta items. I did, and I
am not a member of APDA.

	maurice




-- 
Maurice Sharp MSc. Student (403) 220 7690
University of Calgary Computer Science Department
2500 University Drive N.W.	      sharp@cpsc.UCalgary.CA
Calgary, Alberta, T2N 1N4	      GEnie M.SHARP5

udasbell@mcs.drexel.edu (David Asbell) (05/29/91)

Does anybody know how to use the routines in the Communication Toolbox??
I would rather use them than access the serial driver, but I'm not sure how
to use the routines in it. System 7.0 has it buit in, which makes it even more 
preferable.

Thanks, 
David Asbell
udasbell@mcs.drexel.edu

russotto@eng.umd.edu (Matthew T. Russotto) (05/30/91)

In article <1991May28.191627.16472@mcs.drexel.edu> udasbell@mcs.drexel.edu (David Asbell) writes:
>Does anybody know how to use the routines in the Communication Toolbox??
>I would rather use them than access the serial driver, but I'm not sure how
>to use the routines in it. System 7.0 has it buit in, which makes it even more 
>preferable.
>

Apple's develop magazine had a sample program called 'Surfer' which used
the comm toolbox.  It seems to be on many BBSs, but I don't know of an FTP
site it is on.

Say, Apple.people-- any word on when/if develop will be up on the FTP site?
--
Matthew T. Russotto	russotto@eng.umd.edu	russotto@wam.umd.edu
     .sig under construction, like the rest of this campus.

han@Apple.COM (Byron Han) (05/31/91)

In article <1991May28.191627.16472@mcs.drexel.edu> udasbell@mcs.drexel.edu (David Asbell) writes:
>Does anybody know how to use the routines in the Communication Toolbox??
>I would rather use them than access the serial driver, but I'm not sure how
>to use the routines in it. System 7.0 has it buit in, which makes it even more 
>preferable.
>
Addison Wesley Crusher has a book out - Inside Macintosh Communications Toolbox
which completes the rest of the Inside Macintosh series.  Headers and libraries
are included with MPW 3.2 (and should also be available for THINK C/Pascal as
well... Hope this helps.

-- 

Byron Han, CommToolbox Emir       Our CEO makes more than yours...            
Apple Computer, Inc.              --------------------------------------------
20525 Mariani Ave, MS: 35CP       Internet: han@apple.COM
Cupertino, CA 95014               AppleLink: HAN1  HAN1@applelink.apple.COM
Phone: 1.408.974.6450             CompuServe: 72167,1664                   

time@ice.com (Tim Endres) (05/31/91)

In article <53508@apple.Apple.COM>, han@Apple.COM (Byron Han) writes:
> >Does anybody know how to use the routines in the Communication Toolbox??
> >I would rather use them than access the serial driver, but I'm not sure how
> >to use the routines in it. System 7.0 has it buit in, which makes it even more 
> >preferable.
> >
> Addison Wesley Crusher has a book out - Inside Macintosh Communications Toolbox
> which completes the rest of the Inside Macintosh series.  Headers and libraries
> are included with MPW 3.2 (and should also be available for THINK C/Pascal as
> well... Hope this helps.

What about Inside Mac Volume VI. Then you get more....

-------------------------------------------------------------
Tim Endres                |  time@ice.com
ICE Engineering           |  uupsi!ice.com!time
8840 Main Street          |  Voice            FAX
Whitmore Lake MI. 48189   |  (313) 449 8288   (313) 449 9208

leonardr@sv.portal.com (Leonard Rosenthol) (06/01/91)

In article <1991May28.191627.16472@mcs.drexel.edu>, udasbell@mcs.drexel.edu (David Asbell) writes:
> From: udasbell@mcs.drexel.edu (David Asbell)
> Newsgroups: comp.sys.mac.programmer
> Subject: Communications Toolbox
> Date: 28 May 91 19:16:27 GMT
> Organization: Drexel University, Dept. of Math. and Comp. Sci.
> 
> Does anybody know how to use the routines in the Communication Toolbox??
> I would rather use them than access the serial driver, but I'm not sure how
> to use the routines in it. System 7.0 has it buit in, which makes it even more 
> preferable.
> 
	The CTB is documented in the 'Communcations Toolbox Manual' now available from Addison Wesley at your favorite computer book store (or wherever Inside Macintosh is sold).  You can also, I would guess, order the docs along with sample source from APDA.


----------------------------------------------------------------------
+ Leonard Rosenthol                | AppleLink: MACgician            +
+ Software Ventures                | GEnie:     MACgician            +
+ Internet: leonardr@sv.portal.com | AOL:       MACgician            +
----------------------------------------------------------------------

fredrp@tdw206.ed.ray.com (Fred Ross-Perry) (06/04/91)

Hi,

We've got DEC's PathWorks here, and it comes with the COMM ToolBox.
DEC has  a dandy set of reference manuals for it, although I don't
know if they're for sale.  I've used it with THINK C (you need to
get the libraries for this from somewhere on AppleLink) to do
DECNet between a MAC and a VAX.

Anyway, the manuals might be from Apple.  They have numbers like

	PATHWORKS for macintosh
	Comm ToolBox Programmer's Reference
	AA-PCT2A-TE

	PATHWORKS for macintosh
	Programmer's Reference
	AA-PBT8A-TE

	PATHWORKS for macintosh
	Programmer's Guide
	AA-PCT1A-TE

	PATHWORKS for macintosh
	Data Access language Programmer Reference
	AA-PCT3A-TE

Hope this helps.
-- 
**********************************************
 Fred Ross-Perry         Raytheon Company
 fredrp@mar.ed.ray.com   Equipment Division
 (508) 440-4481          528 Boston Post Road
                         Sudbury, MA 01776
**********************************************

glenn@gla-aux.uucp (Glenn Austin) (06/05/91)

The ISBN number of Inside the Macintosh(R) Communications Toolbox is:
  0-201-57775-5

APDA's part number is:  M1215LL/A

===============================================================================
| Glenn L. Austin                | "Turn too soon, run out of room.           |
| Macintosh Wizard and           |    Turn too late, much better fate."       |
| Auto Racing Driver             |   -- Jim Russell Racing School Instructors |
|-----------------------------------------------------------------------------|
| Don't take me too seriously -- I never do!  :-)                             |
|-----------------------------------------------------------------------------|
| Usenet:  glenn@gla-aux.uucp or glenn%gla-aux.uucp@skinner.cs.uoregon.edu    |
===============================================================================