1 MACX

MACX lets you upload Macintosh files to the VAX and download Macintosh files
from the VAX.  The files can be of any type, including MacPaint pictures,
formatted MacWrite files, fonts, and applications.

Put  MACX :== run ulib:[macintosh.macx]macx.exe      in your login.com.

To use MACX, you must be running MacTerminal, Versaterm, or some other 
terminal program that uses the original MacTerminal 1.1 xmodem protocol.

For Versaterm, it should say Mac XMODEM under the File menu.
For MacTerminal 1.1  your file transfer settings must be:

	Transfer Method   (*) XMODEM        ( ) Text
	Remote System     (*) MacTerminal   ( ) Other

	Terminal emulation must be VT100 ANSI to send files to the Mac.
	If you have trouble check TERMINAL under the SETTINGS menu. 
	Several Vax programs including MAIL will change ANSI to VT52.

The other settings don't matter.  Notice that you set "remote system" to
"MacTerminal" even though the remote system is really a VAX.


MACX commands can be abbreviated to one character.  C)atalog will show you
what files are available.  The main commands are C)atalog, U)pload, 
D)ownload, and Q)uit.  Special commands are available for text files.

Macintosh files are stored on the Vax with an extension of .MAC
2 Bugs

Known bugs and deficiencies:

doesn't prompt for file name when you use DOWN or UP commands
loses last character of file when using UPLOAD/TEXT

2 Catalog

C)atalog shows you what Macintosh files are available.

Notice that every Macintosh file has TWO NAMES: a Macintosh name and a 
VMS name.  The Macintosh name is the name the file had or will have 
on the Macintosh; the VMS name is the name it has on the VMS system.
The Macintosh name is for information only.  In MACX commands, you must
ALWAYS use the VMS name.

Advanced users: VMS filenames for Macintosh files have a default ".MAC"
extension.  The Catalog command can be followed by an optional directory
specification.
2 Download

To download a file, use the D command followed by the VMS name (NOT the
Macintosh name) of the file you want.  For example:

VMS name   Macintosh file  Type             Size  Last modified
 
BACKGAMN   Backgammon      Application       31K   9-DEC-1984 08:24:21
CALENDAR   calendar        Application       23K  25-AUG-1984 17:44:34

to download the Backgammon application, you would use the command

	MACX>d backgamn

MACX will automatically trigger MacTerminal to receive the file; you do 
not need to pull down any MacTerminal commands.

Wildcards work for file specs, IF you have write permission in your 
default  directory.  

	MACX>d c*

will do a batch download of all .mac files that start with c.

You can download a VAX text file as a Mac 'text only' file with the 
qualifier /TEXT. 
3 /TEXT
  MACX>DOWNLOAD filename.ext/TEXT performs a "text download."


a) "filename.ext" should be a full VMS filename with extension;
for example, "note.txt" or "letter.rno".  The file must be a 
normal VMS text file, one that you could edit with EDT or type 
out with TYPE.  These files will NOT appear in a MACX catalog.

b) You should use the normal MACX file transfer settings: 
XMODEM/MacTerminal. Do NOT use any other settings.

c) The downloaded file will appear on your Macintosh as a 
MacWrite TEXT file.

2 Upload

To upload a file, use the U command.  If you use U by itself, MACX will
automatically name the VMS file by taking the first 9 alphanumeric
characters in the Macintosh file name.  If you want to choose the VMS
file name yourself, type it after the U:

	MACX>u myname


After issuing the U)pload command, you must then tell MacTerminal to 
send the file by pulling down "Send file..." from the File menu.

You can also upload Mac 'text only' files as a standard VAX text 
file with the qualifier /TEXT.  By default, lines are wrapped at 79 
characters per line.  You can change this with the /WRAP=nnn qualifier.

	MACX> u/text/wrap=132  file.txt

Batch uploads of binary files are now supported.  See /BATCH for more info.

3 /BATCH
   MACX> UPLOAD/BATCH

If you are running a terminal emulator that supports batch upload with
the MacTerminal protocol (such as Versaterm 3.0) it will now work 
with MACX.  

Restrictions:   /TEXT is not supported

		To exit batch mode, type Control-X.  This will exit
		MACX, leaving the log file MACX.LOG, which will 
		contain a list of the files that were uploaded
		(along with timeout messages and other junk).
3 /TEXT
   MACX>UPLOAD filename.ext/TEXT performs a "text upload."

a) The file you send must be a Macintosh text file.  Examples of 
text files are: MacWrite files you save using the "TEXT ONLY" 
option; MacTerminal documents; files produced by MockWrite or 
captured by MockTerminal; and MS-BASIC programs that have been 
saved with the TEXT option.

b) "filename.ext" should be a full VMS filename with extension; 
for example, "note.txt".  Do NOT use the extension ".mac".

c) You should use the normal MACX file transfer settings: 
XMODEM/MacTerminal. Do NOT use any other settings.

d) When the transfer is complete, the file will NOT appear in 
the MACX catalog.  It will appear in the normal VMS directory 
with the filename and extension you specified, and can be handled
as a normal VMS text file.

2 Text
Many Macintosh applications produce "TEXT" documents; for example, 
MacWrite if you save "Text only."  Macintosh "TEXT" documents are 
fairly easy to exchange with other computer systems.

Suppose that "TEXTDOC.MAC" is the VMS file name of a Macintosh text 
document. You cannot use TEXTDOC.MAC directly under VMS; although it 
is stored in the VMS system, it is not stored in the normal VMS text 
format, but in a format the mirrors the Macintosh format.  For example,
you could not meaningfully edit TEXTDOC.MAC with EDT or TECO.  MACX does,
however, provide tools for converting Macintosh text format to and from
VMS text format.

The tools are TYPE, PRINT, IMPORT, EXPORT; these commands can be 
abbreviated to their initial character if desired. In addition, 
UPLOAD/TEXT and DOWNLOAD/TEXT provide direct Mac-to-VMS text uploads 
and downloads.
2 Type
The MACX command

	MACX>TYPE TEXTDOC

will display TEXTDOC on the screen.  TEXTDOC must be a Macintosh text 
file appearing in the MACX catalog; that is, it must have a VMS ".MAC"
extension and a Macintosh "TEXT" type.

Lines exceeding 79 characters will be wrapped.  The wrap length can be
changed by including a /WRAP qualifier; for example,

	MACX>TYPE TEXTDOC/WRAP=72
2 Print
Bug:  non-functional.

The MACX command

	MACX>PRINT TEXTDOC

will print TEXTDOC on the system printer.  TEXTDOC must be a Macintosh
text file appearing in the MACX catalog; that is, it must have a VMS 
".MAC" extension and a Macintosh "TEXT" type.

Lines exceeding 79 characters will be wrapped.  The wrap length can be
changed by including a /WRAP qualifier; for example,

	MACX>PRINT TEXTDOC/WRAP=72

Printers other than the system printer can be specified with the /OUT
qualifier; for example,

	MACX>PRINT TEXTDOC/OUT=QUME:
2 Import
Changes a VAX test file into the MACX file format.

  MACX>IMPORT file.dat	will create a file named file.mac

2 Export
Changes a MACX text file into a Vax file.

	MACX>EXPORT file	converts file.mac to file.txt

Note:   you aren't allowed to specify an extention other than .txt.
	Wildcards don't work.

	You can use the /out=newfilename.newext qualifier.
