1 VMS_SHARE
Packages a series of files into a format suitable for
transmission over electronic mail networks which may mangle the
text. 

Format:

     $ VMS_SHARE [filelist] [sharfile]
2 Examples

     $ VMS_SHARE *.* FRED
          Package all files in the current directory and create a
          series of archive files of the form FRED.nn_OF_mm

     $ VMS_SHARE TWEE.* TWEE.SHAR
          Package all files with a filename of TWEE and create a
          series of archive files of the form TWEE.SHARnn_OF_mm
2 Filelist
A list of files which make up the overall package. The list 
should be comma separated and may contain wildcards.

There is no default. A prompt is issued if no files are
specified. 
2 Logical_Names
Some logical names may be defined to control the operation of 
VMS_SHARE.
3 SHARE_DISPLAY
If defined as 1 or TRUE, causes all TPU messages to be sent to 
SYS$OUTPUT.  Primarily intended for debugging.

It is a subset of the function of the SHARE_VERIFY logical name.
3 SHARE_MAX_PART_SIZE
The translation of this logical name should be an integer value 
greater than 8 and defines the maximum size, in blocks, of one 
part of the generated share file(s).  This is to allow the sizes 
to be tailored for mailers that refuse to pass files larger than 
a certain number of blocks.

Example:
     $ DEFINE SHARE_MAX_PART_SIZE 60

If no logical name is defined or it is not an integer greater 
than 8, then a default size of 31 blocks is selected.
3 SHARE_REAL_NAME
The translation of this logical name is included in brackets at 
the head of the generated share file to indicate the real name of 
the user.

Example:
     $ DEFINE SHARE_REAL_NAME "Fred Bloggs, Petunia Institute"

If no,logical name is defined, then no 'real name' is included in 
the share file header.

3 SHARE_VERIFY
The translation of this logical name is used as an argument to 
the lexical function   f$verify   and allows a user with READ 
access to the procedure to turn on tracing. This is primarily 
used for debugging.

Example:
     $ DEFINE SHARE_VERIFY 1

If no logical name is defined then verification is OFF, 
regardless of any current setting of the verify flag in DCL. 
2 Notes
The output is one or more text files containing the original code
in a self-unpacking text archive.  If more than one part is
produced then to unpack, all parts must be concatenated in order
and executed as a command procedure. 

Certain aspects of the text are encoded to ensure that the
contents is not mangled along the route. In particular,
characters outside the ascii range are escaped as are certain
printable ascii characters, like tilde. This is automatically
decoded whn the file is unpacked.  A checksum is used to ensure
that the receiving contents are right. At least, you are warned
if they are NOT right! 
2 Sharfile
The name of the package file to be created.  In general, a series
of files are produced suffixed by 'nn_OF_mm'.  The specified name
will be used with this suffix added to the file type. 
