🚀 go-pugleaf

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

-+-+-+-+-+-+-+-+ START OF PART 9 -+-+-+-+-+-+-+-+
V`20will`20also`20need`20long`20line`20support`20to
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unpack`20it!).`20This`20is`20t
Vrue`20even`20if`20none`20of`20the`20files`20have`20lines
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20longer`20than`20960.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20option`20is`20only`20va
Vlid`20with`20VMS`205.4`20and`20above.`20Note
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20therefore`20that`20BACKUP`20sa
Vvesets`20can`20only`20be`20packaged`20on`20VMS`205.4
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20systems`20and`20later,`20and
V`20require`20a`20similar`20system`20to`20unpack.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20examines`20the`20f
Vile`20header`20to`20determine`20the`20maximum
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20record`20size`20in`20the`20fil
Ve.`20If`20it`20exceeds`20the`20maximum`20record
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20length`20supported,`20then`20t
Vhe`20file`20is`20rejected.`20However,`20certain
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20types`20of`20record`20structur
Ve`20have`20misleading`20information`20stored
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20about`20the`20maximum`20record
V`20length`20(usually`20a`200`20value`20to`20indicate
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unknown`20or`20no`20fixed`20ma
Vximum).`20These`20files`20may`20be`20selected`20for
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20packaging`20but`20subsequently
V`20turn`20out`20to`20have`20records`20that`20are
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20too`20long,`20giving`20errors
V`20at`20either`20the`20packing`20or`20unpacking
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20stages,`20depending`20on`20the
V`20various`20combinations`20of`20VMS`20used.
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/LONGLINES
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files
V`20in`20the`20current`20directory,`20with`20long`20lines
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20support
X
X`09`09$`20BACKUP/BLOCK=2048`20`5B...`5D*.*;*`20`20PACKAGE.BCK/SAVE
X`09`09$`20VMS_SHARE`20PACKAGE.BCK`20PACKAGE`20/LONGLINES`20/COMPRESS
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Would`20be`20a`20means`20of
V`20packaging`20a`20complete`20subdirectory`20tree
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20containing`20any`20mixture`20o
Vf`20files.`20
X`0C
XQUALIFIER:
X`09`09/MODIFIED
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specifies`20that`20the`20last
V`20modified`20date`20should`20be`20used`20for`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20purpose`20of`20date`20based
V`20file`20selection`20on`20the`20/BEFORE`20and`20/SINCE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`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`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Files`20may`20be`20selected
V`20for`20packaging`20on`20the`20basis`20of`20the`20dates
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20associated`20with`20the`20file
V,`20using`20the`20/BEFORE`20and`20/SINCE
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers.`20`20The`20/MODIFI
VED`20qualifier`20says`20that`20the`20last
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20modified`20date`20should`20be
V`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`5DPACKAGE_INDEX`5B=suff
Vix`5D
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Select`20the`20automatic`20cre
Vation`20of`20a`20package`20index`20file`20for`20use
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20by`20file`20servers.
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOPACKAGE_INDEX`09No`20packag
Ve`20index`20file`20is`20created
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_PACKAGE_INDEX
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`20any`20true/false`20value`20OR
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20with`20a`20specific`20file`20t
Vype`20field`20(starting`20with`20a`20dot).`20If
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20defined,`20it`20specifies`20th
Ve`20default`20for`20all`20subsequent`20executions
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20that`20do`20not`20specify`20th
Ve`20/PACKAGE_INDEX`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`20content`20of`20the`20pac
Vkage`20index`20file`20is`20a`20list`20of`20the`20parts`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20sharefile`20containing
V`20all`20the`20packaged`20files,`20one`20name`20per
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20line.`20Only`20the`20name`20pa
Vrt`20and`20the`20type`20part`20are`20listed.`20It`20is
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20common`20to`20find`20such`20pa
Vckage`20files`20on`20mail`20based`20file`20servers,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20where`20a`20number`20of`20file
Vs`20may`20be`20retrieved`20by`20issuing`20a`20single
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20request`20for`20the`20p
Vackage.`20Each`20file`20listed`20in`20the`20package
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20index`20file`20will`20be`20sen
Vt`20in`20response`20to`20the`20request.
X
X`09`09If`20/NOPACKAGE_INDEX`20is`20specified,`20then`20no`20package`20index
V`20file
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20will`20be`20created.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/PACKAGE_INDEX`20is`20spe
Vcified,`20then`20a`20package`20index`20file`20will
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20created.`20This`20file
V`20be`20have`20the`20same`20name`20as`20the`20individual
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20parts`20of`20the`20generated
V`20share`20file`20but`20with`20a`20file`20type`20of
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20".$PACKAGE".
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/PACKAGE_INDEX=suffix`20i
Vs`20specified,`20the`20"suffix"`20string`20must
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20a`20file`20type.`20This
V`20creates`20the`20package`20index`20file,`20as`20above,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20but`20with`20the`20specified
V`20suffix`20as`20the`20file`20type.`20suffix`20must`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20a`20valid`20file`20type,`20inc
Vluding`20the`20leading`20period`20character.
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
X
X
XEXAMPLES:
X`20`20`20`09`09$`20VMS_SHARE`20*.*`20FILESERV:ZIPPO`20/PACKAGE_INDEX
X
X`09`09Creates`20the`20package`20files`20as`20a`20series`20of`20parts`20called
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.nnn-OF-mmm`20in`20the
V`20directory`20FILESERV:.`20The`20package`20index
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20created`20in`20thi
Vs`20directory`20too`20and`20is`20named
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.$PACKAGE.
X
X
X`20`20`20`09`09$`20VMS_SHARE`20*.*`20FILESERV:ZIPPO`20/PACKAGE_INDEX=.LIBRARY
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Creates`20the`20package`20file
Vs`20as`20a`20series`20of`20parts`20called
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.nnn-OF-mmm`20in`20the
V`20directory`20FILESERV:.`20The`20package`20index
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20created`20in`20thi
Vs`20directory`20too`20and`20is`20named
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.LIBRARY
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/PART_SIZE=nnn
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20PURPOSE:`20Define`20the`20maxi
Vmum`20size`20in`20blocks`20of`20each`20part`20of`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20generated`20share`20file.
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/PART_SIZE=30`09`09Part`20size
V`20is`2030`20blocks
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_PART_SIZE
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`20positive`20numeric`20value
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20indicating`20the`20maximum`20s
Vize`20of`20a`20part`20in`20blocks.`20If`20defined,`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`20that`20do`20not
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specify`20the`20/PART_SIZE`20q
Vualifier.
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:`20Some`20mail`20s
Vystems`20are`20known`20to`20truncate`20mail
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20messages`20if`20they`20are`20l
Varger`20than`20a`20certain`20size.`20Experience`20has
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20shown`20that`20messages`20of
V`2032`20blocks`20or`20less`20are`20fairly`20safe`20from
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20this`20problem.`20Thus`20the
V`20default`20part`20size`20is`2030`20blocks,`20allowing
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`202`20blocks`20for`20the`20addit
Vional`20mail`20headers`20that`20accumulate`20on`20the
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20journey`20through`20the`20netw
Vork.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20it`20is`20known`20that
V`20larger`20messages`20can`20pass`20unscathed,`20then
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20part`20size`20can`20be
V`20increased.`20using`20the`20/PART_SIZE=n
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifier`20(where`20n`20is
V`20the`20part`20size`20in`20blocks).
X`20
X
X
XRESTRICTIONS:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Although`20there`20are`20no
V`20restrictions`20on`20the`20part`20size`20that`20can`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specified,`20too`20small`20a
V`20value`20can`20cause`20packaging`20to`20fail.`20This
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20is`20because`20certain`20parts
V`20of`20the`20generated`20share`20file`20must`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20kept`20together`20in`20one`20f
Vile.`20If`20VMS_SHARE`20is`20unable`20to`20do`20this
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20because`20the`20part`20isze
V`20is`20too`20small,`20an`20error`20message`20will`20be
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20issued`20and`20the`20part`20si
Vze`20should`20be`20increased.
X
X
XEXAMPLES:
X`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/PART_SIZE=100
X`09`09
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Collect`20all`20files`20in`20t
Vhe`20current`20directory`20into`20a`20multi-part
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20package`20called`20"PACKAGE",
V`20where`20each`20part`20is`20no`20larger`20than`20100
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20blocks.
X`0C
XQUALIFIER:
X`09`09/SINCE`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`20at`20or`20after`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*.*`20Z`20/SINCE=TODAY
X
X`09`09This`20will`20select`20all`20files`20which`20have`20a`20modified`20date
V`20(the
X`09`09default)`20at`20or`20after`20today's`20date.
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20Z`20/SIN
VCE=YESTERDAY`20/BEFORE=TODAY
X
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`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20default)`20sometime`20during
V`20yesterday.
X`0C
XQUALIFIER:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DVERSION
X
X
XPURPOSE:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Select`20the`20preservation
V`20of`20version`20numbers`20across`20the`20packaging
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20operation.
X
X
XDEFAULT:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/VERSION`09`09Version`20number
Vs`20are`20preserved
X
X
XASSOCIATED`20LOGICAL`20NAME:
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_VERSION
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`20any`20true`20or`20false`20value.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20defined,`20it`20specifies
V`20the`20default`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/VERSION`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`20Version`20numbers`20may`20be
V`20preserved`20across`20the`20packaging`20operation
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20if`20required.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/NOVERSION`20is`20specifi
Ved,`20version`20numbers`20are`20not`20preserved.
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20During`20unpacking,`20files
V`20will`20be`20created`20with`20the`20next`20highest
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20available`20version`20number.
V`20If`20a`20previous`20version`20already`20exists,
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20a`20warning`20message`20will
V`20be`20issued.
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20IF`20/VERSION`20is`20specified
V,`20version`20numbers`20are`20preserved.`20During
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unpacking,`20files`20will`20be
V`20created`20with`20the`20same`20version`20number
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20irrespective`20of`20any`20othe
Vr`20versions`20that`20may`20exist.`20However,`20if
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20specific`20version`20num
Vber`20is`20already`20in`20use,`20a`20warning
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20message`20is`20issued`20and
V`20the`20file`20is`20not`20re-created.
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`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
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/NOVERSION
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files
V`20but`20do`20not`20preserve`20the`20version`20numbers.
X
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*;*`20PACKAG
VE`20/VERSION
X
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20versions`20of
V`20each`20file`20in`20the`20current`20directory`20and
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20preserve`20the`20version`20num
Vbers`20to`20keep`20them`20distinct`20when
X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unpacked.
X`0C
X`09`09`20`20`20`20`20`20A`20P`20P`20E`20N`20D`20I`20X`20`20`20A
X
X`09`09R`20E`20D`20U`20N`20D`20A`20N`20T`20`20`20F`20E`20A`20T`20U`20R`20E`20S
X
X
XThe`20features`20described`20in`20this`20appendix`20are`20still`20available
V`20but`20are`20superceded
Xby`20alternative`20mechanisms.`20They`20will`20be`20withdrawn`20in`20future
V`20releases`20of`20the
Xutility.
X
X
XB.1`09File`20Exclusions
X
XVMS_SHARE`20allows`20files`20to`20be`20excluded`20on`20the`20basis`20of`20dire
Vctory,`20name,`20type,`20or
Xfilename`20(Combined`20name`20and`20type).`20The`20list`20of`20items`20to`20be
V`20excluded`20are`20passed
Xto`20VMS_SHARE`20by`20means`20of`20logical`20names.`20Each`20logical`20name
V`20contains`20a`20comma
Xseparated`20list`20of`20the`20exclusions.`20Wildcards`20are`20not`20permitted
V`20and`20directories
Xmust`20be`20given`20in`20full.
X
X`20`20Logical`20Name`09`09Content`09`09`09Example
X
X`20`20SHARE_EXCLUDE_DIRS`09List`20of`20directories`09"`5BA.B`5D,`5BA.XYZ.C`5D"
V
X`20`20SHARE_EXCLUDE_NAMES`09List`20of`20names`09`09"FRED,JIM,BERT,TEST"
X`20`20SHARE_EXCLUDE_TYPES`09List`20of`20types`09`09".OBJ,.EXE,.OLB"
X`20`20SHARE_EXCLUDE_FILES`09List`20of`20name+types`09"Z.DAT,FILE.IDX"
X
XEach`20file`20matching`20the`20file`20specification`20given`20as`20a`20paramet
Ver`20is`20check`20to`20see
Xif`20it`20matches`20any`20of`20the`20exclusions.`20If`20so,`20it`20is`20not
V`20selected.
X
XFor`20example:
X
XThe`20above`20settings`20will`20exclude`20any`20file`20in`20the`20directories
V`20`5BA.B`5D`20and
X`5BA.XYZ.C`5D;`20any`20file`20with`20a`20name`20of`20FRED,`20JIM,`20BERT`20or
V`20TEST;`20any`20file`20with`20a
Xtype`20of`20.OBJ,`20.EXE`20or`20.OLB;`20and`20any`20file`20called`20Z.DAT,`20F
VILE.IDX`20in`20any
Xdirectory.
X
XThe`20functionality`20of`20the`20above`20has`20been`20replaced`20by`20the`20/E
VXCLUDE`20qualifier`20and
Xthe`20SHARE_EXCLUDE`20logical`20name.`20However,`20files`20specified`20by`20th
Vese`20logical`20names
Xwill`20be`20added`20to`20the`20list`20specified`20by`20SHARE_EXCLUDE`20and`20w
Vill`20be`20overridden`20by
Xthe`20use`20of`20the`20/EXCLUDE`20qualifier.
$ call unpack VMS_SHARE.USER_GUIDE;33 70361547 ""
$ v=f$verify(v)
$ exit