home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / vmsnet / sources / 495 < prev    next >
Encoding:
Internet Message Format  |  1993-01-25  |  47.3 KB
  1. Path: sparky!uunet!usc!news.service.uci.edu!unogate!mvb.saic.com!vmsnet-sources
  2. Newsgroups: vmsnet.sources
  3. From: "Andy, Systems Manager" <UDAA055@ELM.CC.KCL.AC.UK>
  4. Subject: VMS_SHARE V8.2, part 05/09
  5. Message-ID: <10312300@MVB.SAIC.COM>
  6. Date: Mon, 25 Jan 1993 21:34:32 GMT
  7. Lines: 1354
  8. Followup-To: vmsnet.sources.d
  9. Approved: Mark.Berryman@Mvb.Saic.Com
  10.  
  11. Submitted-by: "Andy, Systems Manager" <UDAA055@ELM.CC.KCL.AC.UK>
  12. Posting-number: Volume 4, Issue 49
  13. Archive-name: vms_share/part05
  14. Supersedes: vms_share: Volume 3, Issue 87-89
  15.  
  16. -+-+-+-+-+-+-+-+ START OF PART 5 -+-+-+-+-+-+-+-+
  17. X
  18. X`20`20/BEFORE`20without`20a`20date`20specification`20implies`20midnight`20on
  19. V`20the
  20. X`20`20current`20day`20I.E.`20is`20equivalent`20to
  21. X`20`20/BEFORE=xx-mmm-yyyy:00:00:00.00
  22. X
  23. X`20`20Used`20in`20conjunction`20with`20the`20/SINCE`20qualifier`20allows`20fil
  24. Ves`20to
  25. X`20`20be`20selected`20within`20a`20range`20of`20dates.
  26. X
  27. X/COMPRESS
  28. X
  29. X`20`20/`5BNO`5DCOMPRESS`5B=n`5D
  30. X
  31. X`20`20Selects`20additional`20compression.`20The`20value`20of`20the`20integer
  32. V`20n
  33. X`20`20determines`20the`20type`20of`20compression`20attempted.
  34. X
  35. X`20`20If`20n`20is`200,`20no`20additional`20compression`20is`20attempted.`20Thi
  36. Vs`20is
  37. X`20`20equivalent`20to`20/NOCOMPRESS.
  38. X
  39. X`20`20If`20n`20is`201,`20then`20run-length`20encoding`20compression`20is`20sel
  40. Vected.
  41. X`20`20Each`20file`20packaged`20is`20searched`20for`20sequences`20(runs)`20of
  42. V`20the`20same
  43. X`20`20character`20and`20each`20run`20is`20encoded`20into`20a`20shorter`20seque
  44. Vnce.`20This
  45. X`20`20is`20equivalent`20to`20/COMPRESS`20without`20a`20numeric`20value`20attac
  46. Vhed.
  47. X
  48. X`20`20If`20n`20is`202,`20then`20a`20modified`20form`20of`20Lempel-Ziv`20compre
  49. Vssion`20is
  50. X`20`20selected.`20Each`20file`20packaged`20is`20searched`20for`20common`20subs
  51. Vtrings
  52. X`20`20and`20occurences`20after`20the`20first`20are`20encoded`20where`20possibl
  53. Ve`20to`20a
  54. X`20`20shorter`20sequence.
  55. X
  56. X`20`20This`20option`20is`20time`20consuming`20so`20the`20normal`20default`20is
  57. V
  58. X`20`20/NOCOMPRESS
  59. X
  60. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  61. V`20logical
  62. X`20`20name`20SHARE_COMPRESS.
  63. X
  64. X/CONFIRM
  65. X
  66. X`20`20/`5BNO`5DCONFIRM
  67. X
  68. X`20`20Selects`20user`20confirmation`20of`20files`20selected`20for`20packaging.
  69. V`20Each
  70. X`20`20file`20selected`20by`20parameters`20and`20qualifiers`20is`20displayed
  71. V`20and`20the
  72. X`20`20user`20must`20enter`20Y`20to`20select`20it`20or`20N`20not`20to`20select
  73. V`20it.`20The
  74. X`20`20default`20selection`20is`20N.`20If`20a`20file`20is`20not`20selected,`20t
  75. Vhen`20it`20is
  76. X`20`20not`20packaged.
  77. X
  78. X`20`20Confirmation`20is`20only`20permitted`20in`20an`20INTERACTIVE`20mode.`20I
  79. Vn`20any
  80. X`20`20other`20mode,`20a`20warning`20message`20is`20issued`20and`20confirmation
  81. V`20is
  82. X`20`20turned`20off.
  83. X
  84. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  85. V`20logical
  86. X`20`20name`20SHARE_CONFIRM.
  87. X
  88. X/CREATED
  89. X
  90. X`20`20/CREATED
  91. X
  92. X`20`20Specifies`20that`20files`20selected`20on`20the`20basis`20of`20date`20(vi
  93. Va`20the
  94. X`20`20/BEFORE`20and/or`20/SINCE`20qualifiers)`20should`20use`20the`20`60creati
  95. Von
  96. X`20`20date'`20as`20the`20basis`20of`20selection.
  97. X
  98. X`20`20If`20any`20combination`20of`20/BACKUP,`20/CREATED,`20EXPIRED`20and`20/MO
  99. VDIFIED
  100. X`20`20are`20specified`20together,`20then`20only`20the`20last`20one`20specified
  101. V`20takes
  102. X`20`20effect.
  103. X
  104. X`20`20The`20default`20is`20to`20use`20the`20`60last`20modified`20date'.
  105. X
  106. X/DEBUG
  107. X
  108. X`20`20/`5BNO`5DDEBUG`5B=n`5D
  109. X
  110. X`20`20Selects`20debugging.`20Additional`20trace`20messages`20are`20output`20to
  111. V
  112. X`20`20assist`20developers`20of`20the`20utility.`20It`20can`20only`20be`20selec
  113. Vted`20if
  114. X`20`20the`20user`20is`20suitably`20privileged.`20The`20normal`20default`20is
  115. V`20/NODEBUG
  116. X
  117. X`20`20The`20/DEBUG`20qualifier`20selects`20a`20particular`20level`20of`20debug
  118. Vging;
  119. X`20`20the`20higher`20the`20level,`20the`20more`20extensive`20and`20detailed
  120. V`20are`20the
  121. X`20`20debug`20messages.`20A`20level`20of`200`20is`20equivalent`20to`20/NODEBUG
  122. V,`20a`20level
  123. X`20`20of`201`20is`20equivalent`20to`20/DEBUG.`20The`20maximum`20level`20curren
  124. Vtly
  125. X`20`20supported`20is`204.
  126. X
  127. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  128. V`20logical
  129. X`20`20name`20SHARE_DEBUG.
  130. X
  131. X/DIRECTORY
  132. X
  133. X`20`20/`5BNO`5DDIRECTORY
  134. X
  135. X`20`20Selects`20the`20directory`20preservation`20option.`20When`20selected,
  136. V`20the
  137. X`20`20directory`20name`20is`20preserved`20on`20each`20file`20packaged,`20such
  138. V`20that`20the
  139. X`20`20unpacking`20operation`20will`20recreate`20the`20directory`20structure.
  140. V`20If`20not
  141. X`20`20selected,`20then`20the`20directory`20name`20will`20not`20be`20preserved
  142. V`20and`20each`20file
  143. X`20`20will`20be`20unpacked`20into`20the`20current`20directory.
  144. X
  145. X`20`20If`20/NODIRECTORY`20is`20selected,`20then`20the`20files`20to`20be`20pack
  146. Vaged`20may`20exist
  147. X`20`20anywhere`20in`20the`20system.`20`20If`20/DIRECTORY`20is`20selected,`20th
  148. Ven`20the`20files`20to
  149. X`20`20be`20packaged`20must`20exist`20at`20or`20below`20the`20current`20directo
  150. Vry`20and`20the
  151. X`20`20relative`20directory`20name`20will`20be`20recorded`20in`20the`20share
  152. V`20file.
  153. X
  154. X`20`20The`20default`20is`20/DIRECTORY,`20to`20preserve`20the`20directory`20str
  155. Vucture,`20but
  156. X`20`20this`20can`20be`20overidden`20by`20defining`20the`20logical`20name`20SHA
  157. VRE_DIRECTORY.
  158. X
  159. X/EXCLUDE
  160. X
  161. X`20`20/`5BNO`5DEXCLUDE`5B=list`5D
  162. X
  163. X`20`20Specifies`20that`20files`20matching`20any`20of`20the`20specifications
  164. V`20given
  165. X`20`20by`20`60list'`20are`20to`20be`20excluded`20from`20the`20packaging`20oper
  166. Vation.`20Each
  167. X`20`20file`20specification`20in`20the`20list`20may`20be`20any`20combination
  168. V`20of`20the
  169. X`20`20directory,`20name,`20type`20and`20version`20fields.`20Missing`20fields
  170. V`20are
  171. X`20`20assumed`20to`20be`20`60*'`20(meaning`20anything).
  172. X
  173. X`20`20An`20`60*'`20may`20only`20be`20used`20to`20represent`20a`20complete`20fi
  174. Veld.`20It`20may
  175. X`20`20NOT`20be`20used`20to`20represent`20a`20partial`20field.`20E.G.`20`20`5B*
  176. V`5D`20is`20allowed,
  177. X`20`20but`20`5BXYZ*`5D`20is`20not.
  178. X
  179. X`20`20By`20default,`20no`20files`20are`20excluded.
  180. X
  181. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20up`20by
  182. V`20the
  183. X`20`20logical`20name`20SHARE_EXCLUDE.`20Note`20that`20it`20does`20NOT`20overri
  184. Vde`20any
  185. X`20`20defaults`20set`20up`20by`20the`20logical`20names`20SHARE_EXCLUDE_NAMES,
  186. X`20`20SHARE_EXCLUDE_DIRS,`20SHARE_EXCLUDE_TYPES`20and
  187. X`20`20SHARE_EXCLUDE_FILES.`20However,`20these`20logicals`20will`20be`20removed
  188. V`20in
  189. X`20`20a`20future`20release`20and`20should`20be`20avoided.
  190. X
  191. X/EXPIRED
  192. X
  193. X`20`20/EXPIRED
  194. X
  195. X`20`20Specifies`20that`20files`20selected`20on`20the`20basis`20of`20date`20(vi
  196. Va`20the
  197. X`20`20/BEFORE`20and/or`20/SINCE`20qualifiers)`20should`20use`20the`20`60expira
  198. Vtion
  199. X`20`20date'`20as`20the`20basis`20of`20selection.
  200. X
  201. X`20`20If`20any`20combination`20of`20/BACKUP,`20/CREATED,`20EXPIRED`20and`20/MO
  202. VDIFIED
  203. X`20`20are`20specified`20together,`20then`20only`20the`20last`20one`20specified
  204. V`20takes
  205. X`20`20effect.
  206. X
  207. X`20`20The`20default`20is`20to`20use`20the`20`60last`20modified`20date'.
  208. X
  209. X/LOG
  210. X
  211. X`20`20/`5BNO`5DLOG
  212. X
  213. X`20`20Selects`20logging.`20Informational`20messages`20are`20output`20to`20the
  214. V`20user
  215. X`20`20to`20identify`20various`20stages`20in`20the`20packaging`20operation.`20T
  216. Vhe
  217. X`20`20normal`20default`20is`20/NOLOG
  218. X
  219. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  220. V`20logical
  221. X`20`20name`20SHARE_LOG.
  222. X
  223. X/LONGLINES
  224. X
  225. X`20`20/`5BNO`5DLONGLINES
  226. X
  227. X`20`20Selects`20long`20line`20support.`20The`20underlying`20TPU`20package`20re
  228. Vstricts
  229. X`20`20the`20maximum`20record`20length`20of`20a`20file`20to`20be`20packaged.
  230. V`20Older
  231. X`20`20versions`20(pre-5.4)`20restrict`20the`20length`20to`20960`20bytes;`20new
  232. Ver
  233. X`20`20versions`20(post-5.4)`20allow`20up`20to`2065535`20bytes`20per`20record.
  234. V`20For
  235. X`20`20compatibility,`20the`20older`20record`20length`20is`20used`20(/NOLONGLIN
  236. VES).
  237. X`20`20If`20long`20lines`20are`20selected,`20then`20the`20underlying`20VMS`20mu
  238. Vst`20be`20at
  239. X`20`20least`20VMS`205.4`20and`20the`20generated`20share`20file`20will`20requir
  240. Ve`20at
  241. X`20`20least`20VMS`205.4`20to`20unpack.
  242. X
  243. X`20`20There`20is`20no`20advantage`20in`20selecting`20this`20option`20if`20none
  244. V`20of`20the
  245. X`20`20files`20to`20be`20packaged`20have`20records`20longer`20than`20960`20byte
  246. Vs.`20In
  247. X`20`20fact,`20it`20will`20be`20a`20disadvantage`20if`20the`20share`20file`20is
  248. V`20to`20be
  249. X`20`20unpacked`20on`20an`20older`20version`20of`20VMS.
  250. X
  251. X`20`20For`20some`20types`20of`20file,`20the`20maximum`20record`20size`20is`20s
  252. Vtored`20as`200
  253. X`20`20in`20the`20file`20header;`20this`20may`20lead`20to`20some`20files`20with
  254. V`20long`20lines
  255. X`20`20not`20being`20detected`20during`20packaging.`20If`20the`20long`20lines
  256. V`20option
  257. X`20`20has`20NOT`20been`20selected`20then`20the`20created`20share`20file`20may
  258. V`20not
  259. X`20`20unpack`20properly`20under`20early`20versions`20of`20VMS.
  260. X
  261. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  262. V`20logical
  263. X`20`20name`20SHARE_LONGLINES.
  264. X
  265. X/MODIFIED
  266. X
  267. X`20`20/MODIFIED
  268. X
  269. X`20`20Specifies`20that`20files`20selected`20on`20the`20basis`20of`20date`20(vi
  270. Va`20the
  271. X`20`20/BEFORE`20and/or`20/SINCE`20qualifiers)`20should`20use`20the`20`60last
  272. V`20modified
  273. X`20`20date'`20as`20the`20basis`20of`20selection.
  274. X
  275. X`20`20If`20any`20combination`20of`20/BACKUP,`20/CREATED,`20EXPIRED`20and`20/MO
  276. VDIFIED
  277. X`20`20are`20specified`20together,`20then`20only`20the`20last`20one`20specified
  278. V`20takes
  279. X`20`20effect.
  280. X
  281. X`20`20The`20default`20is`20to`20use`20the`20`60last`20modified`20date'.
  282. X
  283. X/PACKAGE_INDEX
  284. X
  285. X`20`20/`5BNO`5DPACKAGE_INDEX`5B=suffix`5D
  286. X
  287. X`20`20Selects`20the`20automatic`20creation`20of`20an`20index`20file,`20contain
  288. Ving`20a
  289. X`20`20list`20of`20the`20filenames`20of`20each`20part`20written.`20This`20is
  290. V`20known`20as`20a
  291. X`20`20package`20index`20and`20is`20useful`20for`20mail`20based`20file`20server
  292. Vs`20which
  293. X`20`20allow`20users`20to`20request`20the`20package`20file`20and`20get`20sent
  294. V`20all`20the
  295. X`20`20files`20whose`20names`20it`20contains.
  296. X
  297. X`20`20/NOPACKAGE_INDEX`20(the`20default)`20requests`20that`20no`20package`20in
  298. Vdex
  299. X`20`20file`20is`20to`20be`20created.
  300. X
  301. X`20`20/PACKAGE_INDEX`20requests`20that`20a`20package`20index`20file`20is`20to
  302. V`20be
  303. X`20`20created`20with`20the`20default`20suffix`20type`20of`20".$PACKAGE"
  304. X
  305. X`20`20/PACKAGE_INDEX=suffix`20requests`20that`20a`20package`20index`20file`20i
  306. Vs`20to
  307. X`20`20be`20created`20using`20`60suffix'`20as`20the`20type.`20`60suffix'`20must
  308. V`20be`20a`20valid
  309. X`20`20file`20type,`20such`20as`20".LIBRARY",`20and`20the`20initial`20dot`20is
  310. V`20required.
  311. X
  312. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  313. V`20logical
  314. X`20`20name`20SHARE_PACKAGE_INDEX.
  315. X
  316. X/PART_SIZE
  317. X
  318. X`20`20/PART_SIZE=n
  319. X
  320. X`20`20Selects`20the`20size`20of`20a`20share`20file`20part,`20in`20blocks.`20Th
  321. Ve`20part`20size
  322. X`20`20must`20be`20sufficient`20to`20contain`20the`20initial`20control`20inform
  323. Vation`20so
  324. X`20`20a`20value`20of`20at`20least`206`20blocks`20is`20recommended.`20If`20the
  325. V`20size`20is`20too
  326. X`20`20small,`20then`20a`20fatal`20error`20will`20be`20issued`20during`20the
  327. V`20packing
  328. X`20`20operation.
  329. X
  330. X`20`20The`20usual`20default`20size`20is`2030`20blocks.
  331. X
  332. X`20`20Use`20of`20this`20qualifier`20overrides`20any`20default`20set`20by`20the
  333. V`20logical
  334. X`20`20name`20SHARE_PART_SIZE.
  335. X
  336. X/SINCE
  337. X
  338. X`20`20/SINCE`5B=date`5D
  339. X
  340. X`20`20Selects`20only`20files`20with`20access`20dates`20after`20the`20date`20sp
  341. Vecified.
  342. X`20`20By`20default,`20the`20date`20does`20not`20have`20to`20be`20after`20any
  343. V`20specific
  344. X`20`20date`20to`20be`20selected.
  345. X
  346. X`20`20The`20date`20specification`20can`20be`20any`20absolute`20or`20delta`20ti
  347. Vme
  348. X`20`20combination`20normally`20acceptable`20to`20VMS`20with`20ONE`20exception
  349. V`20-`20it
  350. X`20`20may`20not`20contain`20any`20spaces.`20`20To`20enter`20a`20combined`20dat
  351. Ve`20and`20time,
  352. X`20`20use`20a`20colon`20to`20separate`20to`20two`20E.G.`20`2010-AUG-1992:15:00
  353. V:00.00.
  354. X`20`20Any`20missing`20field`20is`20taken`20to`20be`20that`20of`20the`20CURRENT
  355. V`20time.
  356. X
  357. X`20`20/SINCE`20without`20a`20date`20specification`20implies`20midnight`20on
  358. V`20the
  359. X`20`20current`20day`20I.E.`20is`20equivalent`20to
  360. X`20`20/SINCE=xx-mmm-yyyy:00:00:00.00
  361. X
  362. X`20`20Used`20in`20conjunction`20with`20the`20/BEFORE`20qualifier`20allows`20fi
  363. Vles`20to
  364. X`20`20be`20selected`20within`20a`20range`20of`20dates.
  365. X
  366. X/VERSION
  367. X
  368. X`20`20/`5BNO`5DVERSION
  369. X
  370. X`20`20Selects`20the`20Version`20number`20preservation`20option.`20Each`20file
  371. X`20`20packaged`20will`20have`20its`20current`20version`20number`20preserved
  372. V`20across
  373. X`20`20the`20packaging`20and`20unpackaging`20operation.
  374. X
  375. X`20`20If`20/VERSION`20is`20selected,`20the`20`20version`20numbers`20are`20pres
  376. Verved`20on
  377. X`20`20each`20file`20packaged,`20and`20the`20unpacking`20process`20will`20creat
  378. Ve`20the
  379. X`20`20same`20version`20of`20the`20file.
  380. X
  381. X`20`20If`20/NOVERSION`20is`20selected,`20then`20version`20numbers`20are`20stri
  382. Vpped
  383. X`20`20from`20each`20file`20packaged;`20the`20unpacking`20process`20will`20crea
  384. Vte`20a
  385. X`20`20new`20version`20of`20the`20file`20regardless`20of`20the`20existence`20of
  386. V`20any
  387. X`20`20existing`20file`20with`20the`20same`20name.`20
  388. X
  389. X`20`20The`20default`20is`20to`20preserve`20the`20version`20numbers,`20but`20th
  390. Vis
  391. X`20`20default`20can`20be`20overidden`20by`20defining`20the`20logical`20name
  392. X`20`20SHARE_VERSION
  393. X
  394. X2`20PAKMAIL
  395. X
  396. XThe`20PAKMAIL`20utility`20may`20be`20used`20to`20send`20the`20generated`20part
  397. Vs`20of
  398. Xthe`20sharefile`20to`20one`20or`20more`20recipients`20over`20the`20electronic
  399. V`20mail
  400. Xnetwork.`20Consult`20the`20separate`20help`20entry`20for`20full`20details.`20
  401. X
  402. X2`20Sharefile
  403. X
  404. XThe`20name`20of`20the`20packed`20output`20file.`20This`20name`20will`20be`20su
  405. Vffixed`20by
  406. Xthe`20part`20number`20even`20if`20there`20is`20only`201`20part`20created.`20
  407. X
  408. XA`20prompt`20is`20issued`20if`20no`20sharefile`20name`20is`20specified.
  409. X2`20Version
  410. XThis`20describes`20version`208.2`20of`20VMS_SHARE;`20dated`20January`201993
  411. $ call unpack VMS_SHARE.HLP;34 1629535921 ""
  412. $!
  413. $ create 'f'
  414. X`20`20`20`20`20`20`20`20`09`09`09V`20M`20S`20_`20S`20H`20A`20R`20E
  415. X
  416. X`20`20`20`20`09`09`09`20`20`20R`20E`20L`20E`20A`20S`20E`20`20`20N`20`20O`20T
  417. V`20E`20S
  418. X
  419. X`20`20`20`20`09`09`09`09`09`09`09`09Version`208.2
  420. X`20`20`20`20`09`09`09`09`09`09`09`09Jan`201993
  421. X
  422. X-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
  423. V`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
  424. V`20-
  425. X
  426. XThis`20software`20is`20copyright`20but`20may`20be`20freely`20distributed`20wit
  427. Vhout`20charge`20to
  428. Xanyone.`20All`20copyright`20and`20ownership`20notices`20must`20remain`20intact
  429. V.`20No`20warranties
  430. Xare`20offered`20as`20to`20the`20suitability`20of`20this`20software`20for`20any
  431. V`20purpose;`20any
  432. Xerrors`20arising`20from`20its`20use`20are`20entirely`20the`20responsibility
  433. V`20of`20the`20user.
  434. X
  435. X(C)`20Andy`20Harper,
  436. X`20`20`20`20Kings`20College`20London,
  437. X`20`20`20`20England
  438. X
  439. X-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
  440. V`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-`20-
  441. V`20-
  442. X
  443. X
  444. X1.`20INTRODUCTION
  445. X
  446. XVersion`208.2`20of`20VMS_SHARE`20is`20a`20major`20release`20which`20fixes`20a
  447. V`20number`20of`20bugs`20and
  448. Xmakes`20a`20number`20of`20new`20features`20available.
  449. X
  450. X
  451. X
  452. X2.`20NEW`20FEATURES
  453. X
  454. X2.1`20`20File`20Exclusion
  455. X
  456. XThe`20new`20/EXCLUDE=filelist`20qualifier`20may`20be`20used`20to`20exclude`20a
  457. V`20set`20of`20files`20from
  458. Xthe`20packaging`20operation.`20`20`60Filelist'`20is`20a`20comma`20separated
  459. V`20list`20of`20full`20or
  460. Xpartial`20file`20name`20specifications.`20Each`20field`20in`20a`20filename`20s
  461. Vpecification`20(Field
  462. X=`20DIRECTORY,`20NAME,`20TYPE`20or`20VERSION`20part)`20may`20be`20omitted`20or
  463. V`20may`20be`20a`20specific
  464. Xdirectory,`20name,`20type`20or`20version`20in`20the`20usual`20format.`20Fields
  465. V`20which`20are`20omitted
  466. Xare`20assumed`20to`20match`20anything.`20Files`20which`20match`20the`20specifi
  467. Vcation`20are`20excluded
  468. Xfrom`20the`20packaging`20operation.
  469. X
  470. XSome`20examples:
  471. X
  472. X`20`20/EXCLUDE=.FOR`09`09Exclude`20all`20files`20with`20a`20.FOR`20file`20type
  473. V
  474. X
  475. X`20`20/EXCLUDE=.EXE,.OBJ`09Exclude`20all`20files`20with`20a`20.EXE`20or`20a
  476. V`20.OBJ`20file`20type
  477. X
  478. X`20`20/EXCLUDE=DUMMY.DAT`09Exclude`20any`20file`20called`20DUMMY.DAT`20regardl
  479. Vess`20of
  480. X`09`09`09directory`20or`20version
  481. X
  482. X`20`20/EXCLUDE=;1`09`09Exclude`20all`20version`201`20files
  483. X
  484. X`20`20/EXCLUDE=`5BX`5DDUMMY.DAT`09Exclude`20all`20versions`20of`20the`20file
  485. V`20DUMMY.DAT`20in`20directory
  486. X`09`09`09`5BX`5D
  487. X
  488. XWildcards`20are`20not`20permitted,`20although`20an`20`60*'`20can`20be`20used
  489. V`20in`20the`20usual`20place
  490. XONLY`20to`20specify`20a`20complete`20field`20(NOT`20partial`20fields).`20For
  491. V`20example:
  492. X
  493. X`20`20/EXCLUDE=*.FOR`09Is`20allowed`20and`20excludes`20all`20files`20with`20a
  494. V`20type`20of`20.FOR
  495. X
  496. X`20`20/EXCLUDE=X*.FOR`09Is`20NOT`20allowed`20as`20the`20asterisk`20is`20used
  497. V`20to`20match`20only
  498. X`09`09`09part`20of`20the`20name`20field`20and`20not`20the`20whole`20field.
  499. X
  500. X
  501. XThe`20default`20is`20to`20include`20all`20files`20specified`20by`20the`20user'
  502. Vs`20parameter`20list.
  503. XHowever`20the`20new`20SHARE_EXCLUDE`20logical`20name`20may`20be`20defined`20wi
  504. Vth`20a`20list`20of
  505. Xexclusions`20to`20override`20this`20default.`20`20Use`20of`20the`20/EXCLUDE
  506. V`20qualifier`20overrides
  507. Xthe`20setting`20of`20this`20logical`20name`20for`20any`20given`20run.
  508. X
  509. XNote`20that`20this`20qualifier`20and`20logical`20name`20makes`20redundant`20th
  510. Ve`20following`20logical
  511. Xnames:
  512. X
  513. X`20`20`20SHARE_EXCLUDE_DIRS`09To`20exclude`20directories
  514. X`20`20`20SHARE_EXCLUDE_FILES`09To`20exclude`20specific`20filenames
  515. X`20`20`20SHARE_EXCLUDE_NAMES`09To`20exclude`20files`20with`20specific`20names
  516. X`20`20`20SHARE_EXCLUDE_TYPES`09To`20exclude`20specific`20file`20types
  517. X
  518. XThese`20logical`20names`20`20are`20still`20recognized`20in`20addition`20to`20t
  519. Vhe`20SHARE_EXCLUDE
  520. Xlogical`20name,`20but`20the`20effect`20is`20overriden`20if`20the`20/EXCLUDE
  521. V`20qualifier`20is`20used.
  522. XThey`20will`20be`20removed`20in`20a`20future`20release`20of`20the`20software.
  523. X
  524. X
  525. X2.2`20New`20Compression`20Mechanism
  526. X
  527. XPrevious`20releases`20have`20supported`20a`20simple`20compression`20mechanism
  528. V`20based`20on
  529. Xrun-length`20encoding,`20which`20is`20a`20simple`20but`20unsophisticated`20alg
  530. Vorithm`20for
  531. Xreducing`20the`20size`20of`20the`20packaged`20files`20by`20encoding`20sequence
  532. Vs`20of`20the`20same
  533. Xcharacter`20into`20a`20shorter`20sequence.`20This`20version`20introduces`20an
  534. V`20additional
  535. Xtechnique`20based`20on`20the`20algorithm`20popularly`20referred`20to`20as`20Le
  536. Vmpel-Ziv`20encoding,
  537. Xwhere`20substrings`20are`20encoded`20into`20a`20form`20that`20points`20back
  538. V`20to`20a`20previous
  539. Xoccurrence`20of`20the`20same`20substring.`20This`20results`20in`20a`20more`20s
  540. Vignificant
  541. Xcompression`20ratio`20at`20the`20expense`20of`20more`20CPU`20time`20to`20packa
  542. Vge`20the`20file.
  543. X
  544. XThe`20`60official'`20Lempel-Ziv`20algorithm`20has`20been`20substantially`20mod
  545. Vified`20to`20take
  546. Xinto`20account`20the`20additional`20constraints`20of`20this`20application.`20A
  547. Vs`20such,`20it`20is`20not
  548. Xas`20effective`20as`20`60real'`20lempel-ziv`20but`20appears`20to`20do`20a`20re
  549. Vasonable`20job`20in`20the
  550. Xmajority`20of`20files`20with`20which`20it`20has`20been`20tested.`20As`20before
  551. V,`20selection`20of`20this
  552. Xcompression`20technique`20may`20be`20of`20little`20benefit`20in`20some`20cases
  553. V`20and`20is`20very`20much
  554. Xslower`20than`20selecting`20no`20compression;`20therefore`20it`20is`20NOT`20se
  555. Vlected`20by`20default.
  556. X
  557. XTo`20allow`20user`20selection`20of`20this`20mechanism,`20the`20/COMPRESS`20qua
  558. Vlifier`20(and
  559. Xcorresponding`20logical`20name`20SHARE_COMPRESS)`20has`20been`20modified`20to
  560. V`20accept`20a
  561. Xnumeric`20parameter.`20The`20value`20specifies`20the`20compression`20mechanism
  562. V`20to`20be`20used.
  563. X
  564. XCurrently:
  565. X
  566. X`20`20`20/COMPRESS=0`09`09Specifies`20no`20additional`20compression
  567. X`20`20`20/COMPRESS=1`09`09Specifies`20run-length`20encoding
  568. X`20`20`20/COMPRESS=2`09`09Specifies`20the`20modified`20Lempel-Ziv`20compressio
  569. Vn
  570. X
  571. XOther`20values`20are`20not`20permitted.`20/COMPRESS`20by`20itself`20is`20the
  572. V`20same`20as`20/COMPRESS=1;
  573. X/NOCOMPRESS`20is`20the`20same`20as`20/COMPRESS=0
  574. X
  575. XNOTE:`20it`20is`20NOT`20intended`20that`20this`20form`20of`20compression`20sho
  576. Vuld`20supplant`20that
  577. Xwhich`20can`20be`20obtained`20by`20external`20means,`20such`20as`20the`20ZIP
  578. V`20utility,`20which`20can
  579. Xalways`20be`20used`20if`20required.`20However,`20it`20has`20the`20advantage
  580. V`20of`20being`20easy`20to`20use
  581. Xand`20not`20requiring`20the`20recipient`20to`20have`20any`20external`20decompr
  582. Vession`20tools.
  583. X
  584. X
  585. X
  586. X2.3`20Support`20for`20VFC`20files
  587. X
  588. XThis`20release`20introduces`20support`20for`20the`20record`20format`20VFC,`20a
  589. Vnd`20associated`20fixed
  590. Xcontrol`20area.
  591. X
  592. X
  593. X2.4`20Enhanced`20/LOG`20qualifier
  594. X
  595. XThe`20/LOG`20qualifier`20may,`20like`20/COMPRESS,`20now`20take`20a`20numeric
  596. V`20parameter`20to`20specify
  597. Xthe`20level`20of`20logging`20required`20-`20/LOG=n.`20Permitted`20values`20are
  598. V`200,`201`20and`202.
  599. X
  600. X/LOG=0`20specifies`20no`20logging`20output`20is`20to`20be`20produced.`20It`20i
  601. Vs`20equivalent`20to
  602. X/NOLOG.
  603. X
  604. X/LOG=1`20specifies`20that`20minimal`20logging`20should`20be`20produced,`20just
  605. V`20a`20summary`20of
  606. Xeach`20file`20as`20it`20is`20processed,`20a`20final`20summary`20of`20the`20num
  607. Vber`20of`20parts
  608. Xgenerated,`20and`20a`20note`20about`20the`20package`20index`20file`20if`20one
  609. V`20has`20been`20requested.
  610. XIt`20is`20equivalent`20to`20/LOG`20with`20no`20parameter.
  611. X
  612. X/LOG=2`20specifies`20that`20additional`20logging`20is`20to`20be`20produced`20o
  613. Vver`20and`20above`20that
  614. Xof`20level`201.`20Currently,`20this`20produces`20a`20summary`20of`20the`20file
  615. V`20encoding`20statistics
  616. Xbefore`20and`20after`20encoding`20as`20an`20aid`20in`20determining`20the`20eff
  617. Vectiveness`20of`20the
  618. Xcompression.`20Previously,`20this`20output`20was`20part`20of`20the`20/DEBUG
  619. V`20facility`20and
  620. Xtherefore`20required`20privileges.`20The`20corresponding`20debug`20messages
  621. V`20have`20been
  622. Xremoved`20and`20the`20facility`20is`20available`20to`20all`20users`20through
  623. V`20/LOG.
  624. X
  625. XAdditional`20log`20messages`20and`20levels`20of`20logging`20may`20be`20added
  626. V`20in`20future`20releases.
  627. X
  628. X
  629. X
  630. X2.5`20Strip`20Directory`20and`20Version`20Numbers
  631. X
  632. XRecent`20previous`20releases`20have`20preserved`20the`20subdirectory`20structu
  633. Vre`20of`20the
  634. Xpackaged`20files`20and`20the`20version`20numbers.`20Some`20older`20releases
  635. V`20did`20not.`20Some`20users
  636. Xhave`20requested`20an`20option`20that`20allows`20the`20older`20behaviour`20to
  637. V`20be`20reinstated.
  638. X
  639. XAs`20a`20result,`20two`20new`20qualifiers`20have`20been`20added`20that`20allow
  640. V`20the`20user`20to`20select
  641. Xwhether`20directories`20and/or`20version`20numbers`20are`20retained`20in`20the
  642. V`20sharefile.
  643. X
  644. XThe`20new`20qualifier`20/`5BNO`5DDIRECTORY`20selects`20the`20`5Bno`5D`20direct
  645. Vory`20structure
  646. Xpreservation`20option.`20If`20preserved,`20then`20the`20directory`20structure
  647. V`20will`20be
  648. Xrecreated`20when`20the`20share`20file`20is`20unpacked.`20If`20not`20preserved,
  649. V`20then`20all`20files
  650. Xwill`20be`20created`20in`20the`20directory`20current`20at`20the`20time`20of
  651. V`20unpacking.`20The`20logical
  652. Xname`20SHARE_DIRECTORY`20may`20be`20defined`20to`20specify`20the`20default,
  653. V`20with`20/DIRECTORY
  654. Xbeing`20the`20default`20otherwise.
  655. X
  656. XThe`20new`20qualifier`20/`5BNO`5DVERSION`20selects`20the`20`5Bno`5D`20version
  657. V`20number`20preservation
  658. Xoption.`20If`20preserved,`20then`20the`20version`20numbers`20are`20retained
  659. V`20when`20the`20share`20file
  660. Xis`20unpacked`20and`20a`20file`20with`20the`20same`20version`20number`20will
  661. V`20cause`20the`20unpacking`20of
  662. Xthat`20particular`20file`20to`20be`20skipped.`20If`20not`20preserved,`20then
  663. V`20a`20new`20version`20of`20the
  664. Xfile`20will`20be`20created`20regardless,`20with`20a`20warning`20message`20if
  665. V`20a`20lower`20numbered
  666. Xversion`20already`20exists.`20The`20logical`20name`20SHARE_VERSION`20may`20be
  667. V`20defined`20to
  668. Xspecify`20the`20default,`20with`20/VERSION`20being`20the`20default`20otherwise
  669. V.
  670. X
  671. X`5BThanks`20to`20Wolfgang`20Moeller`20-`20Moeller@gwdgv1.dnet.gwdg.de`20-`20fo
  672. Vr`20this`20suggestion`5D
  673. X
  674. X
  675. X
  676. X2.6`20DEBUG`20Now`20Shows`20Rejected`20Files
  677. X
  678. XIf`20a`20file`20which`20matches`20the`20user`20specified`20input`20files`20is
  679. V`20not`20selected`20because
  680. Xof`20the`20value`20of`20the`20/EXCLUDE,`20/AFTER`20or`20/BEFORE`20qualifiers,
  681. V`20selecting`20the
  682. X/DEBUG`20qualifier`20will`20show`20which`20of`20these`20qualifiers`20caused
  683. V`20it`20to`20be`20rejected.
  684. X
  685. XLevel`202`20debug`20is`20required`20for`20this.
  686. X
  687. X
  688. X
  689. X2.7`20New`20PAKMAIL`20Utility
  690. X
  691. XThe`20PAKMAIL`20utility`20has`20been`20extensively`20revised.`20In`20particula
  692. Vr,`20it`20now
  693. Xrecognizes`20an`20optional`20list`20of`20parts`20as`20a`20paramter.`20This`20a
  694. Vllows`20a`20user`20to`20send
  695. Xa`20subset`20of`20the`20full`20package`20should,`20for`20example,`20a`20number
  696. V`20of`20users`20fail`20to
  697. Xreceive`20some`20of`20the`20parts.`20`20The`20User`20guide`20and`20on-line`20h
  698. Velp`20give`20further
  699. Xdetails`20of`20this.
  700. X
  701. X`5BThanks`20to`20Richard`20Levitte`20-`20Levitte@ttt.kth.se`20-`20for`20this
  702. V`20suggestion`5D
  703. X
  704. X
  705. X
  706. X3.`20BUG`20FIXES
  707. X
  708. X
  709. X3.1`20Debug`20Messages
  710. X
  711. XIn`20some`20early`20releases`20of`20version`208.1,`20some`20of`20the`20debug
  712. V`20messages`20were`20always
  713. Xactive.`20This`20was`20due`20to`20a`20faulty`20definition`20of`20their`20debug
  714. V`20level`20(as`200`20rather
  715. Xthan`201)`20internally.`20The`20debug`20level`20associated`20with`20these`20me
  716. Vssages`20has`20been
  717. Xcorrected.
  718. X
  719. X
  720. X
  721. X3.2`20PAKMAIL
  722. X
  723. XThe`20PAKMAIL`20utility,`20used`20to`20mail`20out`20parts`20of`20a`20package,
  724. V`20was`20modified`20in
  725. Xversion`208.1`20to`20reflect`20the`20new`20part`20format`20of`20nnn-OF-mmm.
  726. V`20A`20bug`20in`20the`20code
  727. Xprevented`20this`20working`20correctly`20when`20the`20number`20of`20parts`20ex
  728. Vceeded`209.`20This`20has
  729. Xnow`20been`20corrected`20and`20works`20for`20any`20number`20of`20parts.
  730. X
  731. X
  732. X
  733. X3.3`20Check`20for`20Same`20Subdirectory
  734. X
  735. XThe`20check`20on`20whether`20a`20file`20was`20in`20the`20same`20subdirectory
  736. V`20was`20faulty,`20leading`20to
  737. Xa`20DCL`20error`20message`20about`20undefined`20symbols`20rather`20than`20the
  738. V`20correct`20message.
  739. XThis`20has`20been`20corrected.
  740. X
  741. X`5BThanks`20to`20Wolfgang`20Moeller`20-`20Moeller@gwdgr1.dnet.gwdg.de`20-`20fo
  742. Vr`20this`20bugfix`5D
  743. X
  744. X
  745. X
  746. X3.4`20File`20scanning
  747. X
  748. XIn`20some`20early`20version`20of`20VMS`20(around`205.3`20and`20earlier),`20the
  749. Vre`20was`20a`20dcl`20bug`20that
  750. Xprevented`20nested`20loops`20containing`20gosubs`20from`20working`20correctly.
  751. V`20After`20several
  752. Xiterations,`20DCL`20would`20fail`20to`20find`20labels`20that`20were`20definite
  753. Vly`20present.`20`20This
  754. Xsituation`20could`20arise`20in`20that`20part`20of`20the`20code`20which`20scans
  755. V`20the`20user's`20file
  756. Xspecifications`20and`20locates`20matching`20files.`20To`20avoid`20the`20proble
  757. Vm,`20the`20code`20has
  758. Xbeen`20split`20into`20two`20sections,`20circumventing`20the`20bug.
  759. X
  760. XNote`20that`20the`20bug`20appears`20to`20no`20longer`20exist`20on`20VMS`205.5.
  761. V
  762. X
  763. X`5BThanks`20to`20Foetes`20Macrides`20-`20MACRIDES@WFEB2.BITNET`20-`20for`20thi
  764. Vs`20bugfix`5D
  765. X
  766. X
  767. X3.5`20Check`20for`20same`20device
  768. X
  769. XThe`20check`20on`20the`20filename`20to`20make`20sure`20it`20exists`20on`20the
  770. V`20current`20device`20was
  771. Xinside`20rather`20than`20outside`20a`20loop.`20This`20resulted`20in`20one`20me
  772. Vssage`20for`20each`20file
  773. Xthat`20matched`20a`20wildcarded`20file`20spec`20on`20the`20device.`20The`20che
  774. Vck`20has`20been`20moved
  775. Xoutside`20the`20loop`20and`20is`20now`20issued`20once`20when`20the`20wildcarde
  776. Vd`20pattern`20is`20first
  777. Xused;`20the`20pattern`20is`20not`20used`20if`20the`20device`20is`20invalid.
  778. X
  779. XNote`20that`20this`20check`20is`20suppressed`20if`20the`20/NODIRECTORY`20optio
  780. Vn`20is`20requested.
  781. X
  782. X
  783. X3.6`20Check`20for`20invalid`20file`20specifications
  784. X
  785. XThe`20input`20file`20specification`20supplied`20by`20the`20user`20is`20now`20c
  786. Vhecked`20for`20valid
  787. Xsyntax.`20Any`20invalid`20file`20specifications`20cause`20an`20abort.
  788. X
  789. X
  790. X
  791. X3.7`20Check`20for`20missing`20parameters`20in`20non-interactive`20mode
  792. X
  793. XIf`20any`20of`20the`20required`20parameters`20are`20not`20supplied`20on`20the
  794. V`20command`20line,`20the
  795. Xuser`20is`20prompted`20for`20them.`20However,`20if`20the`20mode`20of`20the`20p
  796. Vrocess`20is`20not
  797. XINTERACTIVE,`20the`20user`20cannot`20be`20prompted;`20therefore`20an`20error
  798. V`20message`20is`20issued
  799. Xin`20such`20modes.
  800. X
  801. X
  802. X3.8`20Problems`20with`20checksumming
  803. X
  804. XDue`20to`20the`20problems`20described`20in`20section`206.1`20of`20these`20rele
  805. Vase`20notes,`20the
  806. Xchecksum`20mechanism`20cannot`20always`20be`20used.`20Under`20such`20circumsta
  807. Vnces`20the`20file
  808. Xcannot`20be`20packaged`20either.`20Previous`20releases`20inserted`20a`20check
  809. V`20into`20the`20created
  810. Xshare`20file`20on`20the`20assumption`20that`20the`20checksum`20might`20fail
  811. V`20but`20the`20packaging
  812. Xwould`20not.`20However,`20this`20cannot`20happen`20so`20the`20appropriate`20co
  813. Vde`20segment`20has`20been
  814. Xremoved`20from`20the`20created`20share`20file.
  815. X
  816. XShould`20a`20file`20not`20be`20able`20to`20be`20checksummed`20at`20the`20packa
  817. Vging`20stage,`20an
  818. Xappropriate`20message`20is`20issued`20and`20the`20file`20is`20ignored.
  819. X
  820. X
  821. X
  822. X3.9`20Check`20on`20Output`20Directory/FileName
  823. X
  824. XIf`20the`20output`20directory`20was`20non-existent,`20or`20there`20was`20a`20s
  825. Vyntax`20error`20in`20the
  826. Xoutput`20file`20specification,`20the`20share`20file`20parts`20were`20created
  827. V`20in`20the`20current
  828. Xdirectory`20with`20strange`20names.`20`20A`20check`20has`20now`20been`20includ
  829. Ved`20to`20validate`20the
  830. Xoutput`20file.
  831. X
  832. X
  833. X
  834. X3.10`20Checks`20on`20Qualifier`20Formats
  835. X
  836. XMore`20checks`20have`20been`20added`20to`20the`20qualifier`20parsing`20code
  837. V`20to`20ensure`20that
  838. Xqualifiers`20that`20need`20values`20have`20them,`20and`20that`20those`20which
  839. V`20don't`20require`20them
  840. Xdo`20not`20have`20them`20specified.
  841. X
  842. X
  843. X
  844. X3.11`20Input`20File`20Patterns
  845. X
  846. XA`20warning`20message`20is`20now`20issued`20if`20any`20of`20the`20input`20file
  847. V`20specifications`20do`20not
  848. Xmatch`20at`20least`20one`20file.`20The`20message`20is`20given`20for`20each`20p
  849. Vattern`20that`20fails`20to
  850. Xmatch.
  851. X
  852. X
  853. X
  854. X3.12`20Parameter`20File`20Creation
  855. X
  856. XAdditional`20checks`20are`20now`20made`20on`20the`20creation`20of`20the`20para
  857. Vmeter`20file,`20to`20ensure
  858. Xthat`20all`20parameters`20have`20been`20correctly`20written.
  859. X
  860. X
  861. X3.13`20Null`20file`20types
  862. X
  863. XNull`20file`20types`20were`20processed`20badly`20in`20some`20places;`20all`20k
  864. Vnown`20instances`20of
  865. Xthis`20have`20been`20corrected`20and`20should`20now`20work`20properly`20as`20w
  866. Vith`20any`20other`20file
  867. Xtype.
  868. X
  869. X`5BThanks`20to`20Richard`20Levitte`20-`20Levitte@ttt.kth.se`20-`20for`20this
  870. V`20bugfix`5D
  871. X
  872. X
  873. X
  874. X4.`20CHANGES`20IN`20OPERATION
  875. X
  876. XThe`20compression`20routines`20have`20all`20been`20completely`20re-written.
  877. V`20The`20only`20new`20code
  878. Xis`20that`20dealing`20with`20the`20LZ`20encoding.
  879. X
  880. X
  881. X
  882. X
  883. X5.`20DOCUMENTATION`20CHANGES
  884. X
  885. XThe`20user`20guide`20has`20been`20completely`20re-written.`20Details`20on`20th
  886. Ve`20new`20features`20have
  887. Xbeen`20added`20and`20descriptions`20of`20all`20the`20qualifiers`20have`20been
  888. V`20moved`20to`20a`20separate
  889. Xqualifier`20reference`20section.
  890. X
  891. XThe`20HELP`20file`20has`20been`20updated`20with`20details`20of`20the`20new`20q
  892. Vualifiers`20(/EXCLUDE,
  893. X/DIRECTORY`20and`20/VERSION)`20and`20the`20new`20logical`20names`20correspondi
  894. Vng`20to`20them.
  895. XMost`20of`20the`20logical`20name`20descriptions`20have`20been`20rewritten`20so
  896. V`20that`20the`20reader`20is
  897. Xreferred`20to`20the`20corresponding`20qualifier`20rather`20than`20duplicating
  898. V`20information.
  899. X
  900. X
  901. X
  902. X6.`20MISCELLANEOUS`20NOTES
  903. X
  904. X6.1`20Record`20Length`20Problems
  905. X
  906. XThe`20release`20notes`20for`20version`208.1`20outlined`20some`20problems`20wit
  907. Vh`20long`20records,
  908. Xwhereby`20TPU`20and`20the`20CHECKSUM`20utility`20were`20failing`20to`20read
  909. V`20certain`20files`20with
  910. Xlongish`20lines`20in`20them.`20`20The`20reason`20for`20this`20is`20now`20clear
  911. V,`20although`20a`20solution
  912. Xhas`20not`20yet`20presented`20itself.
  913. X
  914. XEssentially,`20each`20file`20header`20contains`20TWO`20fields`20describing`20t
  915. Vhe`20size`20of`20each
  916. Xrecord;`20the`20first`20is`20the`20maximum`20record`20size,`20which`20contains
  917. V`20the`20longest`20line
  918. Xthat`20may`20appear`20in`20the`20file`20-`20a`20zero`20value`20here`20signifie
  919. Vs`20no`20upper`20limit`20on`20the
  920. Xlength`20-`20and`20is`20used`20by`20many`20system`20utilities,`20TPU`20include
  921. Vd,`20to`20determine`20the
  922. Xsize`20of`20the`20record`20buffer;`20the`20second`20is`20the`20length`20of`20t
  923. Vhe`20longest`20record`20that
  924. Xis`20currently`20written`20to`20the`20file.
  925. X
  926. XThe`20problem`20arise`20when`20each`20of`20these`20conditions`20is`20true:
  927. X
  928. X(a)`20The`20MRS`20value`20is`20zero,`20which`20causes`20TPU`20and`20CHECKSUM
  929. V`20to`20allocate`20default
  930. X`20`20`20`20record`20buffer`20sizes`20of`20about`202048`20bytes.
  931. X
  932. X(b)`20The`20longest`20record`20in`20the`20file`20exceeds`20the`20default`20rec
  933. Vord`20buffer`20length.
  934. X
  935. XUnfortunately,`20DCL's`20lexical`20function`20f$file_attributes`20only`20allow
  936. Vs`20a`20procedure
  937. Xto`20see`20the`20MRS`20value`20and`20NOT`20the`20longest`20record`20value.`20I
  938. Vt`20is`20therefore
  939. Ximpossible`20to`20predict`20in`20advance`20which`20files`20are`20going`20to
  940. V`20cause`20problems`20during
  941. Xpackaging.
  942. X
  943. XThe`20CHECKSUM`20utility`20suffers`20from`20a`20similar`20problem`20and`20cons
  944. Vequently`20will`20not
  945. Xchecksum`20files`20with`20an`20MRS`20value`20of`200`20and`20a`20longest`20reco
  946. Vrd`20greater`20than`202048
  947. Xbytes.
  948. X
  949. XIt`20is`20hoped`20that`20future`20developments`20in`20VMS`20may`20allow`20this
  950. V`20problem`20to`20be
  951. Xcircumvented.`20In`20the`20short`20term,`20the`20simplest`20workaround`20is
  952. V`20to`20use`20the`20CONVERT
  953. Xutility`20to`20create`20a`20new`20version`20of`20the`20file`20with`20the`20MRS
  954. V`20value`20set`20to`20the`20size
  955. Xof`20the`20longest`20record.`20The`20longest`20record`20can`20be`20determined
  956. V`20by`20using
  957. X
  958. X`20`20`20DUMP/HEADER/BLOCK=C:0`20file
  959. X
  960. Xand`20looking`20for`20the`20RMS`20attributes`20section.`20Once`20the`20size
  961. V`20of`20the`20longest`20record
  962. Xis`20obtained,`20call`20it`20`60nnn',`20use`20the`20CONVERT`20utility`20as`20f
  963. Vollows:
  964. X
  965. X`20`20`20CONVERT/FDL=SYS$INPUT`20file`20file
  966. X`20`20`20RECORD
  967. X`20`20`20`20SIZE`20nnn
  968. X`20`20`20`5EZ
  969. X
  970. XThis`20new`20copy`20of`20the`20file`20will`20then`20be`20correctly`20processed
  971. V`20by`20VMS_SHARE
  972. X
  973. X
  974. X
  975. X7.`20TESTING
  976. X
  977. XThis`20version`20of`20VMS_SHARE`20has`20only`20been`20tested`20on`20VMS`205.5-
  978. V1`20but`20is`20believed`20to
  979. Xwork`20on`20all`20versions`20from`20VMS`205.0`20to`20VMS`205.5-1.`20`20However
  980. V,`20it`20is`20not`20supported`20
  981. Xformally`20on`20any`20version`20of`20VMS`20other`20than`20the`20one`20on`20whi
  982. Vch`20it`20has`20been`20tested.
  983. X
  984. XThe`20share`20files`20generated`20by`20VMS_SHARE`20are`20believed`20to`20unpac
  985. Vk`20correctly`20on`20all
  986. Xversions`20of`20TPU`20from`20VMS`204.4`20onwards`20unless`20the`20/LONGLINES
  987. V`20option`20is`20selected,
  988. Xin`20which`20case`20VMS`205.4`20is`20the`20minimum`20release`20needed.
  989. X
  990. X
  991. X
  992. X8.`20PREVIOUS`20RELEASE`20NOTES
  993. X
  994. XRelease`20notes`20for`20previous`20versions`20are`20appended`20at`20the`20end.
  995. V`20These`20give`20
  996. Xdetails`20of`20changes`20and`20bug`20fixes`20for`20those`20versions.
  997. X`0C
  998. X`20`20`20`20`20`20`20`20`09`09`09V`20M`20S`20_`20S`20H`20A`20R`20E
  999. X
  1000. X`20`20`20`20`09`09`09`20`20`20R`20E`20L`20E`20A`20S`20E`20`20`20N`20`20O`20T
  1001. V`20E`20S
  1002. X
  1003. X
  1004. X`20`20`20`20`09`09`09`09`09`09`09`09Version`208.1
  1005. X`20`20`20`20`09`09`09`09`09`09`09`09Sep`201992
  1006. X
  1007. X
  1008. X1.`20INTRODUCTION
  1009. X
  1010. XVersion`208.1`20of`20VMS_SHARE`20is`20a`20major`20release`20which`20fixes`20a
  1011. V`20number`20of`20bugs`20and
  1012. Xmakes`20a`20number`20of`20new`20features`20available.
  1013. X
  1014. X
  1015. X
  1016. X2.`20NEW`20FEATURES
  1017. X
  1018. X2.1`20Date`20Based`20File`20Selection
  1019. X
  1020. XThe`20selection`20of`20files`20for`20packaging`20can`20now`20be`20modified`20o
  1021. Vn`20the`20basis`20of`20the
  1022. Xaccess`20dates`20associated`20with`20each`20file.`20The`20usual`20VMS`20qualif
  1023. Viers`20for`20this`20are
  1024. Xsupported:
  1025. X
  1026. X`20`20/SINCE`5B=date`5D`09`09Select`20files`20accessed`20since`20a`20specific
  1027. V`20date
  1028. X`20`20/BEFORE`5B=date`5D`09Select`20files`20accessed`20before`20a`20specific
  1029. V`20date
  1030. X`20`20/BACKUP`09`09Use`20the`20last`20backup`20date`20as`20the`20basis`20of
  1031. V`20date`20selection
  1032. X`20`20/CREATED`09`09Use`20the`20create`20date`20as`20the`20basis`20of`20date
  1033. V`20selection
  1034. X`20`20/EXPIRED`09`09Use`20the`20expiration`20date`20as`20the`20basis`20of`20da
  1035. Vte`20selection
  1036. X`20`20/MODIFIED`09`09Use`20the`20last`20modified`20date`20as`20the`20basis`20o
  1037. Vf`20date`20selection
  1038. X
  1039. XAll`20sensible`20combinations`20of`20these`20are`20recognized.`20/SINCE`20and
  1040. V`20/BEFORE`20together
  1041. Xspecify`20a`20range`20of`20dates;`20use`20of`20/BACKUP,`20/CREATED,`20/EXPIRED
  1042. V`20and`20/MODIFIED
  1043. Xtogether`20is`20allowed,`20but`20only`20the`20last`20one`20specified`20has`20a
  1044. Vny`20effect`20(the
  1045. Xdefault`20is`20/MODIFIED`20if`20none`20are`20given).
  1046. X
  1047. XFor`20example:
  1048. X
  1049. X`20`20$`20VMS_SHARE`20*.*`20PACKAGE`20/CREATED`20/SINCE=1-JAN-1992`20/BEFORE=T
  1050. VODAY
  1051. X`09Selects`20all`20files`20created`20this`20year
  1052. X
  1053. X
  1054. XThere`20is`20one`20deviation`20from`20the`20usual`20behaviour`20of`20these`20q
  1055. Vualifiers.`20If`20any
  1056. Xpart`20of`20the`20time`20field`20is`20omitted`20it`20takes`20on`20the`20CURREN
  1057. VT`20time`20values`20rather
  1058. Xthan`20the`20values`20at`20midnight,`20so`20that:
  1059. X
  1060. X`20`20`20`20`20`20`20`20`20/SINCE=TODAY`20`20and`20/SINCE=1-AUG-1992`20`20`20
  1061. V`20`20`20`20`20`20`20`20`20`20`20`20are`20NOT`20equivalent
  1062. Xbut`20`20`20`20`20`20/SINCE=TODAY`20`20and`20/SINCE=1-AUG-1992:00:00:00.00`20
  1063. V`20`20are`20equivalent.
  1064. X
  1065. XNote`20also`20the`20use`20of`20a`20:`20to`20separate`20the`20date`20and`20time
  1066. V`20fields.`20Spaces`20are`20not
  1067. Xallowed`20and`20quoted`20times`20are`20not`20recognized`20correctly.
  1068. X
  1069. XA`20missing`20date/time`20spec`20(I.E.`20just`20/SINCE`20or`20just`20/BEFORE)
  1070. V`20defaults,`20as`20usual,
  1071. Xto`20"TODAY".
  1072. X
  1073. X
  1074. X
  1075. X2.2`20Confirmation`20of`20Selected`20Files
  1076. X
  1077. XUsers`20can`20now`20elect`20to`20confirm`20each`20file`20selected`20via`20the
  1078. V`20new`20/CONFIRM
  1079. Xqualifier.`20This`20works`20similarly`20to`20/CONFIRM`20on`20the`20DELETE,`20P
  1080. VURGE,`20COPY`20commands
  1081. Xetc.`20A`20Y`20response`20selects`20the`20file,`20a`20N`20response`20does`20no
  1082. Vt.`20The`20default`20response
  1083. Xis`20N.
  1084. X
  1085. XUse`20of`20this`20option`20in`20any`20non-interactive`20mode`20results`20in
  1086. V`20a`20warning`20and
  1087. X/CONFIRM`20is`20ignored.
  1088. X
  1089. XBy`20default,`20confirmation`20is`20turned`20off.`20A`20new`20logical`20name
  1090. V`20SHARE_CONFIRM`20may`20be
  1091. Xdefined`20with`20a`20true`20or`20false`20value`20to`20override`20the`20default
  1092. V.`20The`20/`5BNO`5DCONFIRM
  1093. Xqualifier`20on`20the`20command`20line`20overrides`20the`20setting`20of`20the
  1094. V`20logical`20name.
  1095. X
  1096. X
  1097. X
  1098. X2.3`20Debugging
  1099. X
  1100. XThe`20debugging`20facility`20at`20level`201`20now`20includes`20additional`20me
  1101. Vssages`20detailing
  1102. Xthe`20size`20of`20a`20file`20buffer`20before`20and`20after`20encoding.`20This
  1103. V`20provides`20two`20useful
  1104. Xfunctions.`20First,`20it`20allows`20a`20comparison`20of`20the`20normal`20encod
  1105. Ving`20algorithm`20with
  1106. Xthe`20run-length`20encoding`20compression`20algorithm;`20second,`20it`20gives
  1107. V`20a`20useful
  1108. Xprogress`20monitoring`20function`20when`20packaging`20a`20large`20collection
  1109. V`20of`20files.
  1110. X
  1111. XThe`20messages`20produced`20are`20similar`20to`20these:
  1112. X
  1113. X`20`20`20`20`20`20`20Begin`20buffer`20encoding,`20n`20lines,`20b`20bytes
  1114. X
  1115. Xand`20`20`20`20End`20`20`20buffer`20encoding,`20n`20lines,`20b`20bytes,`20chan
  1116. Vge`20=`20x%
  1117. X
  1118. XThe`20change`20field`20is`20given`20as`20a`20percentage`20increase`20or`20decr
  1119. Vease`20in`20the`20size`20of
  1120. Xthe`20buffer.`20Usually,`20it`20will`20increase`20because`20of`20the`20encodin
  1121. Vg`20applied`20to
  1122. Xnon-printable`20characters.`20Use`20of`20run-length`20compression`20would`20no
  1123. Vrmally`20show`20a
  1124. Xsmaller`20increase.
  1125. X
  1126. XDebugging`20now`20requires`20EITHER`20SYSPRV`20OR`20SETPRV`20to`20be`20in`20th
  1127. Ve`20user's`20AUTHORIZED
  1128. Xprivileges.`20Previously`20only`20SYSPRV`20was`20recognized`20and`20had`20to
  1129. V`20be`20in`20the`20user's
  1130. XCURRENT`20privileges.`20This`20means`20that`20users`20can`20now`20select`20deb
  1131. Vugging`20without
  1132. Xneeding`20to`20specifically`20turn`20on`20privileges.
  1133. X
  1134. X
  1135. X2.4`20New`20SHARE_UNPACK_TEMP`20Logical
  1136. X
  1137. XThe`20new`20logical`20name`20SHARE_UNPACK_TEMP`20can`20be`20used`20to`20overri
  1138. Vde`20the`20default
  1139. Xchoice`20of`20temporary`20filename`20used`20when`20unpacking`20a`20share`20fil
  1140. Ve.`20`20Previously,`20the
  1141. Xunpacking`20code`20used`20the`20same`20name`20"SHARE_TEMP"`20as`20that`20used
  1142. V`20by`20VMS_SHARE`20itself
  1143. Xwhen`20encoding.`20`20If`20not`20specified,`20the`20default`20name`20is:
  1144. XSYS$SCRATCH:SHARE_UNPACK_TEMP.pid
  1145. X
  1146. X
  1147. X
  1148. X2.5`20Small`20Part`20Sizes
  1149. X
  1150. XUnder`20certain`20conditions`20(with`20small`20part`20sizes),`20it`20was`20pos
  1151. Vsible`20for`20the
  1152. Xprocedure`20to`20generate`20a`20buffer`20that`20was`20not`20allowed`20to`20be
  1153. V`20split`20but`20was`20too`20big
  1154. Xfor`20the`20part`20buffer.`20`20A`20suitable`20error`20message`20was`20issued
  1155. V`20and`20the`20procedure
  1156. Xaborted.
  1157. X
  1158. XThe`20message`20produced`20now`20includes`20additional`20information`20stating
  1159. V`20the`20minimum
  1160. Xpart`20size`20required`20to`20encode`20the`20particular`20non-splittable`20buf
  1161. Vfer.
  1162. X
  1163. X
  1164. X3.`20BUG`20FIXES
  1165. X
  1166. XA`20number`20of`20minor`20bugs`20have`20been`20fixed.
  1167. X
  1168. X
  1169. X3.1`20Checksums`20on`20Files`20with`20Long`20Records
  1170. X
  1171. XThe`20long`20lines`20support`20introduced`20in`20version`208.0`20showed`20up
  1172. V`20a`20problem`20with`20the
  1173. Xundocumented`20DCL`20command`20-`20CHECKSUM.`20`20It`20appears`20that`20this
  1174. V`20will`20not`20handle
  1175. Xfiles`20with`20long`20records`20(the`20exact`20length`20seems`20unclear`20but
  1176. V`20it`20appears`20to`20be
  1177. Xabout`202048`20bytes).`20`20This`20means`20that`20VMS_SHARE`20is`20unable`20to
  1178. V`20provide`20checksum
  1179. Xverification`20for`20such`20files`20at`20present.
  1180. X
  1181. XPreviously,`20the`20code`20would`20provide`20an`20obscure`20error`20message
  1182. V`20at`20the`20point`20where
  1183. Xthe`20checksum`20was`20calculated,`20fail`20to`20produce`20a`20new`20checksum,
  1184. V`20and`20use`20a
  1185. Xpreviously`20calculated`20checksum`20as`20the`20value`20passed`20in`20the`20sh
  1186. Vare`20file;`20this`20had
  1187. Xthe`20effect`20of`20giving`20errors`20on`20a`20subsequent`20unpacking`20operat
  1188. Vion.
  1189. X
  1190. XNow,`20the`20code`20attempts`20to`20detect`20when`20the`20checksum`20cannot
  1191. V`20be`20determined`20and
  1192. Xgives`20messages`20at`20both`20the`20packing`20and`20unpacking`20stages,`20war
  1193. Vning`20that
  1194. Xverification`20of`20the`20file`20cannot`20be`20made.
  1195. X
  1196. X
  1197. X
  1198. X3.2`20`20Creation`20of`20the`20Package`20Index`20File
  1199. X
  1200. XDue`20to`20a`20coding`20error,`20the`20package`20index`20file`20was`20always
  1201. V`20being`20created.`20This
  1202. Xhas`20been`20fixed`20and`20the`20file`20is`20now`20created`20only`20when`20req
  1203. Vuested`20by`20the
  1204. X/PACKAGE_INDEX`20qualifier`20or`20the`20SHARE_PACKAGE_INDEX`20logical`20name.
  1205. X
  1206. X
  1207. X
  1208. X3.3`20Deletion`20of`20Temporary`20Files`20Following`20Unpacking
  1209. X
  1210. XDue`20to`20a`20coding`20error`20within`20the`20generated`20share`20file,`20the
  1211. V`20temporary`20files`20so
  1212. Xcreated`20were`20not`20being`20correctly`20deleted`20if`20the`20checksum`20val
  1213. Vidation`20check`20was
  1214. Xsuccessfully`20passed.`20They`20were`20deleted`20on`20a`20checksum`20failure.
  1215. V`20`20This`20problem`20has
  1216. Xnow`20been`20fixed`20by`20ensuring`20that`20the`20deletion`20of`20scratch`20fi
  1217. Vles`20code`20takes`20place
  1218. Xirrespective`20of`20any`20checksum`20status.
  1219. X
  1220. X
  1221. X
  1222. X3.4`20Erroneous`20Note`20in`20Release-Notes`20for`20Version`208.0
  1223. X
  1224. XSection`203.5`20of`20the`20previous`20release`20notes`20(Long`20DCL`20Lines)
  1225. V`20erroneously`20refers
  1226. Xto`20a`20problem`20about`20splitting`20parts`20across`20DCL`20continuation`20l
  1227. Vines.`20In`20fact,`20this
  1228. Xproblem`20did`20not`20exist`20in`20the`20released`20version`20and`20refers`20o
  1229. Vnly`20to`20a`20problem`20that
  1230. Xexisted`20during`20the`20development`20stage.`20Please`20ignore`20this`20probl
  1231. Vem`20description.
  1232. X
  1233. XA`20number`20of`20other`20minor`20corrections`20were`20made`20to`20these`20rel
  1234. Vease`20notes,`20and`20the
  1235. Xcorrected`20version`20may`20be`20found`20at`20the`20end`20of`20these`20release
  1236. V`20notes.
  1237. X
  1238. X
  1239. X
  1240. X3.5`20MFD`20Check
  1241. X
  1242. XIn`20the`20DCL`20routine`20`60Check_out_File',`20a`20check`20is`20made`20to
  1243. V`20see`20if`20the`20current
  1244. Xdirectory`20is`20the`20MFD`20`5B000000`5D.`20This`20check`20was`20incorrectly
  1245. V`20coded`20and`20could
  1246. Xaffect`20operation`20if`20the`20current`20directory`20was`20indeed`20`5B000000
  1247. V`5D.`20This`20check`20has
  1248. Xnow`20been`20corrected`20and`20should`20now`20correctly`20generate`20the`20sub
  1249. Vdirectory`20paths.
  1250. X
  1251. X
  1252. X
  1253. X3.6`20Non`20Negatable`20Qualifiers
  1254. X
  1255. XError`20messages`20are`20now`20issued`20for`20qualifiers`20that`20may`20not
  1256. V`20be`20negated.`20For
  1257. Xexample:`20`20/NOPART_SIZE.
  1258. X
  1259. X
  1260. X3.7`20Failures`20to`20Create`20Temporary`20Files
  1261. X
  1262. XMore`20error`20checks`20have`20been`20introduced`20during`20the`20creation`20a
  1263. Vnd`20writing`20of
  1264. Xvarious`20intermediate`20files.
  1265. X
  1266. X
  1267. X
  1268. X4.`20CHANGES`20IN`20OPERATION
  1269. X
  1270. XThe`20following`20changes`20in`20operation`20have`20occurred.
  1271. X
  1272. X
  1273. X4.1`20Debug`20Facility
  1274. X
  1275. XThe`20/DEBUG`20facility`20has`20been`20modified.
  1276. X
  1277. XThe`20maximum`20debug`20level`20is`20now`204`20rather`20than`203.`20Most`20deb
  1278. Vug`20messages`20have`20been
  1279. Xincreased`20to`20a`20higher`20level`20and`20new`20ones`20inserted`20at`20level
  1280. V`201`20to`20show`20the`20BEFORE
  1281. Xand`20AFTER`20state`20of`20the`20file`20buffer`20(see`20paragraph`20above`20un
  1282. Vder`20new`20features).
  1283. XThe`20use`20of`20/DEBUG=1`20now`20provides`20a`20simple`20progress`20check`20o
  1284. Vn`20the`20state`20of`20the
  1285. Xpacking,`20listing`20each`20file`20as`20it`20is`20read`20in,`20each`20file`20b
  1286. Vuffer`20before`20and`20after
  1287. Xencoding,`20and`20each`20part`20as`20it`20is`20written`20out.
  1288. X
  1289. X
  1290. X4.2`20ShareFile`20Unpack`20Code
  1291. X
  1292. XThe`20TPU`20code`20created`20in`20the`20share`20file`20to`20unpack`20each`20fi
  1293. Vle`20has`20been`20modified`20to
  1294. Xbe`20more`20modular.`20Some`20coding`20reductions`20have`20been`20introduced
  1295. V`20to`20slightly
  1296. Xincrease`20the`20unpacking`20speed.
  1297. X
  1298. X
  1299. X
  1300. X5.`20DOCUMENTATION`20CHANGES
  1301. X
  1302. XDocumentation`20has`20been`20updated`20to`20reflect`20the`20new`20date`20based
  1303. V`20selection,`20the
  1304. Xconfirmation`20qualifier,`20the`20new`20debug`20levels,`20the`20new`20SHARE_UN
  1305. VPACK_TEMP`20logical
  1306. Xand`20the`20checksum`20limitation.
  1307. X
  1308. X
  1309. X
  1310. X6.`20MISCELLANEOUS`20NOTES
  1311. X
  1312. X6.1`20`20Long`20line`20support
  1313. X
  1314. XWith`20the`20addition`20of`20long`20line`20support,`20a`20check`20is`20include
  1315. Vd`20on`20the`20maximum
  1316. Xrecord`20size`20of`20a`20file`20before`20it`20is`20selected`20for`20packaging.
  1317. V`20The`20maximum`20record
  1318. Xsize`20is`20obtained`20using`20the`20DCL`20lexical`20function`20f$file_attribu
  1319. Vtes`20with`20the
  1320. X"MRS"`20item`20code.`20`20Under`20certain`20conditions,`20as`20yet`20unknown,
  1321. V`20this`20DCL`20lexical
  1322. Xreturns`20a`20wildly`20inaccurate`20value.`20The`20only`20common`20factor`20so
  1323. V`20far`20seems`20to`20be
  1324. Xthat`20the`20files`20are`20the`20output`20from`20the`20DOCUMENT`20utility;`20i
  1325. Vt`20has`20been`20seen`20only
  1326. Xon`20the`20.TXT`20and`20.PS`20files`20output`20by`20this.`20DIR/FULL`20on`20th
  1327. Ve`20file`20shows`20the
  1328. XCORRECT`20record`20length.
  1329. X
  1330. XCurrently,`20there`20is`20nothing`20that`20VMS_SHARE`20can`20do`20about`20this
  1331. V.`20The`20effect`20is
  1332. Xeither`20to`20reject`20files`20erroneously`20because`20the`20record`20length
  1333. V`20is`20seen`20as`20much
  1334. Xtoo`20large,`20or`20to`20accept`20files`20erroneously`20because`20the`20record
  1335. V`20length`20is`20seen`20as
  1336. Xaceptable.`20Use`20of`20the`20long`20lines`20support`20option`20will`20accept
  1337. V`20both`20files`20and
  1338. Xcorrectly`20package`20them.
  1339. X
  1340. XWithout`20long`20lines`20support,`20the`20only`20known`20workaround`20is`20to
  1341. V`20use`20the`20editor`20to
  1342. Xmake`20a`20null`20correction`20to`20the`20file`20and`20force`20a`20new`20versi
  1343. Von`20to`20be`20created`20(EVE
  1344. Xworks`20fine`20for`20this)`20thus`20rewriting`20the`20record`20length`20based
  1345. V`20on`20the`20actual`20data
  1346. Xin`20the`20file.`20Following`20this,`20the`20file`20can`20be`20packaged`20with
  1347. Vout`20the`20use`20of`20the
  1348. Xlong`20lines`20support`20option.
  1349. X
  1350. X
  1351. X
  1352. X7.`20TESTING
  1353. X
  1354. XThis`20version`20of`20VMS_SHARE`20has`20only`20been`20tested`20on`20VMS`205.5-
  1355. V1`20but`20is`20believed`20to
  1356. Xwork`20`20on`20all`20versions`20from`20VMS`205.0`20to`20VMS`205.5-1.`20`20Howe
  1357. Vver,`20it`20is`20not`20supported`20
  1358. Xformally`20on`20any`20version`20of`20VMS`20other`20than`20the`20one`20on`20whi
  1359. Vch`20it`20has`20been`20tested.
  1360. X
  1361. XThe`20share`20files`20generated`20by`20VMS_SHARE`20are`20believed`20to`20unpac
  1362. Vk`20correctly`20on`20all
  1363. Xversions`20of`20TPU`20from`20VMS`204.4`20onwards`20unless`20the`20/LONGLINES
  1364. +-+-+-+-+-+-+-+-  END  OF PART 5 +-+-+-+-+-+-+-+-
  1365.