There is now a program available for RSX-11M and VMS called MISH.  This progam
allows us to transfer any type of file (fixed length, indexed, print format,
implied, etc.) on a HASP reader stream to a HASP Central.  It also allows us
to transfer any type of file using VAXNET/RSXNET.

******************************************************************************

Why is this program needed ?

For VAX CENTRAL:
----------------
Currently, the only files a HASP remote can send to a HASP Central are ASCII
files not longer than 80 characters per line.  This means that punch files
and/or print files brought back to the remote can not be sent back to the
Central.  The MISH program once installed on the Remote and the VAX Central
allows users to send any type of file to the Central system.  A typical job
on the Remote used to send a MISHed file to Central would have the following
command in it:

	$ JOB user_name
	$ PASSWORD vax_password
	$ CREATE file_name.MIS

The command to submit the job to Central would be:

	> rje .IN=job_name.JOB,file_name.MIS

After the job has executed at the Central system, someone at Central would
use MISH to decompress the mished file back to its original file format.

For VAXNET/RSXNET:
------------------
VAXNET/RSXNET can only transfer ASCII files to/from the SNDRCV program on the
remote system.  Using the programs F2T and T2F, QWIKNET Q.QWK files which are
256 byte fixed length records and any file with 512 byte fixed length records
can be converted to ASCII, transfered to/from the remote and then converted
back into the original file.  Other files such as plot files could not be
tranferred using VAXNET/RSXNET.

After our clients have been updated with the MISH program (possible using F2T
and T2F or the MASH program), F2T and T2F will be obsolete.

******************************************************************************

Who will use this program ?

Anyone who needs to send and/or receive files on an M-Series, V-Series, or VAX
Central system will use this program.  Typical uses of this program might be to
send word processor file(s) to our San Fransisco office.  Another use might be
to pick up a plotter file (such as the new META QPLOT files) from a clients'
system to diagnose a problem here.

******************************************************************************

How does MISH work (for you technical buffs):

The MASH program used to compress and create a file with 80 byte records for
the VAX Central punch streams was modified for MISH.  MISH creates files of
78 byte records in the ASCII range of 37 to 100 decimal.  The first 2 records
of the MISHed file contains the header records used to restore the original
file attributes.  Since MISH uses block I/O during compress and decompress,
any type of file can be handled.

******************************************************************************

The following is an example of MISHing (compressing) a QPLOT meta file,
VAXNETing the mished file to the VAX, and then unMISHing (decompressing) 
the file back to its original format.  The default file type for a MISHed
file (.MIS) is specified in the examples that follow for clarity.

>mish
MISH>/he
  
  MISH is a program used to compress and convert input files into printable
  ASCII files.  These files can be submitted on HASP reader streams and can
  be transmitted using VAXNET/RSXNET.  After the file is received at the
  remote system, MISH is then used to decompress the files back into their
  original file format.  All file attributes are restored using the header
  record from the compressed file.
  
  Command line format:
  
       input_file/switches output_file/switches
  
  Where switches are:
  
    /ANALYZE    - Used to analyze the header record and/or data of a file
                  which has been compressed.  Additional sub-switches that
                  can be used are /DATA, /OCTAL, & /REVERSE.
    /COMPRESS   - Used to compress files.  This is the default mode.
    /DECOMPRESS - Used to decompress files into their original file format.
  
MISH>tgen20.met tgen20.mis
The total number of blocks = 19, the total number of records = 185
MISH>tgen20.mis/anal
$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*

MISH FILE HEADER

	File name: TGEN20.MET
	Owner UIC: [315,001]
	Protection:  System: RWED, Owner: RWED, Group: RWED, World: R
	Mished Date: 17-JUN-83
	Contiguity Options: none

FCS/RMS FILE ATTRIBUTES:

	File Organization: sequential
	Record Format: variable
	Record Attributes: carriage-return
	Maximum Record Size: 0
	Longest Record: 80
	Blocks To Allocate: 19, Default Extend Size: 0
	End-of-file VBN: 19, Offset: 378

$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*$*
MISH>^Z
>
>sndrcv
SNDRCV Version 2.1 started ... Type CTRL/X and RETURN to abort.

Vaxnet> GET
Enter the name of the REMOTE file: TGEN20.MIS
Enter the name of the VAX file: 
Total records:   185, total bytes:   13950

*** File transmission is complete. ***
*** The elapsed time was 00:00:45.30 ***

SNDRCV Status Report: 
Total records:     185, total bytes:     13950, timeouts:      0
Framing errors:      0, overruns:       0, parity errors:      0
>

$ mcr mish
MISH>tgen20.mis/decompress tgen20.met
The total number of blocks = 19, the total number of records = 185
MISH>^Z
$