From:	MERC::"uunet!WKUVX1.BITNET!FILESERV-Mgr"  6-JUL-1992 12:57:31.28
To:	galaxy::gleeve
CC:	
Subj:	VMS_SHARE.005-OF-005

-+-+-+-+-+-+-+-+ START OF PART 5 -+-+-+-+-+-+-+-+
V0
Xabove) to guarantee that no share file part is more than 30 blocks long.
X
XThe default of 30 blocks can be changed by defining the logical name`20
XSHARE_PART_SIZE to whatever size is required. The only restriction is that i
Vt`20
Xmust be a minimum of 6 blocks. Values below 6 are treated as 6.
X
XWhen determining the best part size to use, remember that passage through`20
Xmail systems generally add a lot of headers to the message, increasing its`2
V0
Xsize by several blocks. Allow for this when choosing the maximum part size.`
V20
X
XFor example:
X
X   $ define SHARE_PART_SIZE 200
X
Xchanges the maximum part size to 200 blocks.
X
X
X5.6 Inclusion of user's real name
X
XIf the logical name SHARE_REAL_NAME is defined, then its value is included`2
V0
Xfollowing the username at the head of the created share file. The normal`20
Xtranslation of this logical name should be the user's real name.
X
XFor example:
X
X   $ define SHARE_REAL_NAME "Fred Smith"
X
X
X5.7 Location of temporary files
X
XVMS_SHARE creates temporary files in the SYS$SCRATCH directory with a unique
V`20
Xname based on the process identification number.  If the logical name`20
XSHARE_TEMP is defined, this redefines the name/location of the temporary fil
Ve.
X
XFor example:
X
X  $ define SHARE_TEMP SYS$SCRATCH:DUMMY.TMP
X
Xredefines the temporary file name.
X
X
X5.8 Verification
X
XIf the user has read access to the procedure, then verification of its actio
Vns`20
Xmay be turned on by defining the logical name SHARE_VERIFY to have a TRUE`20
Xvalue. If the logical name is undefined or has a FALSE value then no`20
Xverification takes place.
X
XFor example:
X
X   $ define SHARE_VERIFY TRUE
X
Xturns on verification IF the user has read access.  In general, only the`20
Xsystem manager has read access to the procedure and so this option is`20
Xrestricted.
X
X
X`0C
X6.`09HOW TO UNPACK A SHARE FILE
X
X6.1 Command file
X
XA share file is designed to be run as a command procedure which will recreat
Ve`20
Xthe original source files. So in theory, it is simply necessary to extract t
Vhe`20
Xreceived mail message into a file, remove the mail headers, and then run it
V as`20
Xa command procedure.
X
XFor a single part share file, the following sequence of commands is necessar
Vy:
X
X     $ SET DEFAULT <scratch directory>
X     $ MAIL
X     MAIL>   READ <share file message part 1>
X     MAIL>   EXTRACT/NOHEADER file
X     MAIL>   EXIT
X     $
X     $ @file
X
X
X
X6.2 Dealing with multiple part share files
X
XThe recipient of a multi-part package sent in this form will receive a numbe
Vr
Xof separate mail messages - one per part - but not necessarily in the correc
Vt
Xnumeric order. These individual messages must be extracted and combined into
Xone file IN THE RIGHT ORDER. The exact sequence of events is similar to abov
Ve
Xbut slightly complicated by the need to extract them in the right order and
Xappend them into a single file:`20
X
X     $ SET DEFAULT <scratch directory>
X     $ MAIL
X     MAIL>   READ <share file message part 1>
X     MAIL>   EXTRACT/NOHEADER        file
X     MAIL>   READ <share file message part 2>
X     MAIL>   EXTRACT/NOHEADER/APPEND file
X     MAIL>        ... repeat last two steps for each part in sequence
X     MAIL>   EXIT
X     $
X     $ @file
X
XStrictly speaking, it is not necessary to remove the mail headers from each`
V20
Xpart except the first, as the share file format is designed to skip these`20
Xautomatically.
X
XIt is important to note that ALL parts must be extracted, and in the right
Xorder, before trying to unpack. It is not possible to unpack each part
Xindividually.`20
X
X
X
X
X7.`09REFERENCES
X
XThe following references provide further information on VMS_SHARE and are`20
Xprovided with each release of the software.
X
X`5B1`5D`09VMS_SHARE Technical Information supplement
X`5B2`5D`09VMS_SHARE Release notes
X`5B3`5D`09On-line HELP
$ CALL UNPACK [.VMS_SHARE]VMS_SHARE.USER_GUIDE;1 74598730
$ v=f$verify(v)
$ EXIT
