🚀 go-pugleaf

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

-+-+-+-+-+-+-+-+ START OF PART 5 -+-+-+-+-+-+-+-+
X
X`20`20/BEFORE`20without`20a`20date`20specification`20implies`20midnight`20on
V`20the
X`20`20current`20day`20I.E.`20is`20equivalent`20to
X`20`20/BEFORE=xx-mmm-yyyy:00:00:00.00
X
X`20`20Used`20in`20conjunction`20with`20the`20/SINCE`20qualifier`20allows`20fil
Ves`20to
X`20`20be`20selected`20within`20a`20range`20of`20dates.
X
X/COMPRESS
X
X`20`20/`5BNO`5DCOMPRESS`5B=n`5D
X
X`20`20Selects`20additional`20compression.`20The`20value`20of`20the`20integer
V`20n
X`20`20determines`20the`20type`20of`20compression`20attempted.
X
X`20`20If`20n`20is`200,`20no`20additional`20compression`20is`20attempted.`20Thi
Vs`20is
X`20`20equivalent`20to`20/NOCOMPRESS.
X
X`20`20If`20n`20is`201,`20then`20run-length`20encoding`20compression`20is`20sel
Vected.
X`20`20Each`20file`20packaged`20is`20searched`20for`20sequences`20(runs)`20of
V`20the`20same
X`20`20character`20and`20each`20run`20is`20encoded`20into`20a`20shorter`20seque
Vnce.`20This
X`20`20is`20equivalent`20to`20/COMPRESS`20without`20a`20numeric`20value`20attac
Vhed.
X
X`20`20If`20n`20is`202,`20then`20a`20modified`20form`20of`20Lempel-Ziv`20compre
Vssion`20is
X`20`20selected.`20Each`20file`20packaged`20is`20searched`20for`20common`20subs
Vtrings
X`20`20and`20occurences`20after`20the`20first`20are`20encoded`20where`20possibl
Ve`20to`20a
X`20`20shorter`20sequence.
X
X`20`20This`20option`20is`20time`20consuming`20so`20the`20normal`20default`20is
V
X`20`20/NOCOMPRESS
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_COMPRESS.
X
X/CONFIRM
X
X`20`20/`5BNO`5DCONFIRM
X
X`20`20Selects`20user`20confirmation`20of`20files`20selected`20for`20packaging.
V`20Each
X`20`20file`20selected`20by`20parameters`20and`20qualifiers`20is`20displayed
V`20and`20the
X`20`20user`20must`20enter`20Y`20to`20select`20it`20or`20N`20not`20to`20select
V`20it.`20The
X`20`20default`20selection`20is`20N.`20If`20a`20file`20is`20not`20selected,`20t
Vhen`20it`20is
X`20`20not`20packaged.
X
X`20`20Confirmation`20is`20only`20permitted`20in`20an`20INTERACTIVE`20mode.`20I
Vn`20any
X`20`20other`20mode,`20a`20warning`20message`20is`20issued`20and`20confirmation
V`20is
X`20`20turned`20off.
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_CONFIRM.
X
X/CREATED
X
X`20`20/CREATED
X
X`20`20Specifies`20that`20files`20selected`20on`20the`20basis`20of`20date`20(vi
Va`20the
X`20`20/BEFORE`20and/or`20/SINCE`20qualifiers)`20should`20use`20the`20`60creati
Von
X`20`20date'`20as`20the`20basis`20of`20selection.
X
X`20`20If`20any`20combination`20of`20/BACKUP,`20/CREATED,`20EXPIRED`20and`20/MO
VDIFIED
X`20`20are`20specified`20together,`20then`20only`20the`20last`20one`20specified
V`20takes
X`20`20effect.
X
X`20`20The`20default`20is`20to`20use`20the`20`60last`20modified`20date'.
X
X/DEBUG
X
X`20`20/`5BNO`5DDEBUG`5B=n`5D
X
X`20`20Selects`20debugging.`20Additional`20trace`20messages`20are`20output`20to
V
X`20`20assist`20developers`20of`20the`20utility.`20It`20can`20only`20be`20selec
Vted`20if
X`20`20the`20user`20is`20suitably`20privileged.`20The`20normal`20default`20is
V`20/NODEBUG
X
X`20`20The`20/DEBUG`20qualifier`20selects`20a`20particular`20level`20of`20debug
Vging;
X`20`20the`20higher`20the`20level,`20the`20more`20extensive`20and`20detailed
V`20are`20the
X`20`20debug`20messages.`20A`20level`20of`200`20is`20equivalent`20to`20/NODEBUG
V,`20a`20level
X`20`20of`201`20is`20equivalent`20to`20/DEBUG.`20The`20maximum`20level`20curren
Vtly
X`20`20supported`20is`204.
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_DEBUG.
X
X/DIRECTORY
X
X`20`20/`5BNO`5DDIRECTORY
X
X`20`20Selects`20the`20directory`20preservation`20option.`20When`20selected,
V`20the
X`20`20directory`20name`20is`20preserved`20on`20each`20file`20packaged,`20such
V`20that`20the
X`20`20unpacking`20operation`20will`20recreate`20the`20directory`20structure.
V`20If`20not
X`20`20selected,`20then`20the`20directory`20name`20will`20not`20be`20preserved
V`20and`20each`20file
X`20`20will`20be`20unpacked`20into`20the`20current`20directory.
X
X`20`20If`20/NODIRECTORY`20is`20selected,`20then`20the`20files`20to`20be`20pack
Vaged`20may`20exist
X`20`20anywhere`20in`20the`20system.`20`20If`20/DIRECTORY`20is`20selected,`20th
Ven`20the`20files`20to
X`20`20be`20packaged`20must`20exist`20at`20or`20below`20the`20current`20directo
Vry`20and`20the
X`20`20relative`20directory`20name`20will`20be`20recorded`20in`20the`20share
V`20file.
X
X`20`20The`20default`20is`20/DIRECTORY,`20to`20preserve`20the`20directory`20str
Vucture,`20but
X`20`20this`20can`20be`20overidden`20by`20defining`20the`20logical`20name`20SHA
VRE_DIRECTORY.
X
X/EXCLUDE
X
X`20`20/`5BNO`5DEXCLUDE`5B=list`5D
X
X`20`20Specifies`20that`20files`20matching`20any`20of`20the`20specifications
V`20given
X`20`20by`20`60list'`20are`20to`20be`20excluded`20from`20the`20packaging`20oper
Vation.`20Each
X`20`20file`20specification`20in`20the`20list`20may`20be`20any`20combination
V`20of`20the
X`20`20directory,`20name,`20type`20and`20version`20fields.`20Missing`20fields
V`20are
X`20`20assumed`20to`20be`20`60*'`20(meaning`20anything).
X
X`20`20An`20`60*'`20may`20only`20be`20used`20to`20represent`20a`20complete`20fi
Veld.`20It`20may
X`20`20NOT`20be`20used`20to`20represent`20a`20partial`20field.`20E.G.`20`20`5B*
V`5D`20is`20allowed,
X`20`20but`20`5BXYZ*`5D`20is`20not.
X
X`20`20By`20default,`20no`20files`20are`20excluded.
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20up`20by
V`20the
X`20`20logical`20name`20SHARE_EXCLUDE.`20Note`20that`20it`20does`20NOT`20overri
Vde`20any
X`20`20defaults`20set`20up`20by`20the`20logical`20names`20SHARE_EXCLUDE_NAMES,
X`20`20SHARE_EXCLUDE_DIRS,`20SHARE_EXCLUDE_TYPES`20and
X`20`20SHARE_EXCLUDE_FILES.`20However,`20these`20logicals`20will`20be`20removed
V`20in
X`20`20a`20future`20release`20and`20should`20be`20avoided.
X
X/EXPIRED
X
X`20`20/EXPIRED
X
X`20`20Specifies`20that`20files`20selected`20on`20the`20basis`20of`20date`20(vi
Va`20the
X`20`20/BEFORE`20and/or`20/SINCE`20qualifiers)`20should`20use`20the`20`60expira
Vtion
X`20`20date'`20as`20the`20basis`20of`20selection.
X
X`20`20If`20any`20combination`20of`20/BACKUP,`20/CREATED,`20EXPIRED`20and`20/MO
VDIFIED
X`20`20are`20specified`20together,`20then`20only`20the`20last`20one`20specified
V`20takes
X`20`20effect.
X
X`20`20The`20default`20is`20to`20use`20the`20`60last`20modified`20date'.
X
X/LOG
X
X`20`20/`5BNO`5DLOG
X
X`20`20Selects`20logging.`20Informational`20messages`20are`20output`20to`20the
V`20user
X`20`20to`20identify`20various`20stages`20in`20the`20packaging`20operation.`20T
Vhe
X`20`20normal`20default`20is`20/NOLOG
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_LOG.
X
X/LONGLINES
X
X`20`20/`5BNO`5DLONGLINES
X
X`20`20Selects`20long`20line`20support.`20The`20underlying`20TPU`20package`20re
Vstricts
X`20`20the`20maximum`20record`20length`20of`20a`20file`20to`20be`20packaged.
V`20Older
X`20`20versions`20(pre-5.4)`20restrict`20the`20length`20to`20960`20bytes;`20new
Ver
X`20`20versions`20(post-5.4)`20allow`20up`20to`2065535`20bytes`20per`20record.
V`20For
X`20`20compatibility,`20the`20older`20record`20length`20is`20used`20(/NOLONGLIN
VES).
X`20`20If`20long`20lines`20are`20selected,`20then`20the`20underlying`20VMS`20mu
Vst`20be`20at
X`20`20least`20VMS`205.4`20and`20the`20generated`20share`20file`20will`20requir
Ve`20at
X`20`20least`20VMS`205.4`20to`20unpack.
X
X`20`20There`20is`20no`20advantage`20in`20selecting`20this`20option`20if`20none
V`20of`20the
X`20`20files`20to`20be`20packaged`20have`20records`20longer`20than`20960`20byte
Vs.`20In
X`20`20fact,`20it`20will`20be`20a`20disadvantage`20if`20the`20share`20file`20is
V`20to`20be
X`20`20unpacked`20on`20an`20older`20version`20of`20VMS.
X
X`20`20For`20some`20types`20of`20file,`20the`20maximum`20record`20size`20is`20s
Vtored`20as`200
X`20`20in`20the`20file`20header;`20this`20may`20lead`20to`20some`20files`20with
V`20long`20lines
X`20`20not`20being`20detected`20during`20packaging.`20If`20the`20long`20lines
V`20option
X`20`20has`20NOT`20been`20selected`20then`20the`20created`20share`20file`20may
V`20not
X`20`20unpack`20properly`20under`20early`20versions`20of`20VMS.
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_LONGLINES.
X
X/MODIFIED
X
X`20`20/MODIFIED
X
X`20`20Specifies`20that`20files`20selected`20on`20the`20basis`20of`20date`20(vi
Va`20the
X`20`20/BEFORE`20and/or`20/SINCE`20qualifiers)`20should`20use`20the`20`60last
V`20modified
X`20`20date'`20as`20the`20basis`20of`20selection.
X
X`20`20If`20any`20combination`20of`20/BACKUP,`20/CREATED,`20EXPIRED`20and`20/MO
VDIFIED
X`20`20are`20specified`20together,`20then`20only`20the`20last`20one`20specified
V`20takes
X`20`20effect.
X
X`20`20The`20default`20is`20to`20use`20the`20`60last`20modified`20date'.
X
X/PACKAGE_INDEX
X
X`20`20/`5BNO`5DPACKAGE_INDEX`5B=suffix`5D
X
X`20`20Selects`20the`20automatic`20creation`20of`20an`20index`20file,`20contain
Ving`20a
X`20`20list`20of`20the`20filenames`20of`20each`20part`20written.`20This`20is
V`20known`20as`20a
X`20`20package`20index`20and`20is`20useful`20for`20mail`20based`20file`20server
Vs`20which
X`20`20allow`20users`20to`20request`20the`20package`20file`20and`20get`20sent
V`20all`20the
X`20`20files`20whose`20names`20it`20contains.
X
X`20`20/NOPACKAGE_INDEX`20(the`20default)`20requests`20that`20no`20package`20in
Vdex
X`20`20file`20is`20to`20be`20created.
X
X`20`20/PACKAGE_INDEX`20requests`20that`20a`20package`20index`20file`20is`20to
V`20be
X`20`20created`20with`20the`20default`20suffix`20type`20of`20".$PACKAGE"
X
X`20`20/PACKAGE_INDEX=suffix`20requests`20that`20a`20package`20index`20file`20i
Vs`20to
X`20`20be`20created`20using`20`60suffix'`20as`20the`20type.`20`60suffix'`20must
V`20be`20a`20valid
X`20`20file`20type,`20such`20as`20".LIBRARY",`20and`20the`20initial`20dot`20is
V`20required.
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_PACKAGE_INDEX.
X
X/PART_SIZE
X
X`20`20/PART_SIZE=n
X
X`20`20Selects`20the`20size`20of`20a`20share`20file`20part,`20in`20blocks.`20Th
Ve`20part`20size
X`20`20must`20be`20sufficient`20to`20contain`20the`20initial`20control`20inform
Vation`20so
X`20`20a`20value`20of`20at`20least`206`20blocks`20is`20recommended.`20If`20the
V`20size`20is`20too
X`20`20small,`20then`20a`20fatal`20error`20will`20be`20issued`20during`20the
V`20packing
X`20`20operation.
X
X`20`20The`20usual`20default`20size`20is`2030`20blocks.
X
X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
V`20logical
X`20`20name`20SHARE_PART_SIZE.
X
X/SINCE
X
X`20`20/SINCE`5B=date`5D
X
X`20`20Selects`20only`20files`20with`20access`20dates`20after`20the`20date`20sp
Vecified.
X`20`20By`20default,`20the`20date`20does`20not`20have`20to`20be`20after`20any
V`20specific
X`20`20date`20to`20be`20selected.
X
X`20`20The`20date`20specification`20can`20be`20any`20absolute`20or`20delta`20ti
Vme
X`20`20combination`20normally`20acceptable`20to`20VMS`20with`20ONE`20exception
V`20-`20it
X`20`20may`20not`20contain`20any`20spaces.`20`20To`20enter`20a`20combined`20dat
Ve`20and`20time,
X`20`20use`20a`20colon`20to`20separate`20to`20two`20E.G.`20`2010-AUG-1992:15:00
V:00.00.
X`20`20Any`20missing`20field`20is`20taken`20to`20be`20that`20of`20the`20CURRENT
V`20time.
X
X`20`20/SINCE`20without`20a`20date`20specification`20implies`20midnight`20on
V`20the
X`20`20current`20day`20I.E.`20is`20equivalent`20to
X`20`20/SINCE=xx-mmm-yyyy:00:00:00.00
X
X`20`20Used`20in`20conjunction`20with`20the`20/BEFORE`20qualifier`20allows`20fi
Vles`20to
X`20`20be`20selected`20within`20a`20range`20of`20dates.
X
X/VERSION
X
X`20`20/`5BNO`5DVERSION
X
X`20`20Selects`20the`20Version`20number`20preservation`20option.`20Each`20file
X`20`20packaged`20will`20have`20its`20current`20version`20number`20preserved
V`20across
X`20`20the`20packaging`20and`20unpackaging`20operation.
X
X`20`20If`20/VERSION`20is`20selected,`20the`20`20version`20numbers`20are`20pres
Verved`20on
X`20`20each`20file`20packaged,`20and`20the`20unpacking`20process`20will`20creat
Ve`20the
X`20`20same`20version`20of`20the`20file.
X
X`20`20If`20/NOVERSION`20is`20selected,`20then`20version`20numbers`20are`20stri
Vpped
X`20`20from`20each`20file`20packaged;`20the`20unpacking`20process`20will`20crea
Vte`20a
X`20`20new`20version`20of`20the`20file`20regardless`20of`20the`20existence`20of
V`20any
X`20`20existing`20file`20with`20the`20same`20name.`20
X
X`20`20The`20default`20is`20to`20preserve`20the`20version`20numbers,`20but`20th
Vis
X`20`20default`20can`20be`20overidden`20by`20defining`20the`20logical`20name
X`20`20SHARE_VERSION
X
X2`20PAKMAIL
X
XThe`20PAKMAIL`20utility`20may`20be`20used`20to`20send`20the`20generated`20part
Vs`20of
Xthe`20sharefile`20to`20one`20or`20more`20recipients`20over`20the`20electronic
V`20mail
Xnetwork.`20Consult`20the`20separate`20help`20entry`20for`20full`20details.`20
X
X2`20Sharefile
X
XThe`20name`20of`20the`20packed`20output`20file.`20This`20name`20will`20be`20su
Vffixed`20by
Xthe`20part`20number`20even`20if`20there`20is`20only`201`20part`20created.`20
X
XA`20prompt`20is`20issued`20if`20no`20sharefile`20name`20is`20specified.
X2`20Version
XThis`20describes`20version`208.2`20of`20VMS_SHARE;`20dated`20January`201993
$ call unpack VMS_SHARE.HLP;34 1629535921 ""
$!
$ create 'f'
X`20`20`20`20`20`20`20`20`09`09`09V`20M`20S`20_`20S`20H`20A`20R`20E
X
X`20`20`20`20`09`09`09`20`20`20R`20E`20L`20E`20A`20S`20E`20`20`20N`20`20O`20T
V`20E`20S
X
X`20`20`20`20`09`09`09`09`09`09`09`09Version`208.2
X`20`20`20`20`09`09`09`09`09`09`09`09Jan`201993
X
X-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
V`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
V`20-
X
XThis`20software`20is`20copyright`20but`20may`20be`20freely`20distributed`20wit
Vhout`20charge`20to
Xanyone.`20All`20copyright`20and`20ownership`20notices`20must`20remain`20intact
V.`20No`20warranties
Xare`20offered`20as`20to`20the`20suitability`20of`20this`20software`20for`20any
V`20purpose;`20any
Xerrors`20arising`20from`20its`20use`20are`20entirely`20the`20responsibility
V`20of`20the`20user.
X
X(C)`20Andy`20Harper,
X`20`20`20`20Kings`20College`20London,
X`20`20`20`20England
X
X-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
V`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
V`20-
X
X
X1.`20INTRODUCTION
X
XVersion`208.2`20of`20VMS_SHARE`20is`20a`20major`20release`20which`20fixes`20a
V`20number`20of`20bugs`20and
Xmakes`20a`20number`20of`20new`20features`20available.
X
X
X
X2.`20NEW`20FEATURES
X
X2.1`20`20File`20Exclusion
X
XThe`20new`20/EXCLUDE=filelist`20qualifier`20may`20be`20used`20to`20exclude`20a
V`20set`20of`20files`20from
Xthe`20packaging`20operation.`20`20`60Filelist'`20is`20a`20comma`20separated
V`20list`20of`20full`20or
Xpartial`20file`20name`20specifications.`20Each`20field`20in`20a`20filename`20s
Vpecification`20(Field
X=`20DIRECTORY,`20NAME,`20TYPE`20or`20VERSION`20part)`20may`20be`20omitted`20or
V`20may`20be`20a`20specific
Xdirectory,`20name,`20type`20or`20version`20in`20the`20usual`20format.`20Fields
V`20which`20are`20omitted
Xare`20assumed`20to`20match`20anything.`20Files`20which`20match`20the`20specifi
Vcation`20are`20excluded
Xfrom`20the`20packaging`20operation.
X
XSome`20examples:
X
X`20`20/EXCLUDE=.FOR`09`09Exclude`20all`20files`20with`20a`20.FOR`20file`20type
V
X
X`20`20/EXCLUDE=.EXE,.OBJ`09Exclude`20all`20files`20with`20a`20.EXE`20or`20a
V`20.OBJ`20file`20type
X
X`20`20/EXCLUDE=DUMMY.DAT`09Exclude`20any`20file`20called`20DUMMY.DAT`20regardl
Vess`20of
X`09`09`09directory`20or`20version
X
X`20`20/EXCLUDE=;1`09`09Exclude`20all`20version`201`20files
X
X`20`20/EXCLUDE=`5BX`5DDUMMY.DAT`09Exclude`20all`20versions`20of`20the`20file
V`20DUMMY.DAT`20in`20directory
X`09`09`09`5BX`5D
X
XWildcards`20are`20not`20permitted,`20although`20an`20`60*'`20can`20be`20used
V`20in`20the`20usual`20place
XONLY`20to`20specify`20a`20complete`20field`20(NOT`20partial`20fields).`20For
V`20example:
X
X`20`20/EXCLUDE=*.FOR`09Is`20allowed`20and`20excludes`20all`20files`20with`20a
V`20type`20of`20.FOR
X
X`20`20/EXCLUDE=X*.FOR`09Is`20NOT`20allowed`20as`20the`20asterisk`20is`20used
V`20to`20match`20only
X`09`09`09part`20of`20the`20name`20field`20and`20not`20the`20whole`20field.
X
X
XThe`20default`20is`20to`20include`20all`20files`20specified`20by`20the`20user'
Vs`20parameter`20list.
XHowever`20the`20new`20SHARE_EXCLUDE`20logical`20name`20may`20be`20defined`20wi
Vth`20a`20list`20of
Xexclusions`20to`20override`20this`20default.`20`20Use`20of`20the`20/EXCLUDE
V`20qualifier`20overrides
Xthe`20setting`20of`20this`20logical`20name`20for`20any`20given`20run.
X
XNote`20that`20this`20qualifier`20and`20logical`20name`20makes`20redundant`20th
Ve`20following`20logical
Xnames:
X
X`20`20`20SHARE_EXCLUDE_DIRS`09To`20exclude`20directories
X`20`20`20SHARE_EXCLUDE_FILES`09To`20exclude`20specific`20filenames
X`20`20`20SHARE_EXCLUDE_NAMES`09To`20exclude`20files`20with`20specific`20names
X`20`20`20SHARE_EXCLUDE_TYPES`09To`20exclude`20specific`20file`20types
X
XThese`20logical`20names`20`20are`20still`20recognized`20in`20addition`20to`20t
Vhe`20SHARE_EXCLUDE
Xlogical`20name,`20but`20the`20effect`20is`20overriden`20if`20the`20/EXCLUDE
V`20qualifier`20is`20used.
XThey`20will`20be`20removed`20in`20a`20future`20release`20of`20the`20software.
X
X
X2.2`20New`20Compression`20Mechanism
X
XPrevious`20releases`20have`20supported`20a`20simple`20compression`20mechanism
V`20based`20on
Xrun-length`20encoding,`20which`20is`20a`20simple`20but`20unsophisticated`20alg
Vorithm`20for
Xreducing`20the`20size`20of`20the`20packaged`20files`20by`20encoding`20sequence
Vs`20of`20the`20same
Xcharacter`20into`20a`20shorter`20sequence.`20This`20version`20introduces`20an
V`20additional
Xtechnique`20based`20on`20the`20algorithm`20popularly`20referred`20to`20as`20Le
Vmpel-Ziv`20encoding,
Xwhere`20substrings`20are`20encoded`20into`20a`20form`20that`20points`20back
V`20to`20a`20previous
Xoccurrence`20of`20the`20same`20substring.`20This`20results`20in`20a`20more`20s
Vignificant
Xcompression`20ratio`20at`20the`20expense`20of`20more`20CPU`20time`20to`20packa
Vge`20the`20file.
X
XThe`20`60official'`20Lempel-Ziv`20algorithm`20has`20been`20substantially`20mod
Vified`20to`20take
Xinto`20account`20the`20additional`20constraints`20of`20this`20application.`20A
Vs`20such,`20it`20is`20not
Xas`20effective`20as`20`60real'`20lempel-ziv`20but`20appears`20to`20do`20a`20re
Vasonable`20job`20in`20the
Xmajority`20of`20files`20with`20which`20it`20has`20been`20tested.`20As`20before
V,`20selection`20of`20this
Xcompression`20technique`20may`20be`20of`20little`20benefit`20in`20some`20cases
V`20and`20is`20very`20much
Xslower`20than`20selecting`20no`20compression;`20therefore`20it`20is`20NOT`20se
Vlected`20by`20default.
X
XTo`20allow`20user`20selection`20of`20this`20mechanism,`20the`20/COMPRESS`20qua
Vlifier`20(and
Xcorresponding`20logical`20name`20SHARE_COMPRESS)`20has`20been`20modified`20to
V`20accept`20a
Xnumeric`20parameter.`20The`20value`20specifies`20the`20compression`20mechanism
V`20to`20be`20used.
X
XCurrently:
X
X`20`20`20/COMPRESS=0`09`09Specifies`20no`20additional`20compression
X`20`20`20/COMPRESS=1`09`09Specifies`20run-length`20encoding
X`20`20`20/COMPRESS=2`09`09Specifies`20the`20modified`20Lempel-Ziv`20compressio
Vn
X
XOther`20values`20are`20not`20permitted.`20/COMPRESS`20by`20itself`20is`20the
V`20same`20as`20/COMPRESS=1;
X/NOCOMPRESS`20is`20the`20same`20as`20/COMPRESS=0
X
XNOTE:`20it`20is`20NOT`20intended`20that`20this`20form`20of`20compression`20sho
Vuld`20supplant`20that
Xwhich`20can`20be`20obtained`20by`20external`20means,`20such`20as`20the`20ZIP
V`20utility,`20which`20can
Xalways`20be`20used`20if`20required.`20However,`20it`20has`20the`20advantage
V`20of`20being`20easy`20to`20use
Xand`20not`20requiring`20the`20recipient`20to`20have`20any`20external`20decompr
Vession`20tools.
X
X
X
X2.3`20Support`20for`20VFC`20files
X
XThis`20release`20introduces`20support`20for`20the`20record`20format`20VFC,`20a
Vnd`20associated`20fixed
Xcontrol`20area.
X
X
X2.4`20Enhanced`20/LOG`20qualifier
X
XThe`20/LOG`20qualifier`20may,`20like`20/COMPRESS,`20now`20take`20a`20numeric
V`20parameter`20to`20specify
Xthe`20level`20of`20logging`20required`20-`20/LOG=n.`20Permitted`20values`20are
V`200,`201`20and`202.
X
X/LOG=0`20specifies`20no`20logging`20output`20is`20to`20be`20produced.`20It`20i
Vs`20equivalent`20to
X/NOLOG.
X
X/LOG=1`20specifies`20that`20minimal`20logging`20should`20be`20produced,`20just
V`20a`20summary`20of
Xeach`20file`20as`20it`20is`20processed,`20a`20final`20summary`20of`20the`20num
Vber`20of`20parts
Xgenerated,`20and`20a`20note`20about`20the`20package`20index`20file`20if`20one
V`20has`20been`20requested.
XIt`20is`20equivalent`20to`20/LOG`20with`20no`20parameter.
X
X/LOG=2`20specifies`20that`20additional`20logging`20is`20to`20be`20produced`20o
Vver`20and`20above`20that
Xof`20level`201.`20Currently,`20this`20produces`20a`20summary`20of`20the`20file
V`20encoding`20statistics
Xbefore`20and`20after`20encoding`20as`20an`20aid`20in`20determining`20the`20eff
Vectiveness`20of`20the
Xcompression.`20Previously,`20this`20output`20was`20part`20of`20the`20/DEBUG
V`20facility`20and
Xtherefore`20required`20privileges.`20The`20corresponding`20debug`20messages
V`20have`20been
Xremoved`20and`20the`20facility`20is`20available`20to`20all`20users`20through
V`20/LOG.
X
XAdditional`20log`20messages`20and`20levels`20of`20logging`20may`20be`20added
V`20in`20future`20releases.
X
X
X
X2.5`20Strip`20Directory`20and`20Version`20Numbers
X
XRecent`20previous`20releases`20have`20preserved`20the`20subdirectory`20structu
Vre`20of`20the
Xpackaged`20files`20and`20the`20version`20numbers.`20Some`20older`20releases
V`20did`20not.`20Some`20users
Xhave`20requested`20an`20option`20that`20allows`20the`20older`20behaviour`20to
V`20be`20reinstated.
X
XAs`20a`20result,`20two`20new`20qualifiers`20have`20been`20added`20that`20allow
V`20the`20user`20to`20select
Xwhether`20directories`20and/or`20version`20numbers`20are`20retained`20in`20the
V`20sharefile.
X
XThe`20new`20qualifier`20/`5BNO`5DDIRECTORY`20selects`20the`20`5Bno`5D`20direct
Vory`20structure
Xpreservation`20option.`20If`20preserved,`20then`20the`20directory`20structure
V`20will`20be
Xrecreated`20when`20the`20share`20file`20is`20unpacked.`20If`20not`20preserved,
V`20then`20all`20files
Xwill`20be`20created`20in`20the`20directory`20current`20at`20the`20time`20of
V`20unpacking.`20The`20logical
Xname`20SHARE_DIRECTORY`20may`20be`20defined`20to`20specify`20the`20default,
V`20with`20/DIRECTORY
Xbeing`20the`20default`20otherwise.
X
XThe`20new`20qualifier`20/`5BNO`5DVERSION`20selects`20the`20`5Bno`5D`20version
V`20number`20preservation
Xoption.`20If`20preserved,`20then`20the`20version`20numbers`20are`20retained
V`20when`20the`20share`20file
Xis`20unpacked`20and`20a`20file`20with`20the`20same`20version`20number`20will
V`20cause`20the`20unpacking`20of
Xthat`20particular`20file`20to`20be`20skipped.`20If`20not`20preserved,`20then
V`20a`20new`20version`20of`20the
Xfile`20will`20be`20created`20regardless,`20with`20a`20warning`20message`20if
V`20a`20lower`20numbered
Xversion`20already`20exists.`20The`20logical`20name`20SHARE_VERSION`20may`20be
V`20defined`20to
Xspecify`20the`20default,`20with`20/VERSION`20being`20the`20default`20otherwise
V.
X
X`5BThanks`20to`20Wolfgang`20Moeller`20-`20Moeller@gwdgv1.dnet.gwdg.de`20-`20fo
Vr`20this`20suggestion`5D
X
X
X
X2.6`20DEBUG`20Now`20Shows`20Rejected`20Files
X
XIf`20a`20file`20which`20matches`20the`20user`20specified`20input`20files`20is
V`20not`20selected`20because
Xof`20the`20value`20of`20the`20/EXCLUDE,`20/AFTER`20or`20/BEFORE`20qualifiers,
V`20selecting`20the
X/DEBUG`20qualifier`20will`20show`20which`20of`20these`20qualifiers`20caused
V`20it`20to`20be`20rejected.
X
XLevel`202`20debug`20is`20required`20for`20this.
X
X
X
X2.7`20New`20PAKMAIL`20Utility
X
XThe`20PAKMAIL`20utility`20has`20been`20extensively`20revised.`20In`20particula
Vr,`20it`20now
Xrecognizes`20an`20optional`20list`20of`20parts`20as`20a`20paramter.`20This`20a
Vllows`20a`20user`20to`20send
Xa`20subset`20of`20the`20full`20package`20should,`20for`20example,`20a`20number
V`20of`20users`20fail`20to
Xreceive`20some`20of`20the`20parts.`20`20The`20User`20guide`20and`20on-line`20h
Velp`20give`20further
Xdetails`20of`20this.
X
X`5BThanks`20to`20Richard`20Levitte`20-`20Levitte@ttt.kth.se`20-`20for`20this
V`20suggestion`5D
X
X
X
X3.`20BUG`20FIXES
X
X
X3.1`20Debug`20Messages
X
XIn`20some`20early`20releases`20of`20version`208.1,`20some`20of`20the`20debug
V`20messages`20were`20always
Xactive.`20This`20was`20due`20to`20a`20faulty`20definition`20of`20their`20debug
V`20level`20(as`200`20rather
Xthan`201)`20internally.`20The`20debug`20level`20associated`20with`20these`20me
Vssages`20has`20been
Xcorrected.
X
X
X
X3.2`20PAKMAIL
X
XThe`20PAKMAIL`20utility,`20used`20to`20mail`20out`20parts`20of`20a`20package,
V`20was`20modified`20in
Xversion`208.1`20to`20reflect`20the`20new`20part`20format`20of`20nnn-OF-mmm.
V`20A`20bug`20in`20the`20code
Xprevented`20this`20working`20correctly`20when`20the`20number`20of`20parts`20ex
Vceeded`209.`20This`20has
Xnow`20been`20corrected`20and`20works`20for`20any`20number`20of`20parts.
X
X
X
X3.3`20Check`20for`20Same`20Subdirectory
X
XThe`20check`20on`20whether`20a`20file`20was`20in`20the`20same`20subdirectory
V`20was`20faulty,`20leading`20to
Xa`20DCL`20error`20message`20about`20undefined`20symbols`20rather`20than`20the
V`20correct`20message.
XThis`20has`20been`20corrected.
X
X`5BThanks`20to`20Wolfgang`20Moeller`20-`20Moeller@gwdgr1.dnet.gwdg.de`20-`20fo
Vr`20this`20bugfix`5D
X
X
X
X3.4`20File`20scanning
X
XIn`20some`20early`20version`20of`20VMS`20(around`205.3`20and`20earlier),`20the
Vre`20was`20a`20dcl`20bug`20that
Xprevented`20nested`20loops`20containing`20gosubs`20from`20working`20correctly.
V`20After`20several
Xiterations,`20DCL`20would`20fail`20to`20find`20labels`20that`20were`20definite
Vly`20present.`20`20This
Xsituation`20could`20arise`20in`20that`20part`20of`20the`20code`20which`20scans
V`20the`20user's`20file
Xspecifications`20and`20locates`20matching`20files.`20To`20avoid`20the`20proble
Vm,`20the`20code`20has
Xbeen`20split`20into`20two`20sections,`20circumventing`20the`20bug.
X
XNote`20that`20the`20bug`20appears`20to`20no`20longer`20exist`20on`20VMS`205.5.
V
X
X`5BThanks`20to`20Foetes`20Macrides`20-`20MACRIDES@WFEB2.BITNET`20-`20for`20thi
Vs`20bugfix`5D
X
X
X3.5`20Check`20for`20same`20device
X
XThe`20check`20on`20the`20filename`20to`20make`20sure`20it`20exists`20on`20the
V`20current`20device`20was
Xinside`20rather`20than`20outside`20a`20loop.`20This`20resulted`20in`20one`20me
Vssage`20for`20each`20file
Xthat`20matched`20a`20wildcarded`20file`20spec`20on`20the`20device.`20The`20che
Vck`20has`20been`20moved
Xoutside`20the`20loop`20and`20is`20now`20issued`20once`20when`20the`20wildcarde
Vd`20pattern`20is`20first
Xused;`20the`20pattern`20is`20not`20used`20if`20the`20device`20is`20invalid.
X
XNote`20that`20this`20check`20is`20suppressed`20if`20the`20/NODIRECTORY`20optio
Vn`20is`20requested.
X
X
X3.6`20Check`20for`20invalid`20file`20specifications
X
XThe`20input`20file`20specification`20supplied`20by`20the`20user`20is`20now`20c
Vhecked`20for`20valid
Xsyntax.`20Any`20invalid`20file`20specifications`20cause`20an`20abort.
X
X
X
X3.7`20Check`20for`20missing`20parameters`20in`20non-interactive`20mode
X
XIf`20any`20of`20the`20required`20parameters`20are`20not`20supplied`20on`20the
V`20command`20line,`20the
Xuser`20is`20prompted`20for`20them.`20However,`20if`20the`20mode`20of`20the`20p
Vrocess`20is`20not
XINTERACTIVE,`20the`20user`20cannot`20be`20prompted;`20therefore`20an`20error
V`20message`20is`20issued
Xin`20such`20modes.
X
X
X3.8`20Problems`20with`20checksumming
X
XDue`20to`20the`20problems`20described`20in`20section`206.1`20of`20these`20rele
Vase`20notes,`20the
Xchecksum`20mechanism`20cannot`20always`20be`20used.`20Under`20such`20circumsta
Vnces`20the`20file
Xcannot`20be`20packaged`20either.`20Previous`20releases`20inserted`20a`20check
V`20into`20the`20created
Xshare`20file`20on`20the`20assumption`20that`20the`20checksum`20might`20fail
V`20but`20the`20packaging
Xwould`20not.`20However,`20this`20cannot`20happen`20so`20the`20appropriate`20co
Vde`20segment`20has`20been
Xremoved`20from`20the`20created`20share`20file.
X
XShould`20a`20file`20not`20be`20able`20to`20be`20checksummed`20at`20the`20packa
Vging`20stage,`20an
Xappropriate`20message`20is`20issued`20and`20the`20file`20is`20ignored.
X
X
X
X3.9`20Check`20on`20Output`20Directory/FileName
X
XIf`20the`20output`20directory`20was`20non-existent,`20or`20there`20was`20a`20s
Vyntax`20error`20in`20the
Xoutput`20file`20specification,`20the`20share`20file`20parts`20were`20created
V`20in`20the`20current
Xdirectory`20with`20strange`20names.`20`20A`20check`20has`20now`20been`20includ
Ved`20to`20validate`20the
Xoutput`20file.
X
X
X
X3.10`20Checks`20on`20Qualifier`20Formats
X
XMore`20checks`20have`20been`20added`20to`20the`20qualifier`20parsing`20code
V`20to`20ensure`20that
Xqualifiers`20that`20need`20values`20have`20them,`20and`20that`20those`20which
V`20don't`20require`20them
Xdo`20not`20have`20them`20specified.
X
X
X
X3.11`20Input`20File`20Patterns
X
XA`20warning`20message`20is`20now`20issued`20if`20any`20of`20the`20input`20file
V`20specifications`20do`20not
Xmatch`20at`20least`20one`20file.`20The`20message`20is`20given`20for`20each`20p
Vattern`20that`20fails`20to
Xmatch.
X
X
X
X3.12`20Parameter`20File`20Creation
X
XAdditional`20checks`20are`20now`20made`20on`20the`20creation`20of`20the`20para
Vmeter`20file,`20to`20ensure
Xthat`20all`20parameters`20have`20been`20correctly`20written.
X
X
X3.13`20Null`20file`20types
X
XNull`20file`20types`20were`20processed`20badly`20in`20some`20places;`20all`20k
Vnown`20instances`20of
Xthis`20have`20been`20corrected`20and`20should`20now`20work`20properly`20as`20w
Vith`20any`20other`20file
Xtype.
X
X`5BThanks`20to`20Richard`20Levitte`20-`20Levitte@ttt.kth.se`20-`20for`20this
V`20bugfix`5D
X
X
X
X4.`20CHANGES`20IN`20OPERATION
X
XThe`20compression`20routines`20have`20all`20been`20completely`20re-written.
V`20The`20only`20new`20code
Xis`20that`20dealing`20with`20the`20LZ`20encoding.
X
X
X
X
X5.`20DOCUMENTATION`20CHANGES
X
XThe`20user`20guide`20has`20been`20completely`20re-written.`20Details`20on`20th
Ve`20new`20features`20have
Xbeen`20added`20and`20descriptions`20of`20all`20the`20qualifiers`20have`20been
V`20moved`20to`20a`20separate
Xqualifier`20reference`20section.
X
XThe`20HELP`20file`20has`20been`20updated`20with`20details`20of`20the`20new`20q
Vualifiers`20(/EXCLUDE,
X/DIRECTORY`20and`20/VERSION)`20and`20the`20new`20logical`20names`20correspondi
Vng`20to`20them.
XMost`20of`20the`20logical`20name`20descriptions`20have`20been`20rewritten`20so
V`20that`20the`20reader`20is
Xreferred`20to`20the`20corresponding`20qualifier`20rather`20than`20duplicating
V`20information.
X
X
X
X6.`20MISCELLANEOUS`20NOTES
X
X6.1`20Record`20Length`20Problems
X
XThe`20release`20notes`20for`20version`208.1`20outlined`20some`20problems`20wit
Vh`20long`20records,
Xwhereby`20TPU`20and`20the`20CHECKSUM`20utility`20were`20failing`20to`20read
V`20certain`20files`20with
Xlongish`20lines`20in`20them.`20`20The`20reason`20for`20this`20is`20now`20clear
V,`20although`20a`20solution
Xhas`20not`20yet`20presented`20itself.
X
XEssentially,`20each`20file`20header`20contains`20TWO`20fields`20describing`20t
Vhe`20size`20of`20each
Xrecord;`20the`20first`20is`20the`20maximum`20record`20size,`20which`20contains
V`20the`20longest`20line
Xthat`20may`20appear`20in`20the`20file`20-`20a`20zero`20value`20here`20signifie
Vs`20no`20upper`20limit`20on`20the
Xlength`20-`20and`20is`20used`20by`20many`20system`20utilities,`20TPU`20include
Vd,`20to`20determine`20the
Xsize`20of`20the`20record`20buffer;`20the`20second`20is`20the`20length`20of`20t
Vhe`20longest`20record`20that
Xis`20currently`20written`20to`20the`20file.
X
XThe`20problem`20arise`20when`20each`20of`20these`20conditions`20is`20true:
X
X(a)`20The`20MRS`20value`20is`20zero,`20which`20causes`20TPU`20and`20CHECKSUM
V`20to`20allocate`20default
X`20`20`20`20record`20buffer`20sizes`20of`20about`202048`20bytes.
X
X(b)`20The`20longest`20record`20in`20the`20file`20exceeds`20the`20default`20rec
Vord`20buffer`20length.
X
XUnfortunately,`20DCL's`20lexical`20function`20f$file_attributes`20only`20allow
Vs`20a`20procedure
Xto`20see`20the`20MRS`20value`20and`20NOT`20the`20longest`20record`20value.`20I
Vt`20is`20therefore
Ximpossible`20to`20predict`20in`20advance`20which`20files`20are`20going`20to
V`20cause`20problems`20during
Xpackaging.
X
XThe`20CHECKSUM`20utility`20suffers`20from`20a`20similar`20problem`20and`20cons
Vequently`20will`20not
Xchecksum`20files`20with`20an`20MRS`20value`20of`200`20and`20a`20longest`20reco
Vrd`20greater`20than`202048
Xbytes.
X
XIt`20is`20hoped`20that`20future`20developments`20in`20VMS`20may`20allow`20this
V`20problem`20to`20be
Xcircumvented.`20In`20the`20short`20term,`20the`20simplest`20workaround`20is
V`20to`20use`20the`20CONVERT
Xutility`20to`20create`20a`20new`20version`20of`20the`20file`20with`20the`20MRS
V`20value`20set`20to`20the`20size
Xof`20the`20longest`20record.`20The`20longest`20record`20can`20be`20determined
V`20by`20using
X
X`20`20`20DUMP/HEADER/BLOCK=C:0`20file
X
Xand`20looking`20for`20the`20RMS`20attributes`20section.`20Once`20the`20size
V`20of`20the`20longest`20record
Xis`20obtained,`20call`20it`20`60nnn',`20use`20the`20CONVERT`20utility`20as`20f
Vollows:
X
X`20`20`20CONVERT/FDL=SYS$INPUT`20file`20file
X`20`20`20RECORD
X`20`20`20`20SIZE`20nnn
X`20`20`20`5EZ
X
XThis`20new`20copy`20of`20the`20file`20will`20then`20be`20correctly`20processed
V`20by`20VMS_SHARE
X
X
X
X7.`20TESTING
X
XThis`20version`20of`20VMS_SHARE`20has`20only`20been`20tested`20on`20VMS`205.5-
V1`20but`20is`20believed`20to
Xwork`20on`20all`20versions`20from`20VMS`205.0`20to`20VMS`205.5-1.`20`20However
V,`20it`20is`20not`20supported`20
Xformally`20on`20any`20version`20of`20VMS`20other`20than`20the`20one`20on`20whi
Vch`20it`20has`20been`20tested.
X
XThe`20share`20files`20generated`20by`20VMS_SHARE`20are`20believed`20to`20unpac
Vk`20correctly`20on`20all
Xversions`20of`20TPU`20from`20VMS`204.4`20onwards`20unless`20the`20/LONGLINES
V`20option`20is`20selected,
Xin`20which`20case`20VMS`205.4`20is`20the`20minimum`20release`20needed.
X
X
X
X8.`20PREVIOUS`20RELEASE`20NOTES
X
XRelease`20notes`20for`20previous`20versions`20are`20appended`20at`20the`20end.
V`20These`20give`20
Xdetails`20of`20changes`20and`20bug`20fixes`20for`20those`20versions.
X`0C
X`20`20`20`20`20`20`20`20`09`09`09V`20M`20S`20_`20S`20H`20A`20R`20E
X
X`20`20`20`20`09`09`09`20`20`20R`20E`20L`20E`20A`20S`20E`20`20`20N`20`20O`20T
V`20E`20S
X
X
X`20`20`20`20`09`09`09`09`09`09`09`09Version`208.1
X`20`20`20`20`09`09`09`09`09`09`09`09Sep`201992
X
X
X1.`20INTRODUCTION
X
XVersion`208.1`20of`20VMS_SHARE`20is`20a`20major`20release`20which`20fixes`20a
V`20number`20of`20bugs`20and
Xmakes`20a`20number`20of`20new`20features`20available.
X
X
X
X2.`20NEW`20FEATURES
X
X2.1`20Date`20Based`20File`20Selection
X
XThe`20selection`20of`20files`20for`20packaging`20can`20now`20be`20modified`20o
Vn`20the`20basis`20of`20the
Xaccess`20dates`20associated`20with`20each`20file.`20The`20usual`20VMS`20qualif
Viers`20for`20this`20are
Xsupported:
X
X`20`20/SINCE`5B=date`5D`09`09Select`20files`20accessed`20since`20a`20specific
V`20date
X`20`20/BEFORE`5B=date`5D`09Select`20files`20accessed`20before`20a`20specific
V`20date
X`20`20/BACKUP`09`09Use`20the`20last`20backup`20date`20as`20the`20basis`20of
V`20date`20selection
X`20`20/CREATED`09`09Use`20the`20create`20date`20as`20the`20basis`20of`20date
V`20selection
X`20`20/EXPIRED`09`09Use`20the`20expiration`20date`20as`20the`20basis`20of`20da
Vte`20selection
X`20`20/MODIFIED`09`09Use`20the`20last`20modified`20date`20as`20the`20basis`20o
Vf`20date`20selection
X
XAll`20sensible`20combinations`20of`20these`20are`20recognized.`20/SINCE`20and
V`20/BEFORE`20together
Xspecify`20a`20range`20of`20dates;`20use`20of`20/BACKUP,`20/CREATED,`20/EXPIRED
V`20and`20/MODIFIED
Xtogether`20is`20allowed,`20but`20only`20the`20last`20one`20specified`20has`20a
Vny`20effect`20(the
Xdefault`20is`20/MODIFIED`20if`20none`20are`20given).
X
XFor`20example:
X
X`20`20$`20VMS_SHARE`20*.*`20PACKAGE`20/CREATED`20/SINCE=1-JAN-1992`20/BEFORE=T
VODAY
X`09Selects`20all`20files`20created`20this`20year
X
X
XThere`20is`20one`20deviation`20from`20the`20usual`20behaviour`20of`20these`20q
Vualifiers.`20If`20any
Xpart`20of`20the`20time`20field`20is`20omitted`20it`20takes`20on`20the`20CURREN
VT`20time`20values`20rather
Xthan`20the`20values`20at`20midnight,`20so`20that:
X
X`20`20`20`20`20`20`20`20`20/SINCE=TODAY`20`20and`20/SINCE=1-AUG-1992`20`20`20
V`20`20`20`20`20`20`20`20`20`20`20`20are`20NOT`20equivalent
Xbut`20`20`20`20`20`20/SINCE=TODAY`20`20and`20/SINCE=1-AUG-1992:00:00:00.00`20
V`20`20are`20equivalent.
X
XNote`20also`20the`20use`20of`20a`20:`20to`20separate`20the`20date`20and`20time
V`20fields.`20Spaces`20are`20not
Xallowed`20and`20quoted`20times`20are`20not`20recognized`20correctly.
X
XA`20missing`20date/time`20spec`20(I.E.`20just`20/SINCE`20or`20just`20/BEFORE)
V`20defaults,`20as`20usual,
Xto`20"TODAY".
X
X
X
X2.2`20Confirmation`20of`20Selected`20Files
X
XUsers`20can`20now`20elect`20to`20confirm`20each`20file`20selected`20via`20the
V`20new`20/CONFIRM
Xqualifier.`20This`20works`20similarly`20to`20/CONFIRM`20on`20the`20DELETE,`20P
VURGE,`20COPY`20commands
Xetc.`20A`20Y`20response`20selects`20the`20file,`20a`20N`20response`20does`20no
Vt.`20The`20default`20response
Xis`20N.
X
XUse`20of`20this`20option`20in`20any`20non-interactive`20mode`20results`20in
V`20a`20warning`20and
X/CONFIRM`20is`20ignored.
X
XBy`20default,`20confirmation`20is`20turned`20off.`20A`20new`20logical`20name
V`20SHARE_CONFIRM`20may`20be
Xdefined`20with`20a`20true`20or`20false`20value`20to`20override`20the`20default
V.`20The`20/`5BNO`5DCONFIRM
Xqualifier`20on`20the`20command`20line`20overrides`20the`20setting`20of`20the
V`20logical`20name.
X
X
X
X2.3`20Debugging
X
XThe`20debugging`20facility`20at`20level`201`20now`20includes`20additional`20me
Vssages`20detailing
Xthe`20size`20of`20a`20file`20buffer`20before`20and`20after`20encoding.`20This
V`20provides`20two`20useful
Xfunctions.`20First,`20it`20allows`20a`20comparison`20of`20the`20normal`20encod
Ving`20algorithm`20with
Xthe`20run-length`20encoding`20compression`20algorithm;`20second,`20it`20gives
V`20a`20useful
Xprogress`20monitoring`20function`20when`20packaging`20a`20large`20collection
V`20of`20files.
X
XThe`20messages`20produced`20are`20similar`20to`20these:
X
X`20`20`20`20`20`20`20Begin`20buffer`20encoding,`20n`20lines,`20b`20bytes
X
Xand`20`20`20`20End`20`20`20buffer`20encoding,`20n`20lines,`20b`20bytes,`20chan
Vge`20=`20x%
X
XThe`20change`20field`20is`20given`20as`20a`20percentage`20increase`20or`20decr
Vease`20in`20the`20size`20of
Xthe`20buffer.`20Usually,`20it`20will`20increase`20because`20of`20the`20encodin
Vg`20applied`20to
Xnon-printable`20characters.`20Use`20of`20run-length`20compression`20would`20no
Vrmally`20show`20a
Xsmaller`20increase.
X
XDebugging`20now`20requires`20EITHER`20SYSPRV`20OR`20SETPRV`20to`20be`20in`20th
Ve`20user's`20AUTHORIZED
Xprivileges.`20Previously`20only`20SYSPRV`20was`20recognized`20and`20had`20to
V`20be`20in`20the`20user's
XCURRENT`20privileges.`20This`20means`20that`20users`20can`20now`20select`20deb
Vugging`20without
Xneeding`20to`20specifically`20turn`20on`20privileges.
X
X
X2.4`20New`20SHARE_UNPACK_TEMP`20Logical
X
XThe`20new`20logical`20name`20SHARE_UNPACK_TEMP`20can`20be`20used`20to`20overri
Vde`20the`20default
Xchoice`20of`20temporary`20filename`20used`20when`20unpacking`20a`20share`20fil
Ve.`20`20Previously,`20the
Xunpacking`20code`20used`20the`20same`20name`20"SHARE_TEMP"`20as`20that`20used
V`20by`20VMS_SHARE`20itself
Xwhen`20encoding.`20`20If`20not`20specified,`20the`20default`20name`20is:
XSYS$SCRATCH:SHARE_UNPACK_TEMP.pid
X
X
X
X2.5`20Small`20Part`20Sizes
X
XUnder`20certain`20conditions`20(with`20small`20part`20sizes),`20it`20was`20pos
Vsible`20for`20the
Xprocedure`20to`20generate`20a`20buffer`20that`20was`20not`20allowed`20to`20be
V`20split`20but`20was`20too`20big
Xfor`20the`20part`20buffer.`20`20A`20suitable`20error`20message`20was`20issued
V`20and`20the`20procedure
Xaborted.
X
XThe`20message`20produced`20now`20includes`20additional`20information`20stating
V`20the`20minimum
Xpart`20size`20required`20to`20encode`20the`20particular`20non-splittable`20buf
Vfer.
X
X
X3.`20BUG`20FIXES
X
XA`20number`20of`20minor`20bugs`20have`20been`20fixed.
X
X
X3.1`20Checksums`20on`20Files`20with`20Long`20Records
X
XThe`20long`20lines`20support`20introduced`20in`20version`208.0`20showed`20up
V`20a`20problem`20with`20the
Xundocumented`20DCL`20command`20-`20CHECKSUM.`20`20It`20appears`20that`20this
V`20will`20not`20handle
Xfiles`20with`20long`20records`20(the`20exact`20length`20seems`20unclear`20but
V`20it`20appears`20to`20be
Xabout`202048`20bytes).`20`20This`20means`20that`20VMS_SHARE`20is`20unable`20to
V`20provide`20checksum
Xverification`20for`20such`20files`20at`20present.
X
XPreviously,`20the`20code`20would`20provide`20an`20obscure`20error`20message
V`20at`20the`20point`20where
Xthe`20checksum`20was`20calculated,`20fail`20to`20produce`20a`20new`20checksum,
V`20and`20use`20a
Xpreviously`20calculated`20checksum`20as`20the`20value`20passed`20in`20the`20sh
Vare`20file;`20this`20had
Xthe`20effect`20of`20giving`20errors`20on`20a`20subsequent`20unpacking`20operat
Vion.
X
XNow,`20the`20code`20attempts`20to`20detect`20when`20the`20checksum`20cannot
V`20be`20determined`20and
Xgives`20messages`20at`20both`20the`20packing`20and`20unpacking`20stages,`20war
Vning`20that
Xverification`20of`20the`20file`20cannot`20be`20made.
X
X
X
X3.2`20`20Creation`20of`20the`20Package`20Index`20File
X
XDue`20to`20a`20coding`20error,`20the`20package`20index`20file`20was`20always
V`20being`20created.`20This
Xhas`20been`20fixed`20and`20the`20file`20is`20now`20created`20only`20when`20req
Vuested`20by`20the
X/PACKAGE_INDEX`20qualifier`20or`20the`20SHARE_PACKAGE_INDEX`20logical`20name.
X
X
X
X3.3`20Deletion`20of`20Temporary`20Files`20Following`20Unpacking
X
XDue`20to`20a`20coding`20error`20within`20the`20generated`20share`20file,`20the
V`20temporary`20files`20so
Xcreated`20were`20not`20being`20correctly`20deleted`20if`20the`20checksum`20val
Vidation`20check`20was
Xsuccessfully`20passed.`20They`20were`20deleted`20on`20a`20checksum`20failure.
V`20`20This`20problem`20has
Xnow`20been`20fixed`20by`20ensuring`20that`20the`20deletion`20of`20scratch`20fi
Vles`20code`20takes`20place
Xirrespective`20of`20any`20checksum`20status.
X
X
X
X3.4`20Erroneous`20Note`20in`20Release-Notes`20for`20Version`208.0
X
XSection`203.5`20of`20the`20previous`20release`20notes`20(Long`20DCL`20Lines)
V`20erroneously`20refers
Xto`20a`20problem`20about`20splitting`20parts`20across`20DCL`20continuation`20l
Vines.`20In`20fact,`20this
Xproblem`20did`20not`20exist`20in`20the`20released`20version`20and`20refers`20o
Vnly`20to`20a`20problem`20that
Xexisted`20during`20the`20development`20stage.`20Please`20ignore`20this`20probl
Vem`20description.
X
XA`20number`20of`20other`20minor`20corrections`20were`20made`20to`20these`20rel
Vease`20notes,`20and`20the
Xcorrected`20version`20may`20be`20found`20at`20the`20end`20of`20these`20release
V`20notes.
X
X
X
X3.5`20MFD`20Check
X
XIn`20the`20DCL`20routine`20`60Check_out_File',`20a`20check`20is`20made`20to
V`20see`20if`20the`20current
Xdirectory`20is`20the`20MFD`20`5B000000`5D.`20This`20check`20was`20incorrectly
V`20coded`20and`20could
Xaffect`20operation`20if`20the`20current`20directory`20was`20indeed`20`5B000000
V`5D.`20This`20check`20has
Xnow`20been`20corrected`20and`20should`20now`20correctly`20generate`20the`20sub
Vdirectory`20paths.
X
X
X
X3.6`20Non`20Negatable`20Qualifiers
X
XError`20messages`20are`20now`20issued`20for`20qualifiers`20that`20may`20not
V`20be`20negated.`20For
Xexample:`20`20/NOPART_SIZE.
X
X
X3.7`20Failures`20to`20Create`20Temporary`20Files
X
XMore`20error`20checks`20have`20been`20introduced`20during`20the`20creation`20a
Vnd`20writing`20of
Xvarious`20intermediate`20files.
X
X
X
X4.`20CHANGES`20IN`20OPERATION
X
XThe`20following`20changes`20in`20operation`20have`20occurred.
X
X
X4.1`20Debug`20Facility
X
XThe`20/DEBUG`20facility`20has`20been`20modified.
X
XThe`20maximum`20debug`20level`20is`20now`204`20rather`20than`203.`20Most`20deb
Vug`20messages`20have`20been
Xincreased`20to`20a`20higher`20level`20and`20new`20ones`20inserted`20at`20level
V`201`20to`20show`20the`20BEFORE
Xand`20AFTER`20state`20of`20the`20file`20buffer`20(see`20paragraph`20above`20un
Vder`20new`20features).
XThe`20use`20of`20/DEBUG=1`20now`20provides`20a`20simple`20progress`20check`20o
Vn`20the`20state`20of`20the
Xpacking,`20listing`20each`20file`20as`20it`20is`20read`20in,`20each`20file`20b
Vuffer`20before`20and`20after
Xencoding,`20and`20each`20part`20as`20it`20is`20written`20out.
X
X
X4.2`20ShareFile`20Unpack`20Code
X
XThe`20TPU`20code`20created`20in`20the`20share`20file`20to`20unpack`20each`20fi
Vle`20has`20been`20modified`20to
Xbe`20more`20modular.`20Some`20coding`20reductions`20have`20been`20introduced
V`20to`20slightly
Xincrease`20the`20unpacking`20speed.
X
X
X
X5.`20DOCUMENTATION`20CHANGES
X
XDocumentation`20has`20been`20updated`20to`20reflect`20the`20new`20date`20based
V`20selection,`20the
Xconfirmation`20qualifier,`20the`20new`20debug`20levels,`20the`20new`20SHARE_UN
VPACK_TEMP`20logical
Xand`20the`20checksum`20limitation.
X
X
X
X6.`20MISCELLANEOUS`20NOTES
X
X6.1`20`20Long`20line`20support
X
XWith`20the`20addition`20of`20long`20line`20support,`20a`20check`20is`20include
Vd`20on`20the`20maximum
Xrecord`20size`20of`20a`20file`20before`20it`20is`20selected`20for`20packaging.
V`20The`20maximum`20record
Xsize`20is`20obtained`20using`20the`20DCL`20lexical`20function`20f$file_attribu
Vtes`20with`20the
X"MRS"`20item`20code.`20`20Under`20certain`20conditions,`20as`20yet`20unknown,
V`20this`20DCL`20lexical
Xreturns`20a`20wildly`20inaccurate`20value.`20The`20only`20common`20factor`20so
V`20far`20seems`20to`20be
Xthat`20the`20files`20are`20the`20output`20from`20the`20DOCUMENT`20utility;`20i
Vt`20has`20been`20seen`20only
Xon`20the`20.TXT`20and`20.PS`20files`20output`20by`20this.`20DIR/FULL`20on`20th
Ve`20file`20shows`20the
XCORRECT`20record`20length.
X
XCurrently,`20there`20is`20nothing`20that`20VMS_SHARE`20can`20do`20about`20this
V.`20The`20effect`20is
Xeither`20to`20reject`20files`20erroneously`20because`20the`20record`20length
V`20is`20seen`20as`20much
Xtoo`20large,`20or`20to`20accept`20files`20erroneously`20because`20the`20record
V`20length`20is`20seen`20as
Xaceptable.`20Use`20of`20the`20long`20lines`20support`20option`20will`20accept
V`20both`20files`20and
Xcorrectly`20package`20them.
X
XWithout`20long`20lines`20support,`20the`20only`20known`20workaround`20is`20to
V`20use`20the`20editor`20to
Xmake`20a`20null`20correction`20to`20the`20file`20and`20force`20a`20new`20versi
Von`20to`20be`20created`20(EVE
Xworks`20fine`20for`20this)`20thus`20rewriting`20the`20record`20length`20based
V`20on`20the`20actual`20data
Xin`20the`20file.`20Following`20this,`20the`20file`20can`20be`20packaged`20with
Vout`20the`20use`20of`20the
Xlong`20lines`20support`20option.
X
X
X
X7.`20TESTING
X
XThis`20version`20of`20VMS_SHARE`20has`20only`20been`20tested`20on`20VMS`205.5-
V1`20but`20is`20believed`20to
Xwork`20`20on`20all`20versions`20from`20VMS`205.0`20to`20VMS`205.5-1.`20`20Howe
Vver,`20it`20is`20not`20supported`20
Xformally`20on`20any`20version`20of`20VMS`20other`20than`20the`20one`20on`20whi
Vch`20it`20has`20been`20tested.
X
XThe`20share`20files`20generated`20by`20VMS_SHARE`20are`20believed`20to`20unpac
Vk`20correctly`20on`20all
Xversions`20of`20TPU`20from`20VMS`204.4`20onwards`20unless`20the`20/LONGLINES
+-+-+-+-+-+-+-+-  END  OF PART 5 +-+-+-+-+-+-+-+-