Documentation for BINHEX.TXT, MNETH.HEX, MNETL.HEX and MNETA6.ASM

These files are the principal tools for uploading and downloading files
to/from CompuServe when running under TRSDOS 6.2 on the Model 4 or 4P.

First, download BINHEX.TXT using COMM. This can be accomplished by using the
buffer of COMM. Since BINHEX is actually a BASIC program, once you have it on
disk you must edit out any command "pieces" or garbage. You can then load it
into BASIC, and save it out again as a "compressed" program. You can then
use BINHEX to convert "HEX" files into Binary files (usually CMD files).
Don't forget to use slashes instead of periods when giving file names
to TRSDOS 6 (Comm, BINHEX) and periods when giving filenames to CIS! Also,
give an extension of /CMD to files you convert from /HEX with BINHEX.

For detailed instructions on downloading a file with COMM, put your printer
online and enter the command X8 at the main Forum prompt.

Next, download MNETH.HEX, again using COMM. This file contains a version of
MNETA re-written to run under TRSDOS 6. Use BINHEX to change it from a "hex"
file to a binary file. The checksum should be *AD.

Once you have this program successfully downloaded, you are in good shape.
MNETA will perform error-free file transfers to and from CompuServe. The
syntax for using MNETH is: MNETH *CL

Previously, you must have set the COM/DVR and used SETCOM as follows:
SET *CL COM/DVR
SETCOM (W=8,P=N,BREAK=0)

For 1200 baud, use SETCOM (B=1200,W=8,P=N,BREAK=0)

MNETH is a dumb terminal program. There are only a few commands.

<SHIFT><CLEAR> will abort a file transfer in progress
<CLEAR><:> is a local clear screen
<CLEAR><-> toggles display during file transfer on and off.
<BREAK> exits to DOS.

The main advantage of using MNETA is that it will automatically transfer
files to or from CompuServe using a special protocol. Any errors will cause
that piece of the file to be re-transmitted, until a good copy is received.
The best place to use this is in XA or in Public Access. For example, when
running MNETH, at the XA3 prompt you can type DOW MNETL.HEX. You will be
prompted for a file name for your computer. Let's say you respond

MNETL/HEX:0

When the transfer is completed, you will have a copy of the file on your drive
zero disk. Now, wasn't that painless?

If you are ever propted for a protocol type, specify CIS "A" protocol.
You may now LOGoff, and use BINHEX to convert that hex file to a binary file
(the checksum is *66). This version of MNETA can be executed as a DOS command
from inside of COMM.

The syntax for this is <CLEAR><SHIFT<0> (enters command mode) and then
MNETL *CL. Hitting <BREAK> will return you to COMM.

Uploading is just as easy. Typing UPL file.ext at the XA function prompt
will allow you to upload a file from your system. Remember that CIS file names
are *six* characters, a *period*, and a three character extension. You will
also be expected to supply a meaningful list of keywords and a description
for the file.

The source code for this program series is in MNETA6.ASM
