                     VMS Kermit and File Transfer Programs
                     ====================================


Floppy disk #3 of the ARTA Kermit Release contains the files necessary to
implement VAX Kermit, as well as HEXIFY, DEHEXIFY, and SMALL which are programs
to assist in the transfer of large and/or binary files.  The procedures for 
installation and use of these programs are described below.  Disk #3 should
contain the following files:


VMSMIT.EXE
VMSMIT.HLP
HEXIFY.EXE
HEXIFY.MAR
DEHEXIFY.EXE
DEHEXIFY.MAR
SMALL.EXE
SMALL.FOR
VMS.INS (this file)


VMS Kermit
----------

VMS Kermit (also known as Kermit-32) implements the Kermit file transfer
protocol for VAX computers.  KERMIT-32 Version 3.3.117 is included in the ARTA
Kermit Release (VMSMIT.EXE listed above).  A Kermit-32 VMS help file is also
included (VMSMIT.HLP). To use VAX Kermit, these two files must be transferred
from disk #3 to, naturally, a VAX.  If your VAX already has a previous version
of Kermit, use it for the transfer (MS-DOS Kermit version 2.31 is also included
with this release - see disk #1).  If not, use another file transfer system
(such as XMODEM).  Once the files have been transferred to an appropriate
directory, you might want to rename the files from VMSMIT to KERMIT.  Then all
that's left to do is install the help file and create the Kermit command:

            KERMIT == "$disk:[directory]KERMIT"


where "disk:[directory]" is the location of KERMIT.EXE.  For more information
on using Kermit, see the Kermit VMS help file or the documentation for MS-DOS
Kermit (MSKERM.DOC on disk #1).


File Transfer Programs - HEXIFY, DEHEXIFY and SMALL
---------------------------------------------------

HEXIFY is a program to convert any VMS file into a printable ASCII "hex" file,
suitable for transfer as a text file by Kermit, electronic mail, or other
means.  DEHEXIFY will convert a hex file created by HEXIFY back into its
original form, with all FILES-11 attributes intact.  SMALL takes a large text
file and makes it into one or more small files in order to fit the large file
on multiple floppy disks.  The source code for these programs is also included
(DE/HEXIFY.MAR, SMALL.FOR).  The source code for SMALL references subprograms
not included in the file - these subroutines are in the ARTA system library
MERLIB. (MERLIB is available on the ARTA VAX; it is also available through
DECUS.)  To use these programs, the executable files must be transferred to a
mainframe (the HEXIFY programs are for VMS only).  


PROCEDURE FOR MAINFRAME TO PC TRANSFER:

If the file to transfer is too large to fit on one floppy disk, (over 360
KBytes) you will want to use the SMALL program to break up the file.  However,
SMALL only works on TEXT files. If the file to be transferred is binary, you
must first use the HEXIFY program in order to use SMALL.

To use HEXIFY, on the ARTA VAX simply enter "HEXIFY".  If you are not using the
ARTA VAX, create the HEXIFY command:  HEXIFY == "$disk:[directory]HEXIFY"; then
enter HEXIFY.  The program prompts for an input file name, output file name,
and additional files to append.  If you don't specify an output file name, the
default is the input file name with the filetype ".HEX".

To use SMALL, if not on the ARTA VAX, you must first create the SMALL command:
SMALL == "$disk:[directory]SMALL" (the ARTA VAX has the SMALL command). The
syntax for the SMALL command is:

               SMALL/MAX=nnn filespeclist

where "nnn" is the maximum size IN KILOBYTES of the small file(s).  You MUST
specify the "/MAX=" qualifier.  Note that one kilobyte is the same as two
blocks on VMS disks.  If the filesize is less than "nnn" kilobytes, SMALL takes
no action.  If the filesize is greater than "nnn" kilobytes, SMALL creates
multiple files with the same filename as the input file but with the filetypes
of PT1, PT2, etc.  Each file will be less than or equal to "nnn" in size.  The
files may now be transferred to floppies.

AN EXAMPLE

Transfer a 720 block VMS executable file called X.EXE to multiple floppies:
1.  Run HEXIFY to get X.HEX.
2.  Run SMALL with the command SMALL/MAX=340 X.HEX to get X.PT1, X.PT2 and
    X.PT3.
3.  Transfer the parts to three floppy disks.



PROCEDURE FOR PC TO MAINFRAME TRANSFER:

If SMALL was used, upload the files created by SMALL from the multiple floppy
disks to the mainframe.  Put the files back together into one file (by using an
editor, the VMS command APPEND or COPY, etc.). If you used HEXIFY on the
original file, you now must use DEHEXIFY to restore the file to its original
form.

To use DEHEXIFY, on the ARTA VAX enter "DEHEXIFY".  If you are not using the
ARTA VAX, create the DEHEXIFY command: DEHEXIFY == "$disk:[directory]DEHEXIFY";
then enter DEHEXIFY. The program prompts for the input hex file name (include
the filetype - there is no default).  The output file will be a restored
version of the original file with the original file name.

AN EXAMPLE

Restore X.EXE:
1.  Upload the files X.PT1, X.PT2 and X.PT3 from the three floppies
2.  Put the parts back together using, for example, the VMS COPY command:
                 COPY X.PT1,X.PT2,X.PT3 X.HEX
3.  Run DEHEXIFY on X.HEX to restore X.EXE.
