🚀 go-pugleaf

Submitted-by: "Andy, Systems Manager" <UDAA055@ELM.CC.KCL.AC.UK>
Posting-number: Volume 4, Issue 52
Archive-name: vms_share/part08
Supersedes: vms_share: Volume 3, Issue 87-89

-+-+-+-+-+-+-+-+ START OF PART 8 -+-+-+-+-+-+-+-+
X
XThe`20recipient`20parameter`20is`20the`20mail`20address`20of`20the`20user,`20o
Vr`20users,`20who`20are`20to`20
Xbe`20sent`20the`20package.`20This`20can`20take`20any`20form`20of`20mail`20addr
Vess`20acceptable`20to`20the`20
XVMS`20MAIL`20system`20when`20used`20from`20the`20command`20line.`20For`20examp
Vle:
X
X`20`20`20FRED
X`20`20`20NODE::JIM
X`20`20`20NODE::JIM,FRED
X
XThere`20are`20two`20small`20problems`20to`20watch`20out`20for.`20Firstly,`20th
Ve`20use`20of`20
Xdistribution`20lists`20requires`20an`20@`20symbol`20to`20precede`20a`20file
V`20specification`20which`20
Xcontains`20the`20recipient`20names.`20Used`20directly,`20DCL`20intercepts`20th
Ve`20@`20before`20mail`20
Xdoes,`20and`20so`20the`20command`20does`20not`20work`20correctly.`20To`20avoid
V`20this,`20define`20a`20
Xlogical`20name`20to`20point`20at`20the`20distribution`20list`20and`20specify
V`20the`20logical`20name`20as`20
Xthe`20recipient.`20For`20example:
X
X`20`20`20$`20DEFINE`20USERS`20"@BETA_TEST_USERS.DIS"
X`20`20`20$`20PAKMAIL`20USERS`20...
X
XSecondly,`20usernames`20that`20contain`20quotes`20(")`20need`20special`20atten
Vtion`20because`20of`20
Xthe`20way`20DCL/MAIL`20parse`20quoted`20strings.`20Typically,`20this`20is`20im
Vportant`20when`20
Xsending`20network`20mail`20as`20the`20usual`20form`20of`20address`20is:
X
X`20`20`20NET%"user@site"
X
XIn`20this`20instance,`20the`20quotes`20must`20be`20doubled,`20with`20another
V`20set`20around`20each`20
Xto`20give`20an`20address`20specification`20of:
X
X`20`20`20NET%"""user@site"""
X
X
X
X5.2`20File`20specification
X
XThe`20file`20specification`20gives`20the`20name`20of`20the`20package`20to`20be
V`20sent.`20It`20should`20be`20
Xthe`20share`20file`20template`20name`20-`20omitting`20the`20part`20numbers.
V`20For`20example,`20a`20
Xspecification`20of`20"PACKAGE."`20will`20cause`20the`20package`20to`20send`20t
Vhese`20files:
X
X`20`20`20PACKAGE.01-OF-10
X`20`20`20PACKAGE.02-OF-10
X`20`20`20...
X`20`20`20PACKAGE.10-OF-10
X
X
X
X
X5.3`20Maximum`20Parts`20specification
X
XThis`20is`20simply`20the`20total`20number`20of`20parts`20in`20the`20package.
V`20It`20controls`20how`20many`20
Xfiles`20to`20be`20sent`20to`20each`20recipient.
X
X
XA`20typical`20example`20of`20a`20PAKMAIL`20command`20would`20be
X
X`20`20`20$`20PAKMAIL`20NET%"""FRED@SCROUNGING-SITE"""`20PACKAGE.TEST`205
X
X
X
X5.4`20Partlist`20Specification
X
XBy`20default,`20all`20parts`20of`20the`20package`20are`20sent.`20On`20occasion
V,`20it`20may`20be`20necessary
Xto`20resend`20a`20subset`20of`20the`20package.`20This`20parameter`20allows`20a
V`20list`20of`20parts`20to`20be
Xgiven`20and`20only`20those`20parts`20will`20be`20sent.`20The`20list`20is`20a
V`20comma`20separated`20set`20of
Xpart`20numbers.
X
X
XFor`20example:
X
X`20`20`20$`20PAKMAIL`20NET%"""FRED@SCROUNGING-SITE"""`20PACKAGE.TEST`205`204,2
V
X`20`20`20`20`20`20`20`20The`20addition`20of`20the`20"4,2"`20parameter`20restri
Vcts`20the`20parts`20sent`20out`20to
X`20`20`20`20`20`20`20`20parts`204`20and`202.
X
X
X5.5`20Comment`20specification
X
XThe`20subject`20line`20of`20the`20mail`20message`20sent`20to`20each`20recipien
Vt`20identifies`20the`20
Xpackage,`20which`20part`20and`20the`20total`20number`20of`20parts`20in`20the
V`20form:
X
X`20`20`20Subj:`20PACKAGE.1-OF-5
X
X
XOptionally`20a`20further`20parameter`20can`20be`20given`20on`20the`20PAKMAIL
V`20command.`20This`20
Xparameter`20will`20be`20inserted`20verbatim`20into`20the`20subject`20line.
X
XFor`20example,`20if`20this`20command`20is`20issued:
X
X`20`20`20$`20PAKMAIL`20NET%"""FRED@SCROUNGING-SITE"""`20PACKAGE`205`20""`20"(B
Veta-Test`20v2)"
X
X(Note`20the`20use`20of`20a`20placeholder`20as`20the`20fourth`20parameter`20if
V`20a`20partlist`20is`20not
Xrequired).
X
XThen`20the`20generated`20subject`20line`20would`20look`20like`20this:
X
X`20`20`20Subj:`20PACKAGE.1-OF-5`20(Beta-Test`20v2)
X`0C
X6.`09HOW`20TO`20UNPACK`20A`20SHARE`20FILE
X
X6.1`20Command`20file
X
XA`20share`20file`20is`20designed`20to`20be`20run`20as`20a`20command`20procedur
Ve`20which`20will`20recreate`20
Xthe`20original`20source`20files.`20So`20in`20theory,`20it`20is`20simply`20nece
Vssary`20to`20extract`20the`20
Xreceived`20mail`20message`20into`20a`20file,`20remove`20the`20mail`20headers,
V`20and`20then`20run`20it`20as`20
Xa`20command`20procedure.
X
XFor`20a`20single`20part`20share`20file,`20the`20following`20sequence`20of`20co
Vmmands`20is`20necessary:
X
X`20`20`20`20`20$`20SET`20DEFAULT`20<scratch`20directory>
X`20`20`20`20`20$`20MAIL
X`20`20`20`20`20MAIL>`20`20`20READ`20<share`20file`20message`20part`201>
X`20`20`20`20`20MAIL>`20`20`20EXTRACT/NOHEADER`20file
X`20`20`20`20`20MAIL>`20`20`20EXIT
X`20`20`20`20`20$
X`20`20`20`20`20$`20@file
X
X
X
X6.2`20Dealing`20with`20multiple`20part`20share`20files
X
XThe`20recipient`20of`20a`20multi-part`20package`20sent`20in`20this`20form`20wi
Vll`20receive`20a`20number
Xof`20separate`20mail`20messages`20-`20one`20per`20part`20-`20but`20not`20neces
Vsarily`20in`20the`20correct
Xnumeric`20order.`20These`20individual`20messages`20must`20be`20extracted`20and
V`20combined`20into
Xone`20file`20IN`20THE`20RIGHT`20ORDER.`20The`20exact`20sequence`20of`20events
V`20is`20similar`20to`20above
Xbut`20slightly`20complicated`20by`20the`20need`20to`20extract`20them`20in`20th
Ve`20right`20order`20and
Xappend`20them`20into`20a`20single`20file:`20
X
X`20`20`20`20`20$`20SET`20DEFAULT`20<scratch`20directory>
X`20`20`20`20`20$`20MAIL
X`20`20`20`20`20MAIL>`20`20`20READ`20<share`20file`20message`20part`201>
X`20`20`20`20`20MAIL>`20`20`20EXTRACT/NOHEADER`20`20`20`20`20`20`20`20file
X`20`20`20`20`20MAIL>`20`20`20READ`20<share`20file`20message`20part`202>
X`20`20`20`20`20MAIL>`20`20`20EXTRACT/NOHEADER/APPEND`20file
X`20`20`20`20`20MAIL>`20`20`20`20`20`20`20`20...`20repeat`20last`20two`20steps
V`20for`20each`20part`20in`20sequence
X`20`20`20`20`20MAIL>`20`20`20EXIT
X`20`20`20`20`20$
X`20`20`20`20`20$`20@file
X
XStrictly`20speaking,`20it`20is`20not`20necessary`20to`20remove`20the`20mail
V`20headers`20from`20each`20
Xpart`20except`20the`20first,`20as`20the`20share`20file`20format`20is`20designe
Vd`20to`20skip`20these`20
Xautomatically.
X
XIt`20is`20important`20to`20note`20that`20ALL`20parts`20must`20be`20extracted,
V`20and`20in`20the`20right
Xorder,`20before`20trying`20to`20unpack.`20It`20is`20not`20possible`20to`20unpa
Vck`20each`20part
Xindividually.`20
X
X
X
X
X7.`09REFERENCES
X
XThe`20following`20references`20provide`20further`20information`20on`20VMS_SHAR
VE`20and`20are`20
Xprovided`20with`20each`20release`20of`20the`20software.
X
X`5B1`5D`09VMS_SHARE`20Technical`20Information`20supplement
X`5B2`5D`09VMS_SHARE`20Release`20notes
X`5B3`5D`09On-line`20HELP
X`0C
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X`20`20`20`20`20`20----------------------------------------------------------
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20QUALIFIER`20REFERE
VNCE`20SECTION
X
X`20`20`20`20`20`20----------------------------------------------------------
X`0C
XQUALIFIER:
X`09`09/BACKUP
X
X
XPURPOSE:
X`09`09Specifies`20that`20the`20last`20backup`20date`20should`20be`20used`20for
V`20the
X`09`09purpose`20of`20date`20based`20file`20selection`20by`20the`20/BEFORE`20an
Vd
X`09`09/SINCE`20qualifiers
X
X
XDEFAULT:
X`09`09Use`20the`20last-modified`20date
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XPRIVILEGES`20REQUIRED:
X`09`09NONE
X
X
XDESCRIPTION:
X`09`09Files`20may`20be`20selected`20for`20packaging`20on`20the`20basis`20of
V`20the`20dates
X`09`09associated`20with`20the`20file,`20using`20the`20/BEFORE`20and`20/SINCE
X`09`09qualifiers.`20`20The`20/BACKUP`20qualifier`20says`20that`20the`20last
V`20backup
X`09`09date`20should`20be`20used`20as`20the`20comparison`20date.
X
X
XRESTRICTIONS:
X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
VORE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
V`20are`20mutually`20exclusive;`20only`20the`20last
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
X`0C
XQUALIFIER:
X`09`09/BEFORE`5B=date`5D
X
X
X
XPURPOSE:
X`09`09Specifies`20that`20all`20files`20selected`20must`20have`20a`20date`20ass
Vociated
X`09`09with`20them`20which`20is`20before`20the`20specified`20date.
X
X
XDEFAULT:
X`09`09The`20dates`20associated`20with`20a`20file`20are`20not`20used`20for`20se
Vlection
X`09`09purposes.
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XPRIVILEGES`20REQUIRED:
X`09`09NONE
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20DESCRIPTION:`20If`20either`20o
Vf`20the`20/SINCE`20or`20/BEFORE`20qualifiers`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specified,`20then`20each`20fil
Ve`20specified`20in`20the`20parameter`20list`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20checked`20to`20see`20if`20the
V`20date`20associated`20with`20the`20file`20is`20within
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20appropriate`20date`20ran
Vge.`20The`20file`20is`20selected`20for`20packaging
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20only`20if`20it`20does.`20No
V`20check`20is`20made`20if`20neither`20qualifier`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specified`20and`20the`20file
V`20is`20selected.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20There`20are`20four`20dates`20a
Vssociated`20with`20a`20file`20-`20Creation,`20Last
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Modified,`20Expiration`20and
V`20Last`20Backup.`20Any`20of`20these`20can`20be`20used
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20as`20the`20basis`20for`20selec
Vtion.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20To`20select`20which`20of`20the
V`20four`20dates`20to`20use,`20these`20qualifiers`20are
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20used:
X
X`09`09`20`20`20/BACKUP`09`09Last`20backup`20date`20used
X`09`09`20`20`20/CREATED`09`09Creation`20date`20used
X`09`09`20`20`20/EXPIRED`09`09Expiration`20date`20used
X`09`09`20`20`20/MODIFIED`09`09Last`20modified`20date`20used
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20To`20select`20the`20date`20ran
Vge,`20these`20qualifiers`20are`20used:
X
X`09`09`20`20`20/BEFORE`5B=date`5D`09Select`20files`20before`20the`20date
X`09`09`20`20`20/SINCE`5B=date`5D`09Select`20files`20after`20the`20date
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20neither`20qualifier`20is
V`20specified,`20then`20the`20corresponding
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20constraint`20on`20the`20date
V`20is`20lifted.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20It`20is`20permitted`20to`20use
V`20/SINCE`20and`20/BEFORE`20together`20to`20specify
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20both`20an`20earliest`20date
V`20and`20a`20latest`20date`20for`20the`20files.`20If`20no
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20date/time`20specification`20is
V`20given`20on`20either`20the`20/SINCE`20or
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/BEFORE`20qualifiers,`20then
V`20the`20default`20is`20"TODAY".
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Only`20one`20of`20/BACKUP,`20/
VCREATED,`20/EXPIRED`20or`20/MODIFIED`20should`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20used.`20If`20several`20are`20s
Vpecified`20only`20the`20last`20one`20is`20used.`20If
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20none`20are`20specified,`20/MOD
VIFIED`20is`20assumed.
X
X`09`09The`20format`20of`20the`20date`20specification`20is`20a`20standard`20VMS
V
X`09`09date/time`20specification`20with`20these`20exceptions:
X
X`09`09`20`20`20o`20The`20date/time`20spec`20must`20not`20contain`20spaces
X
X`09`09`20`20`20o`20The`20date/time`20spec`20must`20not`20be`20quoted
X
X`09`09`20`20`20o`20Missing`20fields`20are`20taken`20from`20the`20CURRENT`20dat
Ve/time`20and
X`09`09`20`20`20`20`20NOT`20from`20midnight`20as`20with`20other`20VMS`20command
Vs.
X
X
X
XEXAMPLES:
X`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/BEFORE
X
X`09`09Package`20all`20files`20modified`20before`20today
X
X`09`09
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
V`20/BEFORE=1-JAN-1992:00:00:00.00`20/CREATED
X
X`09`20`20`20`09Package`20all`20files`20created`20before`20this`20year
X
X`09`09
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
V`20/SINCE=YESTERDAY`20/BEFORE=TODAY`20/BACKUP
X
X`09`09Package`20all`20files`20that`20were`20backed`20up`20yesterday
X
X`09`09
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20Z`20/BEF
VORE=TODAY
X`09`09
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20will`20select`20all`20f
Viles`20which`20have`20a`20modified`20date`20(the
X`09`09default)`20before`20today's`20date.
X`0C
XQUALIFIER:
X`09`09/`5BNO`5DCOMPRESS`5B=n`5D
X
X
XPURPOSE:
X`09`09Select`20the`20level`20of`20compression`20performed`20on`20each`20file
V`20packaged
X
X
X
XDEFAULT:
X`09`09/NOCOMPRESS`09`09No`20compression`20is`20performed
X
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_COMPRESS
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
V`20be`20defined`20to`20any`20true`20or`20false`20value,`20or
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20to`20a`20numeric`20value`20wit
Vhin`20the`20range`200-2.`20The`20value`20determines
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20default`20for`20any`20su
Vbsequent`20run`20where`20the`20qualifier
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS`20is`20not`20used.
X
X
XPRIVILEGES`20REQUIRED:
X`09`09NONE
X
X
X
XDESCRIPTION:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20packages`20files
V`20in`20the`20original`20forms`20where`20possible.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20only`20codings`20made
V`20are`20to`20characters`20or`20bytes`20which`20may
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20prove`20troublesome`20if`20tra
Vnsmitted`20through`20a`20text`20based`20mail
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20system.`20So`20most`20printing
V`20characters`20should`20remain`20visible.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20various`20encodings`20ma
Vde`20to`20the`20file,`20to`20ensure`20trouble`20free
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20transmission,`20can`20increase
V`20the`20overall`20size`20significantly.`20No
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20attempt`20is`20made`20to`20com
Vpress`20the`20data`20to`20reduce`20this`20side
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20effect.`20However,`20additiona
Vl`20file`20compression`20may`20be`20selected`20if
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20required,`20in`20an`20attempt
V`20to`20reduce`20this`20overhead`20and`20hence`20speed
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20up`20transmission`20of`20the
V`20file`20through`20the`20mail`20system.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Two`20compression`20options
V`20are`20offered`20-`20the`20first`20is`20a`20simple
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20run-length`20encoding`20algori
Vthm`20to`20replace`20runs`20of`20the`20same
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20character`20by`20a`20shorter
V`20sequence,`20the`20second`20is`20a`20more`20complex
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20algorithm`20designed`20to`20se
Vek`20out`20common`20substrings`20in`20a`20file`20and
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20encode`20them`20to`20shorter
V`20sequences.`20The`20latter`20algorithm`20is`20based
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20heavily`20on`20one`20known`20a
Vs`20Lempel-Ziv,`20although`20it`20has`20been
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20significantly`20modified`20for
V`20use`20here.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20These`20compression`20qualifie
Vrs`20are`20recognized:
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOCOMPRESS`09`09`09N
Vo`20compression`20performed
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS`09`09`09Run
V-length`20compression
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS=0`20`20`20
V`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20No`20compression`20performed
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS=1`09`09`09R
Vun-Length`20compression
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS=2`09`09`09L
Vempel-Ziv`20compression
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20share`20file,`20when`20u
Vnpacked,`20will`20automatically`20expand`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20data`20back`20to`20its`20origi
Vnal`20form.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Selection`20of`20compression
V`20has`20two`20main`20effects:
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20First,`20in`20general,`20the
V`20overall`20size`20of`20the`20packaged`20files`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20reduced;`20the`20exact`20compr
Vession`20ratio`20will`20vary`20depending`20on`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20content`20of`20the`20file.`20I
Vn`20some`20cases,`20it`20may`20be`20of`20no`20benefit.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20implementation`20will
V`20never`20increase`20the`20size`20of`20a`20file
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20soley`20because`20of`20the`20a
Vdditional`20compression`20options`20chosen.`20
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Lempel-Ziv`20compression`20is
V`20considerably`20better`20than`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20run-length`20encoding`20mechan
Vism.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Second,`20It`20will`20generall
Vy`20take`20significantly`20longer`20to`20perform
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20additional`20compression`20on
V`20the`20file.`20Lempel-Ziv`20takes
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20significantly`20longer`20than
V`20run-length`20encoding`20(but`20does`20a
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20better`20job).
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20It`20is`20important`20to`20rec
Vognize`20the`20tradeoffs`20here;`20additional`20cpu
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20time`20is`20being`20traded`20f
Vor`20a`20potential`20(though`20not`20guaranteed)
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20reduction`20in`20the`20package
Vd`20file`20size.`20You`20should`20consider
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20whether`20it`20is`20really`20o
Vf`20benefit`20before`20selecting`20it.`20As`20a
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20general`20rule`20of`20thumb,
V`20select`20compression`20only`20if`20you`20are`20going
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20to`20place`20the`20package`20o
Vn`20a`20file`20server,`20where`20reduction`20in`20disk
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20space`20occupancy`20is`20desir
Vable,`20or`20if`20you`20intend`20to`20mail`20a`20very
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20large`20package`20to`20hundred
Vs`20of`20people,`20where`20a`20reduction`20in
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20network`20bandwidth`20is`20des
Virable.`20Otherwise,`20don't`20bother.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Note`20that`20the`20overhead
V`20involved`20in`20decompressing`20a`20file`20when`20it
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20is`20being`20unpacked`20from
V`20the`20sharefile`20is`20fairly`20small,`20and`20can
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20usually`20be`20ignored`20for
V`20the`20purposes`20of`20deciding`20upon`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20tradeoffs.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Note`20that`20the`20built-in
V`20compression`20schemes`20are`20not`20the`20best
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20available.`20They`20are`20inte
Vnded`20to`20provide`20reasonable`20compression
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20without`20resorting`20to`20ext
Vernal`20utilities,`20though`20at`20the`20cost`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20considerable`20packaging`20tim
Ve.`20Better`20or`20faster`20compression`20can
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20obtained`20using`20extern
Val`20utilities`20but`20this`20complicates`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20process`20of`20packaging`20fil
Ves`20and`20assumes`20that`20the`20recipient`20has
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20corresponding`20decompre
Vssion`20utilities.`20VMS_SHARE`20makes`20it
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20simple`20and`20does`20not`20re
Vquire`20the`20recipient`20to`20have`20any`20other
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20tools.
X
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
X
XEXAMPLES:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20COMPACT
V`20/COMPRESS
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20the`20files
V,`20using`20run`20length`20compression
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20COMPACT
V`20/COMPRESS=2
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20the`20files
V,`20using`20Lempel-Ziv`20compression
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DCONFIRM
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Require`20user`20confirmation
V`20of`20all`20files`20selected
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOCONFIRM`09User`20is`20not
V`20asked`20to`20confirm`20each`20file
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_CONFIRM
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
V`20be`20defined`20with`20a`20true`20or`20false`20value.`20It
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifies`20the`20default`20fo
Vr`20all`20subsequent`20executions`20which`20do
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20not`20specify`20the`20/COMPRES
VS`20qualifier
X
X
XPRIVILEGES`20REQUIRED:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XDESCRIPTION:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20selection`20of`20files
V`20for`20packaging`20can`20be`20automatic,`20or`20with
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20confirmation.`20With`20confirm
Vation,`20the`20user`20is`20asked`20about`20each
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20matching`20the`20qualif
Viers`20and`20parameters`20to`20see`20if`20it`20should
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20included`20in`20the`20pac
Vkage.`20A`20simple`20Y`20or`20N`20response`20is`20then
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20required`20from`20the`20user
V`20to`20select`20or`20not`20select`20it`20for
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20inclusion.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOCONFIRM`20specifies`20that
V`20confirmation`20is`20not`20required.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/CONFIRM`20specifies`20that
V`20confirmation`20is`20required.
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Because`20confirmation`20requi
Vres`20a`20response`20from`20the`20user,`20it`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20not`20permitted`20in`20non-int
Veractive`20environments.`20`20A`20warning
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20message`20will`20be`20issued
V`20and`20confirmation`20turned`20off.
X
X
XEXAMPLE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
V`20`20/CONFIRM
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Request`20confirmation`20from
V`20the`20user`20of`20each`20file`20selected.`20Each
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20requires`20a`20Y`20(to
V`20select)`20or`20a`20N`20(to`20not`20select)`20response.
X`0C
XQUALIFIER:
X`09`09/CREATED
X
X
XPURPOSE:
X`09`09Specifies`20that`20the`20creation`20date`20should`20be`20used`20for`20th
Ve
X`09`09purpose`20of`20date`20based`20file`20selection`20by`20the`20/BEFORE`20an
Vd
X`09`09/SINCE`20qualifiers
X
X
XDEFAULT:
X`09`09Use`20the`20last-modified`20date
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XPRIVILEGES`20REQUIRED:
X`09`09NONE
X
X
XDESCRIPTION:
X`09`09Files`20may`20be`20selected`20for`20packaging`20on`20the`20basis`20of
V`20the`20dates
X`09`09associated`20with`20the`20file,`20using`20the`20/BEFORE`20and`20/SINCE
X`09`09qualifiers.`20`20The`20/CREATED`20qualifier`20says`20that`20the`20creati
Von
X`09`09date`20should`20be`20used`20as`20the`20comparison`20date.
X
X
XRESTRICTIONS:
X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
VORE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
V`20are`20mutually`20exclusive;`20only`20the`20last
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
X
X`0C
XQUALIFIER:
X`09`09/`5BNO`5DDEBUG`5B=nnn`5D
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specify`20that`20debugging`20o
Vutput`20is`20to`20be`20produced;`20nnn`20is`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20level`20of`20debugging`20requi
Vred,`20from`200`20to`204.
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NODEBUG`09`09Debugging`20outp
Vut`20is`20OFF
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_DEBUG
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20logical`20name`20can`20b
Ve`20defined`20with`20any`20true`20or`20false`20value,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20an`20integer`20in`20the
V`20range`200-4.`20When`20defined,`20it`20will`20determine
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20default`20value`20for
V`20subsequent`20executions`20that`20do`20not`20specify
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20/DEBUG`20qualifier.
X
X
XPRIVILEGES`20REQUIRED:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Either`20SETPRV`20or`20SYSPRV
V`20required`20in`20the`20user's`20list`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20AUTHORIZED`20privileges
X
X
X
XDESCRIPTION:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20For`20developing`20VMS_SHARE,
V`20or`20investigating`20problems,`20it`20may`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20helpful`20to`20use`20the`20deb
Vugging`20code`20built`20into`20the`20package.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Several`20levels`20of`20debugg
Ving`20are`20built`20in`20-`20Level`200`20is`20no
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20debugging,`20level`204`20is
V`20the`20most`20detailed`20and`20verbose`20level`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20debugging.`20Debugging`20cause
Vs`20informational`20messages`20to`20be`20output
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20describing`20the`20state`20of
V`20VMS_SHARE`20and`20can`20be`20used`20to
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20investigate`20undocumented`20b
Vehaviour.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20following`20qualifier
V`20formats`20are`20recognized:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NODEBUG`09`09Debu
Vgging`20is`20off
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG`20`20`20
V`20`20`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`201
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=0`20`20`20
V`20`20`20`20`20`20`20`20`20Debugging`20is`20OFF
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=1`20`20`20
V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`201
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=2`20`20`20
V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`202
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=3`20`20`20
V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`203
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=4`20`20`20
V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`204
X
X
XRESTRICTIONS:
X`09`09NONE
X
X
XEXAMPLES:
X`20`20`20`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/NODEBUG
X`09`09`20`20`20`20`20`20Package`20files,`20with`20a`20debug`20level`20of`200
X
X`20`20`20`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/DEBUG
X`09`09`20`20`20`20`20`20Package`20files,`20with`20a`20debug`20level`20of`201
X
X`20`20`20`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/DEBUG=2
X`09`09`20`20`20`20`20`20Package`20files,`20with`20a`20debug`20level`20of`202
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DDIRECTORY
X
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Select`20preservation`20of`20s
Vubdirectory`20names`20on`20each`20file`20packaged
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20in`20order`20to`20re-create
V`20them`20during`20unpacking.
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DIRECTORY`09`09Directories
V`20are`20preserved
X
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_DIRECTORY
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
V`20be`20defined`20with`20any`20true`20or`20false`20value.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20defined`20it`20specifie
Vs`20the`20default`20value`20for`20all`20subsequent
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20executions`20that`20do`20not
V`20specify`20the`20/DIRECTORY`20qualifier.
X
X
XPRIVILEGES`20REQUIRED:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XDESCRIPTION:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20/NODIRECTORY`20is`20spe
Vcified,`20the`20subdirectory`20name`20of`20each
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20discarded`20and
V`20all`20files`20will`20be`20created`20in`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20directory`20current`20at`20the
V`20time`20of`20unpacking.`20The`20input`20files`20may
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20from`20any`20source`20at
V`20all,`20although`20care`20should`20be`20taken`20with
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20multiple`20input`20directories
V`20to`20ensure`20that`20clashing`20filenames`20do
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20not`20occur.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20/DIRECTORY`20is`20speci
Vfied,`20the`20subdirectory`20name`20of`20each
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20preserved`20so`20t
Vhat`20the`20unpacking`20process`20can`20recreate`20a
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20copy`20of`20the`20directory
V`20tree`20below`20thge`20current`20directory.`20The
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20input`20files`20must`20lie`20o
Vn`20the`20same`20disk`20at`20or`20below`20the`20current
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20subdirectory.`20`20This`20is
V`20to`20ensure`20that`20a`20well-defined`20set`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20directories`20are`20recreated
V`20at`20unpacking`20time.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20option`20is`20supplied
V`20primarily`20for`20compatibility`20with
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20previous`20versions`20of`20the
V`20utility`20which`20did`20not`20preserve`20version
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20numbers.
X
X
XRESTRICTIONS:
X`09`09NONE
X
X
XEXAMPLES:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20`5B...`5D*.*
V`20PACKAGE`20/DIRECTORY
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Preserve`20the`20subdirectory
V`20names`20to`20cause`20recreation`20of`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20directory`20tree`20when`20unpa
Vcked.
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20`5B...`5D*.*
V`20PACKAGE`20/NODIRECTORY
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Do`20not`20preserve`20director
Vy`20names;`20all`20files`20will`20be`20created`20in
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20current`20directory`20wh
Ven`20unpacked.`20Care`20must`20be`20taken`20to
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20avoid`20clashing`20file`20name
Vs.
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DEXCLUDE`5B=list`5D
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specify`20a`20list`20of`20file
V`20patterns`20which,`20if`20matched,`20prevent`20a
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20from`20being`20packaged
V.
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOEXCLUDE`09`09No`20files`20a
Vre`20excluded`20from`20packaging
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_EXCLUDE
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
V`20be`20defined`20with`20a`20comma`20separated`20list`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20partial`20file`20specification
Vs`20(see`20description`20below).`20When
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20defined,`20it`20specifies`20th
Ve`20default`20list`20of`20excluded`20files`20for
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20all`20subsequent`20executions
V`20that`20do`20not`20specify`20the`20/EXCLUDE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifier.
X
X
XPRIVILEGES`20REQUIRED:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XDESCRIPTION:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20will`20normally
V`20package`20up`20all`20files`20matching`20the`20file
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifications`20given`20on
V`20the`20command`20line.`20Sometimes,`20it`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20necessary`20to`20specifically
V`20exclude`20particular`20files.`20For
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20example,`20if`20generating`20a
V`20share`20file`20containing`20only`20sources,`20it
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20would`20be`20usual`20to`20excl
Vude`20all`20files`20with`20a`20type`20of`20.EXE`20or`20.OBJ
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20allows`20files`20t
Vo`20be`20excluded`20from`20the`20packaging
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20operation`20based`20upon`20any
V`20combination`20of`20the`20Directory,`20Name,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Type`20and`20Version`20fields
V`20of`20the`20filename.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20/EXCLUDE`20qualifier`20i
Vs`20used`20to`20specify`20a`20list`20of`20file
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20exclusion`20clauses:
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=list
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`60list'`20is`20a`20list`20of
V`20file`20specifications`20which`20match`20the`20files
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20to`20be`20excluded`20from`20th
Ve`20packaging`20operation.`20Each`20file
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specification`20may`20be`20any
V`20combination`20of`20directory,`20name,`20type
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20version`20field`20of`20a
V`20filename,`20with`20missing`20fields`20taken`20as
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20matching`20anything`20(equival
Vent`20to`20a`20`60*'`20wildcard`20in`20that
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20particular`20field).
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Although`20wildcards`20are`20s
Vupported,`20it`20is`20limited`20support`20only.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20wildcard`20may`20be`20us
Ved`20only`20to`20represent`20a`20COMPLETE`20field
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20(directory,`20name,`20type`20o
Vr`20version)`20and`20not`20a`20partial`20field.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20All`20directory`20names`20must
V`20be`20the`20full`20name.`20Relative`20directory
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifications`20are`20not`20p
Vermitted.
X
X
XEXAMPLES:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=.EXE`09`09Excludes
V`20all`20files`20with`20a`20type`20of`20.EXE
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=.EXE,.OBJ`09Excludes
V`20all`20files`20with`20a`20type`20of`20.EXE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`09`09`09or`20.OBJ
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=NAME.TXT`09Excludes
V`20all`20files`20called`20NAME.DAT`20in
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`09`09`09any`20directory
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=;1`09`09Exclude`20all
V`20version`201`20files
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=`5BXYZ`5D`09Exclude
V`20all`20files`20in`20directory`20`5BXYZ`5D
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Note`20that`20a`20wildcard`20c
Van`20be`20used`20to`20represent`20a`20whole`20field`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20specification`20but`20NO
VT`20a`20partial`20field.`20For`20example:
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VALID:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=*.FOR`09Excl
Vude`20all`20files`20with`20a`20type`20of`20.FOR
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20INVALID:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=XYZ*.FOR`09C
Vannot`20use`20the`20*`20as`20PART`20of`20a`20field
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`09`09`09specification
X`0C
XQUALIFIER:
X`09`09/EXPIRED
X
X
XPURPOSE:
X`09`09Specifies`20that`20the`20expiration`20date`20should`20be`20used`20for
V`20the
X`09`09purpose`20of`20date`20based`20file`20selection`20by`20the`20/BEFORE`20an
Vd
X`09`09/SINCE`20qualifiers
X
X
XDEFAULT:
X`09`09Use`20the`20last-modified`20date
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XPRIVILEGES`20REQUIRED:
X`09`09NONE
X
X
XDESCRIPTION:
X`09`09Files`20may`20be`20selected`20for`20packaging`20on`20the`20basis`20of
V`20the`20dates
X`09`09associated`20with`20the`20file,`20using`20the`20/BEFORE`20and`20/SINCE
X`09`09qualifiers.`20`20The`20/EXPIRED`20qualifier`20says`20that`20the`20expira
Vtion
X`09`09date`20should`20be`20used`20as`20the`20comparison`20date.
X
X
XRESTRICTIONS:
X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
VORE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
V`20are`20mutually`20exclusive;`20only`20the`20last
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
X
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DLOG`5B=nnn`5D
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specify`20that`20informational
V`20progress`20messages`20are`20to`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20displayed`20at`20various`20sta
Vges`20of`20the`20packaging.`20nnn`20specifies`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20level`20of`20information`20req
Vuired`20(0`20through`202).
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOLOG`09`09`09Suppress`20all
V`20informational`20messages
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_LOG
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
V`20be`20defined`20with`20any`20true`20or`20false`20value,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20an`20integer`20in`20the
V`20range`200-2.`20When`20defined,`20it`20specifies`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20default`20for`20all`20subseque
Vnt`20executions`20that`20do`20not`20specify`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/LOG`20qualifier.
X
X
XPRIVILEGES`20Required:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20DESCRIPTION:`20Each`20stage
V`20in`20the`20packaging`20process,`20typically`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20name`20of`20each`20file`20as
V`20it`20is`20processed,`20can`20be`20logged`20with`20an
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20informational`20message.`20The
V`20/LOG`5B=nnn`5D`20qualifier`20selects`20this
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20option.`20The`20value`20of`20n
Vnn`20is`20an`20integer`20(default`201)`20which
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20selects`20how`20much`20informa
Vtion`20is`20displayed.`20It`20may`20take`20values
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20between`200`20and`202,`20where
V`200`20is`20no`20logging`20and`202`20is`20the`20most
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20comprehensive`20logging.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOLOG`20suppresses`20all`20lo
Vg`20messages;`20this`20is`20the`20same`20as
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifying`20/LOG=0
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/LOG=n`20selects`20logging`20a
Vt`20level`20n.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20n=0`20turns`20all`20log`20mess
Vages`20off.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20n=1`20displays`20a`20log`20mes
Vsage`20for`20each`20file`20processed.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20n=2`20includes`20everything
V`20at`20n=1,`20with`20the`20addition`20of`20statistics
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20on`20the`20file`20compression
V`20before`20and`20after`20packaging.`20This`20can`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20useful`20for`20determining`20t
Vhe`20effectiveness`20(or`20otherwise)`20of`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20selected`20compression`20techn
Vique`20on`20a`20given`20file.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/LOG`20without`20a`20numeric
V`20value`20defaults`20to`20level`201`20logging.
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
X
XEXAMPLES:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
V`20/LOG
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files
V`20and`20log`20each`20one`20as`20it`20is`20processed.
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
V`20/LOG=2
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files,
V`20log`20each`20one`20as`20it`20is`20processed`20and`20show
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20compression`20statistics
V`20for`20each.
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DLONGLINES
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Allow`20VMS_SHARE`20to`20take
V`20advantage`20of`20the`20support`20for`20long
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20records`20in`20recent`20versio
Vns`20of`20VMS`20and`20TPU.
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOLONGLINES`09`09Long`20line
V`20support`20not`20enabled
X
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_LONGLINES
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
V`20be`20defined`20with`20any`20true`20or`20false`20value.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20defined,`20it`20specifi
Ves`20the`20default`20value`20for`20all`20subsequent
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20executions`20that`20do`20not
V`20specify`20the`20/LONGLINES`20qualifier.
X
X
XPRIVILEGES`20REQUIRED:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XDESCRIPTION:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20VMS_SHARE`20utility`20is
V`20layered`20upon`20the`20VAXTPU`20language.`20As
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20such,`20most`20of`20its`20rest
Vrictions`20are`20because`20of`20the`20limitations
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20of`20VAXTPU.`20One`20particula
Vr`20limitation`20is`20that`20of`20maximum`20record
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20length.`20Older`20versions`20o
Vf`20TPU`20(prior`20to`20VMS`205.4)`20allowed
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20records`20to`20be`20no`20longe
Vr`20than`20960`20bytes.`20This`20restricted`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20maximum`20record`20length`20of
V`20the`20files`20that`20could`20be`20packaged.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Versions`20of`20TPU`20at`20VMS
V`205.4`20and`20later`20allow`20much`20longer`20records,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20up`20to`2065535`20bytes.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20To`20maintain`20backwards`20co
Vmpatibility,`20the`20old`20record`20length`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20used`20unless`20requested`20ot
Vherwise.
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/NOLONGLINES`20is`20speci
Vfied,`20then`20the`20following`20restrictions
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20apply:
X`09`09`09o`20Records`20may`20be`20no`20longer`20than`20960`20bytes
X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20run`20is`205.0
X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20unpack`20is`204.4
X
X`09`09If`20/LONGLINES`20is`20specified,`20then`20the`20following`20restriction
Vs
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20apply:
X`09`09`09o`20Records`20may`20be`20up`20to`2065535`20bytes
X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20run`20is`205.4
X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20unpack`20is`205.4
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20An`20important`20use`20for`20t
Vhe`20/LONGLINES`20qualifier`20is`20to`20allow
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20BACKUP`20savesets`20to`20be
V`20directly`20packaged.`20These`20have`20a`20minimum
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20record`20length`20of`202048
V`20bytes`20so`20/LONGLINES`20is`20required.`20This
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20provides`20a`20convenient`20me
Vchanism`20for`20shipping`20VMSINSTALable
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20products,`20and`20any`20type
V`20of`20file`20(including`20INDEXED`20and
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20RELATIVE).`20
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20It`20is`20helpful`20to`20recog
Vnize`20when`20to`20use`20and`20when`20not`20to`20use`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20long`20line`20support:
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20First,`20there`20is`20NO`20adv
Vantage`20if`20none`20of`20the`20files`20to`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20packaged`20have`20records`20gr
Veater`20than`20960`20bytes.`20In`20fact`20this`20may
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20turn`20out`20to`20be`20detrime
Vntal`20for`20the`20recipient`20as`20we`20mention
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20below.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Secondly,`20using`20it`20requi
Vres`20that`20the`20current`20version`20of`20VMS`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20at`20least`205.4.`20An`20error
V`20is`20issued`20if`20not.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Finally,`20the`20recipient`20o
Vf`20the`20share`20file`20will`20require`20VMS`205.4
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20greater`20in`20order`20to
V`20unpack`20it`20(if`20it`20needed`20long`20line
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20support`20to`20pack`20it,`20it
+-+-+-+-+-+-+-+-  END  OF PART 8 +-+-+-+-+-+-+-+-