! Version 1.4
!     -- Andy Harper, Kings College London, UK
1 PAKMAIL
Sends a series of files produced by VMS_SHARE across the E-mail
system to a specified set of recipients. 

Format:
     $ PAKMAIL recipient filespec parts [comment]
2 Errors
These errors can be returned from PAKMAIL.
3 ABANDON
One or more of the parts of the package could not be found. Prior
messages should give the specific parts that could not be found.
See NOPART. 
3 MAIL_errors
PAKMAIL uses the MAIL utility to send the parts. Consequently
errors may be issued by the MAIL utility under certain
conditions. Consult the MAIL reference manual and/or system
messages reference manual for details of these. 
3 NOPACKAGE
No files could be found for the package at all so it is highly
probable that the name of the package has been given incorrectly.
3 NOPART
Indicates that a particular part of the package cannot be found.
Given a filespec of '[dir]file.type', the parts of the package
should exist as: 
   [dir]file.type_1
   [dir]file.type_2
   ...
3 SENDPART
An informational message to indicate that a particular part of
the package is being sent. 
2 Example
     $ PAKMAIL FRED [.TEST]PACKAGE 25
          Send all 25 parts of a VMS_SHARE created series of files
          that comprise the package "PACKAGE". Files have a generic
          prefix of "[.TEST]PACKAGE" and  each will have its TYPE
          suffixed by the VMS_SHARE convention of 'nn'
2 Filespec
The directory and fixed constant part of the files containing the
VMS_SHARE'd package. The part number is appended to the TYPE part
of the name. 

For instance, the name "[.TEST]BURBLE.SHAR" refers to the files:

     [.TEST]BURBLE.SHAR_nn

'nn' being the part number.
2 Comment
Specifies an optional comment to be inserted into the MAIL /SUBJECT
header line, between the package name and the number of
the part. 

For example, without this parameter, the /SUBJECT line looks like
this: 
   Subject:   VMS_SHARE  1/4

With it set to the string "(Version 7 Pre-release)", the /SUBJECT
line looks like this: 
   Subject:   VMS_SHARE (Version 7 Pre-Release) 1/4
2 Parts
Specifies the number of parts making up the complete package to
be sent. This defines the total number of files to be sent. 

There is no default for this.
2 Recipient
The mail address of the recipient. This may be anything which can
be used on the MAIL command line. Because of the way MAIL parses
addresses and the way DCL treats @ symbols, care is needed when
specifying addresses which are distribution lists (usually
prefixed by @) or which contain double quotes. 
3 Distribution_Lists
Use of distribution lists directly on the MAIl command line does
not work as DCL gets at the '@' symbol before MAIL does!  It must
be done by pointing a logical name at the distribution list,
including the '@' and then using the logical name as the
recipient. 

For instance, to simulate:

   $ PAKMAIL @FRIENDS   ....

Do:

   $ DEFINE FRIENDS "@FRIENDS.DIS"
   $ CREATE FRIENDS.DIS
   ..... insert friends here
   ^Z
   $ PAKMAIL FRIENDS .....
3 Quoted_usernames
Usernames must be specified in exactly the same form as they
would be used on the MAIL command line, as in: 

   $ MAIL MESSAGE.TXT NET%"""FRED@MIT"""

This is important only when addresses containing double quotes
are used; essentially, individual quotes are doubled and a new
set placed around the lot. 

For instance, to simulate:

   $ PAKMAIL  EARN%"FRED@CARNEGIE"

Do:
   $ PAKMAIL  EARN%"""FRED@CARNEGIE"""

Alternatively, define a logical name that contains the original
form of address: 

   $ DEFINE BROTHER EARN%"""FRED@CARNEGIE"""
   $ PAKMAIL BROTHER   ...
2 VMS_SHARE
VMS_SHARE packages a series of files into the special format. See
the help on that utility for specific information. 
