home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / vmsnet / sources / 498 < prev    next >
Encoding:
Internet Message Format  |  1993-01-26  |  47.7 KB
  1. Path: sparky!uunet!stanford.edu!agate!spool.mu.edu!howland.reston.ans.net!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 08/09
  5. Message-ID: <10312318@MVB.SAIC.COM>
  6. Date: Mon, 25 Jan 1993 21:35:04 GMT
  7. Lines: 1222
  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 52
  13. Archive-name: vms_share/part08
  14. Supersedes: vms_share: Volume 3, Issue 87-89
  15.  
  16. -+-+-+-+-+-+-+-+ START OF PART 8 -+-+-+-+-+-+-+-+
  17. X
  18. XThe`20recipient`20parameter`20is`20the`20mail`20address`20of`20the`20user,`20o
  19. Vr`20users,`20who`20are`20to`20
  20. Xbe`20sent`20the`20package.`20This`20can`20take`20any`20form`20of`20mail`20addr
  21. Vess`20acceptable`20to`20the`20
  22. XVMS`20MAIL`20system`20when`20used`20from`20the`20command`20line.`20For`20examp
  23. Vle:
  24. X
  25. X`20`20`20FRED
  26. X`20`20`20NODE::JIM
  27. X`20`20`20NODE::JIM,FRED
  28. X
  29. XThere`20are`20two`20small`20problems`20to`20watch`20out`20for.`20Firstly,`20th
  30. Ve`20use`20of`20
  31. Xdistribution`20lists`20requires`20an`20@`20symbol`20to`20precede`20a`20file
  32. V`20specification`20which`20
  33. Xcontains`20the`20recipient`20names.`20Used`20directly,`20DCL`20intercepts`20th
  34. Ve`20@`20before`20mail`20
  35. Xdoes,`20and`20so`20the`20command`20does`20not`20work`20correctly.`20To`20avoid
  36. V`20this,`20define`20a`20
  37. Xlogical`20name`20to`20point`20at`20the`20distribution`20list`20and`20specify
  38. V`20the`20logical`20name`20as`20
  39. Xthe`20recipient.`20For`20example:
  40. X
  41. X`20`20`20$`20DEFINE`20USERS`20"@BETA_TEST_USERS.DIS"
  42. X`20`20`20$`20PAKMAIL`20USERS`20...
  43. X
  44. XSecondly,`20usernames`20that`20contain`20quotes`20(")`20need`20special`20atten
  45. Vtion`20because`20of`20
  46. Xthe`20way`20DCL/MAIL`20parse`20quoted`20strings.`20Typically,`20this`20is`20im
  47. Vportant`20when`20
  48. Xsending`20network`20mail`20as`20the`20usual`20form`20of`20address`20is:
  49. X
  50. X`20`20`20NET%"user@site"
  51. X
  52. XIn`20this`20instance,`20the`20quotes`20must`20be`20doubled,`20with`20another
  53. V`20set`20around`20each`20
  54. Xto`20give`20an`20address`20specification`20of:
  55. X
  56. X`20`20`20NET%"""user@site"""
  57. X
  58. X
  59. X
  60. X5.2`20File`20specification
  61. X
  62. XThe`20file`20specification`20gives`20the`20name`20of`20the`20package`20to`20be
  63. V`20sent.`20It`20should`20be`20
  64. Xthe`20share`20file`20template`20name`20-`20omitting`20the`20part`20numbers.
  65. V`20For`20example,`20a`20
  66. Xspecification`20of`20"PACKAGE."`20will`20cause`20the`20package`20to`20send`20t
  67. Vhese`20files:
  68. X
  69. X`20`20`20PACKAGE.01-OF-10
  70. X`20`20`20PACKAGE.02-OF-10
  71. X`20`20`20...
  72. X`20`20`20PACKAGE.10-OF-10
  73. X
  74. X
  75. X
  76. X
  77. X5.3`20Maximum`20Parts`20specification
  78. X
  79. XThis`20is`20simply`20the`20total`20number`20of`20parts`20in`20the`20package.
  80. V`20It`20controls`20how`20many`20
  81. Xfiles`20to`20be`20sent`20to`20each`20recipient.
  82. X
  83. X
  84. XA`20typical`20example`20of`20a`20PAKMAIL`20command`20would`20be
  85. X
  86. X`20`20`20$`20PAKMAIL`20NET%"""FRED@SCROUNGING-SITE"""`20PACKAGE.TEST`205
  87. X
  88. X
  89. X
  90. X5.4`20Partlist`20Specification
  91. X
  92. XBy`20default,`20all`20parts`20of`20the`20package`20are`20sent.`20On`20occasion
  93. V,`20it`20may`20be`20necessary
  94. Xto`20resend`20a`20subset`20of`20the`20package.`20This`20parameter`20allows`20a
  95. V`20list`20of`20parts`20to`20be
  96. Xgiven`20and`20only`20those`20parts`20will`20be`20sent.`20The`20list`20is`20a
  97. V`20comma`20separated`20set`20of
  98. Xpart`20numbers.
  99. X
  100. X
  101. XFor`20example:
  102. X
  103. X`20`20`20$`20PAKMAIL`20NET%"""FRED@SCROUNGING-SITE"""`20PACKAGE.TEST`205`204,2
  104. V
  105. X`20`20`20`20`20`20`20`20The`20addition`20of`20the`20"4,2"`20parameter`20restri
  106. Vcts`20the`20parts`20sent`20out`20to
  107. X`20`20`20`20`20`20`20`20parts`204`20and`202.
  108. X
  109. X
  110. X5.5`20Comment`20specification
  111. X
  112. XThe`20subject`20line`20of`20the`20mail`20message`20sent`20to`20each`20recipien
  113. Vt`20identifies`20the`20
  114. Xpackage,`20which`20part`20and`20the`20total`20number`20of`20parts`20in`20the
  115. V`20form:
  116. X
  117. X`20`20`20Subj:`20PACKAGE.1-OF-5
  118. X
  119. X
  120. XOptionally`20a`20further`20parameter`20can`20be`20given`20on`20the`20PAKMAIL
  121. V`20command.`20This`20
  122. Xparameter`20will`20be`20inserted`20verbatim`20into`20the`20subject`20line.
  123. X
  124. XFor`20example,`20if`20this`20command`20is`20issued:
  125. X
  126. X`20`20`20$`20PAKMAIL`20NET%"""FRED@SCROUNGING-SITE"""`20PACKAGE`205`20""`20"(B
  127. Veta-Test`20v2)"
  128. X
  129. X(Note`20the`20use`20of`20a`20placeholder`20as`20the`20fourth`20parameter`20if
  130. V`20a`20partlist`20is`20not
  131. Xrequired).
  132. X
  133. XThen`20the`20generated`20subject`20line`20would`20look`20like`20this:
  134. X
  135. X`20`20`20Subj:`20PACKAGE.1-OF-5`20(Beta-Test`20v2)
  136. X`0C
  137. X6.`09HOW`20TO`20UNPACK`20A`20SHARE`20FILE
  138. X
  139. X6.1`20Command`20file
  140. X
  141. XA`20share`20file`20is`20designed`20to`20be`20run`20as`20a`20command`20procedur
  142. Ve`20which`20will`20recreate`20
  143. Xthe`20original`20source`20files.`20So`20in`20theory,`20it`20is`20simply`20nece
  144. Vssary`20to`20extract`20the`20
  145. Xreceived`20mail`20message`20into`20a`20file,`20remove`20the`20mail`20headers,
  146. V`20and`20then`20run`20it`20as`20
  147. Xa`20command`20procedure.
  148. X
  149. XFor`20a`20single`20part`20share`20file,`20the`20following`20sequence`20of`20co
  150. Vmmands`20is`20necessary:
  151. X
  152. X`20`20`20`20`20$`20SET`20DEFAULT`20<scratch`20directory>
  153. X`20`20`20`20`20$`20MAIL
  154. X`20`20`20`20`20MAIL>`20`20`20READ`20<share`20file`20message`20part`201>
  155. X`20`20`20`20`20MAIL>`20`20`20EXTRACT/NOHEADER`20file
  156. X`20`20`20`20`20MAIL>`20`20`20EXIT
  157. X`20`20`20`20`20$
  158. X`20`20`20`20`20$`20@file
  159. X
  160. X
  161. X
  162. X6.2`20Dealing`20with`20multiple`20part`20share`20files
  163. X
  164. XThe`20recipient`20of`20a`20multi-part`20package`20sent`20in`20this`20form`20wi
  165. Vll`20receive`20a`20number
  166. Xof`20separate`20mail`20messages`20-`20one`20per`20part`20-`20but`20not`20neces
  167. Vsarily`20in`20the`20correct
  168. Xnumeric`20order.`20These`20individual`20messages`20must`20be`20extracted`20and
  169. V`20combined`20into
  170. Xone`20file`20IN`20THE`20RIGHT`20ORDER.`20The`20exact`20sequence`20of`20events
  171. V`20is`20similar`20to`20above
  172. Xbut`20slightly`20complicated`20by`20the`20need`20to`20extract`20them`20in`20th
  173. Ve`20right`20order`20and
  174. Xappend`20them`20into`20a`20single`20file:`20
  175. X
  176. X`20`20`20`20`20$`20SET`20DEFAULT`20<scratch`20directory>
  177. X`20`20`20`20`20$`20MAIL
  178. X`20`20`20`20`20MAIL>`20`20`20READ`20<share`20file`20message`20part`201>
  179. X`20`20`20`20`20MAIL>`20`20`20EXTRACT/NOHEADER`20`20`20`20`20`20`20`20file
  180. X`20`20`20`20`20MAIL>`20`20`20READ`20<share`20file`20message`20part`202>
  181. X`20`20`20`20`20MAIL>`20`20`20EXTRACT/NOHEADER/APPEND`20file
  182. X`20`20`20`20`20MAIL>`20`20`20`20`20`20`20`20...`20repeat`20last`20two`20steps
  183. V`20for`20each`20part`20in`20sequence
  184. X`20`20`20`20`20MAIL>`20`20`20EXIT
  185. X`20`20`20`20`20$
  186. X`20`20`20`20`20$`20@file
  187. X
  188. XStrictly`20speaking,`20it`20is`20not`20necessary`20to`20remove`20the`20mail
  189. V`20headers`20from`20each`20
  190. Xpart`20except`20the`20first,`20as`20the`20share`20file`20format`20is`20designe
  191. Vd`20to`20skip`20these`20
  192. Xautomatically.
  193. X
  194. XIt`20is`20important`20to`20note`20that`20ALL`20parts`20must`20be`20extracted,
  195. V`20and`20in`20the`20right
  196. Xorder,`20before`20trying`20to`20unpack.`20It`20is`20not`20possible`20to`20unpa
  197. Vck`20each`20part
  198. Xindividually.`20
  199. X
  200. X
  201. X
  202. X
  203. X7.`09REFERENCES
  204. X
  205. XThe`20following`20references`20provide`20further`20information`20on`20VMS_SHAR
  206. VE`20and`20are`20
  207. Xprovided`20with`20each`20release`20of`20the`20software.
  208. X
  209. X`5B1`5D`09VMS_SHARE`20Technical`20Information`20supplement
  210. X`5B2`5D`09VMS_SHARE`20Release`20notes
  211. X`5B3`5D`09On-line`20HELP
  212. X`0C
  213. X
  214. X
  215. X
  216. X
  217. X
  218. X
  219. X
  220. X
  221. X
  222. X
  223. X
  224. X
  225. X
  226. X
  227. X
  228. X
  229. X
  230. X
  231. X
  232. X
  233. X
  234. X
  235. X
  236. X
  237. X
  238. X`20`20`20`20`20`20----------------------------------------------------------
  239. X
  240. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20QUALIFIER`20REFERE
  241. VNCE`20SECTION
  242. X
  243. X`20`20`20`20`20`20----------------------------------------------------------
  244. X`0C
  245. XQUALIFIER:
  246. X`09`09/BACKUP
  247. X
  248. X
  249. XPURPOSE:
  250. X`09`09Specifies`20that`20the`20last`20backup`20date`20should`20be`20used`20for
  251. V`20the
  252. X`09`09purpose`20of`20date`20based`20file`20selection`20by`20the`20/BEFORE`20an
  253. Vd
  254. X`09`09/SINCE`20qualifiers
  255. X
  256. X
  257. XDEFAULT:
  258. X`09`09Use`20the`20last-modified`20date
  259. X
  260. X
  261. XASSOCIATED`20LOGICAL`20NAME:
  262. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  263. X
  264. X
  265. XPRIVILEGES`20REQUIRED:
  266. X`09`09NONE
  267. X
  268. X
  269. XDESCRIPTION:
  270. X`09`09Files`20may`20be`20selected`20for`20packaging`20on`20the`20basis`20of
  271. V`20the`20dates
  272. X`09`09associated`20with`20the`20file,`20using`20the`20/BEFORE`20and`20/SINCE
  273. X`09`09qualifiers.`20`20The`20/BACKUP`20qualifier`20says`20that`20the`20last
  274. V`20backup
  275. X`09`09date`20should`20be`20used`20as`20the`20comparison`20date.
  276. X
  277. X
  278. XRESTRICTIONS:
  279. X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
  280. VORE
  281. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
  282. X
  283. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
  284. V`20are`20mutually`20exclusive;`20only`20the`20last
  285. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
  286. V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
  287. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
  288. X`0C
  289. XQUALIFIER:
  290. X`09`09/BEFORE`5B=date`5D
  291. X
  292. X
  293. X
  294. XPURPOSE:
  295. X`09`09Specifies`20that`20all`20files`20selected`20must`20have`20a`20date`20ass
  296. Vociated
  297. X`09`09with`20them`20which`20is`20before`20the`20specified`20date.
  298. X
  299. X
  300. XDEFAULT:
  301. X`09`09The`20dates`20associated`20with`20a`20file`20are`20not`20used`20for`20se
  302. Vlection
  303. X`09`09purposes.
  304. X
  305. X
  306. XASSOCIATED`20LOGICAL`20NAME:
  307. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  308. X
  309. X
  310. XPRIVILEGES`20REQUIRED:
  311. X`09`09NONE
  312. X
  313. X
  314. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20DESCRIPTION:`20If`20either`20o
  315. Vf`20the`20/SINCE`20or`20/BEFORE`20qualifiers`20is
  316. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specified,`20then`20each`20fil
  317. Ve`20specified`20in`20the`20parameter`20list`20is
  318. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20checked`20to`20see`20if`20the
  319. V`20date`20associated`20with`20the`20file`20is`20within
  320. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20appropriate`20date`20ran
  321. Vge.`20The`20file`20is`20selected`20for`20packaging
  322. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20only`20if`20it`20does.`20No
  323. V`20check`20is`20made`20if`20neither`20qualifier`20is
  324. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specified`20and`20the`20file
  325. V`20is`20selected.
  326. X
  327. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20There`20are`20four`20dates`20a
  328. Vssociated`20with`20a`20file`20-`20Creation,`20Last
  329. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Modified,`20Expiration`20and
  330. V`20Last`20Backup.`20Any`20of`20these`20can`20be`20used
  331. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20as`20the`20basis`20for`20selec
  332. Vtion.
  333. X
  334. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20To`20select`20which`20of`20the
  335. V`20four`20dates`20to`20use,`20these`20qualifiers`20are
  336. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20used:
  337. X
  338. X`09`09`20`20`20/BACKUP`09`09Last`20backup`20date`20used
  339. X`09`09`20`20`20/CREATED`09`09Creation`20date`20used
  340. X`09`09`20`20`20/EXPIRED`09`09Expiration`20date`20used
  341. X`09`09`20`20`20/MODIFIED`09`09Last`20modified`20date`20used
  342. X
  343. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20To`20select`20the`20date`20ran
  344. Vge,`20these`20qualifiers`20are`20used:
  345. X
  346. X`09`09`20`20`20/BEFORE`5B=date`5D`09Select`20files`20before`20the`20date
  347. X`09`09`20`20`20/SINCE`5B=date`5D`09Select`20files`20after`20the`20date
  348. X
  349. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20neither`20qualifier`20is
  350. V`20specified,`20then`20the`20corresponding
  351. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20constraint`20on`20the`20date
  352. V`20is`20lifted.
  353. X
  354. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20It`20is`20permitted`20to`20use
  355. V`20/SINCE`20and`20/BEFORE`20together`20to`20specify
  356. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20both`20an`20earliest`20date
  357. V`20and`20a`20latest`20date`20for`20the`20files.`20If`20no
  358. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20date/time`20specification`20is
  359. V`20given`20on`20either`20the`20/SINCE`20or
  360. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/BEFORE`20qualifiers,`20then
  361. V`20the`20default`20is`20"TODAY".
  362. X
  363. X
  364. XRESTRICTIONS:
  365. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Only`20one`20of`20/BACKUP,`20/
  366. VCREATED,`20/EXPIRED`20or`20/MODIFIED`20should`20be
  367. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20used.`20If`20several`20are`20s
  368. Vpecified`20only`20the`20last`20one`20is`20used.`20If
  369. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20none`20are`20specified,`20/MOD
  370. VIFIED`20is`20assumed.
  371. X
  372. X`09`09The`20format`20of`20the`20date`20specification`20is`20a`20standard`20VMS
  373. V
  374. X`09`09date/time`20specification`20with`20these`20exceptions:
  375. X
  376. X`09`09`20`20`20o`20The`20date/time`20spec`20must`20not`20contain`20spaces
  377. X
  378. X`09`09`20`20`20o`20The`20date/time`20spec`20must`20not`20be`20quoted
  379. X
  380. X`09`09`20`20`20o`20Missing`20fields`20are`20taken`20from`20the`20CURRENT`20dat
  381. Ve/time`20and
  382. X`09`09`20`20`20`20`20NOT`20from`20midnight`20as`20with`20other`20VMS`20command
  383. Vs.
  384. X
  385. X
  386. X
  387. XEXAMPLES:
  388. X`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/BEFORE
  389. X
  390. X`09`09Package`20all`20files`20modified`20before`20today
  391. X
  392. X`09`09
  393. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  394. V`20/BEFORE=1-JAN-1992:00:00:00.00`20/CREATED
  395. X
  396. X`09`20`20`20`09Package`20all`20files`20created`20before`20this`20year
  397. X
  398. X`09`09
  399. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  400. V`20/SINCE=YESTERDAY`20/BEFORE=TODAY`20/BACKUP
  401. X
  402. X`09`09Package`20all`20files`20that`20were`20backed`20up`20yesterday
  403. X
  404. X`09`09
  405. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20Z`20/BEF
  406. VORE=TODAY
  407. X`09`09
  408. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20will`20select`20all`20f
  409. Viles`20which`20have`20a`20modified`20date`20(the
  410. X`09`09default)`20before`20today's`20date.
  411. X`0C
  412. XQUALIFIER:
  413. X`09`09/`5BNO`5DCOMPRESS`5B=n`5D
  414. X
  415. X
  416. XPURPOSE:
  417. X`09`09Select`20the`20level`20of`20compression`20performed`20on`20each`20file
  418. V`20packaged
  419. X
  420. X
  421. X
  422. XDEFAULT:
  423. X`09`09/NOCOMPRESS`09`09No`20compression`20is`20performed
  424. X
  425. X
  426. X
  427. XASSOCIATED`20LOGICAL`20NAME:
  428. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_COMPRESS
  429. X
  430. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
  431. V`20be`20defined`20to`20any`20true`20or`20false`20value,`20or
  432. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20to`20a`20numeric`20value`20wit
  433. Vhin`20the`20range`200-2.`20The`20value`20determines
  434. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20default`20for`20any`20su
  435. Vbsequent`20run`20where`20the`20qualifier
  436. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS`20is`20not`20used.
  437. X
  438. X
  439. XPRIVILEGES`20REQUIRED:
  440. X`09`09NONE
  441. X
  442. X
  443. X
  444. XDESCRIPTION:
  445. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20packages`20files
  446. V`20in`20the`20original`20forms`20where`20possible.
  447. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20only`20codings`20made
  448. V`20are`20to`20characters`20or`20bytes`20which`20may
  449. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20prove`20troublesome`20if`20tra
  450. Vnsmitted`20through`20a`20text`20based`20mail
  451. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20system.`20So`20most`20printing
  452. V`20characters`20should`20remain`20visible.
  453. X
  454. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20various`20encodings`20ma
  455. Vde`20to`20the`20file,`20to`20ensure`20trouble`20free
  456. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20transmission,`20can`20increase
  457. V`20the`20overall`20size`20significantly.`20No
  458. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20attempt`20is`20made`20to`20com
  459. Vpress`20the`20data`20to`20reduce`20this`20side
  460. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20effect.`20However,`20additiona
  461. Vl`20file`20compression`20may`20be`20selected`20if
  462. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20required,`20in`20an`20attempt
  463. V`20to`20reduce`20this`20overhead`20and`20hence`20speed
  464. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20up`20transmission`20of`20the
  465. V`20file`20through`20the`20mail`20system.
  466. X
  467. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Two`20compression`20options
  468. V`20are`20offered`20-`20the`20first`20is`20a`20simple
  469. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20run-length`20encoding`20algori
  470. Vthm`20to`20replace`20runs`20of`20the`20same
  471. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20character`20by`20a`20shorter
  472. V`20sequence,`20the`20second`20is`20a`20more`20complex
  473. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20algorithm`20designed`20to`20se
  474. Vek`20out`20common`20substrings`20in`20a`20file`20and
  475. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20encode`20them`20to`20shorter
  476. V`20sequences.`20The`20latter`20algorithm`20is`20based
  477. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20heavily`20on`20one`20known`20a
  478. Vs`20Lempel-Ziv,`20although`20it`20has`20been
  479. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20significantly`20modified`20for
  480. V`20use`20here.
  481. X
  482. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20These`20compression`20qualifie
  483. Vrs`20are`20recognized:
  484. X
  485. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOCOMPRESS`09`09`09N
  486. Vo`20compression`20performed
  487. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS`09`09`09Run
  488. V-length`20compression
  489. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS=0`20`20`20
  490. V`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20No`20compression`20performed
  491. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS=1`09`09`09R
  492. Vun-Length`20compression
  493. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/COMPRESS=2`09`09`09L
  494. Vempel-Ziv`20compression
  495. X
  496. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20share`20file,`20when`20u
  497. Vnpacked,`20will`20automatically`20expand`20the
  498. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20data`20back`20to`20its`20origi
  499. Vnal`20form.
  500. X
  501. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Selection`20of`20compression
  502. V`20has`20two`20main`20effects:
  503. X
  504. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20First,`20in`20general,`20the
  505. V`20overall`20size`20of`20the`20packaged`20files`20is
  506. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20reduced;`20the`20exact`20compr
  507. Vession`20ratio`20will`20vary`20depending`20on`20the
  508. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20content`20of`20the`20file.`20I
  509. Vn`20some`20cases,`20it`20may`20be`20of`20no`20benefit.
  510. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20implementation`20will
  511. V`20never`20increase`20the`20size`20of`20a`20file
  512. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20soley`20because`20of`20the`20a
  513. Vdditional`20compression`20options`20chosen.`20
  514. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Lempel-Ziv`20compression`20is
  515. V`20considerably`20better`20than`20the
  516. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20run-length`20encoding`20mechan
  517. Vism.
  518. X
  519. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Second,`20It`20will`20generall
  520. Vy`20take`20significantly`20longer`20to`20perform
  521. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20additional`20compression`20on
  522. V`20the`20file.`20Lempel-Ziv`20takes
  523. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20significantly`20longer`20than
  524. V`20run-length`20encoding`20(but`20does`20a
  525. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20better`20job).
  526. X
  527. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20It`20is`20important`20to`20rec
  528. Vognize`20the`20tradeoffs`20here;`20additional`20cpu
  529. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20time`20is`20being`20traded`20f
  530. Vor`20a`20potential`20(though`20not`20guaranteed)
  531. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20reduction`20in`20the`20package
  532. Vd`20file`20size.`20You`20should`20consider
  533. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20whether`20it`20is`20really`20o
  534. Vf`20benefit`20before`20selecting`20it.`20As`20a
  535. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20general`20rule`20of`20thumb,
  536. V`20select`20compression`20only`20if`20you`20are`20going
  537. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20to`20place`20the`20package`20o
  538. Vn`20a`20file`20server,`20where`20reduction`20in`20disk
  539. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20space`20occupancy`20is`20desir
  540. Vable,`20or`20if`20you`20intend`20to`20mail`20a`20very
  541. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20large`20package`20to`20hundred
  542. Vs`20of`20people,`20where`20a`20reduction`20in
  543. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20network`20bandwidth`20is`20des
  544. Virable.`20Otherwise,`20don't`20bother.
  545. X
  546. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Note`20that`20the`20overhead
  547. V`20involved`20in`20decompressing`20a`20file`20when`20it
  548. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20is`20being`20unpacked`20from
  549. V`20the`20sharefile`20is`20fairly`20small,`20and`20can
  550. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20usually`20be`20ignored`20for
  551. V`20the`20purposes`20of`20deciding`20upon`20the
  552. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20tradeoffs.
  553. X
  554. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Note`20that`20the`20built-in
  555. V`20compression`20schemes`20are`20not`20the`20best
  556. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20available.`20They`20are`20inte
  557. Vnded`20to`20provide`20reasonable`20compression
  558. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20without`20resorting`20to`20ext
  559. Vernal`20utilities,`20though`20at`20the`20cost`20of
  560. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20considerable`20packaging`20tim
  561. Ve.`20Better`20or`20faster`20compression`20can
  562. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20obtained`20using`20extern
  563. Val`20utilities`20but`20this`20complicates`20the
  564. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20process`20of`20packaging`20fil
  565. Ves`20and`20assumes`20that`20the`20recipient`20has
  566. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20corresponding`20decompre
  567. Vssion`20utilities.`20VMS_SHARE`20makes`20it
  568. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20simple`20and`20does`20not`20re
  569. Vquire`20the`20recipient`20to`20have`20any`20other
  570. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20tools.
  571. X
  572. X
  573. X
  574. XRESTRICTIONS:
  575. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  576. X
  577. X
  578. X
  579. XEXAMPLES:
  580. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20COMPACT
  581. V`20/COMPRESS
  582. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20the`20files
  583. V,`20using`20run`20length`20compression
  584. X
  585. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20COMPACT
  586. V`20/COMPRESS=2
  587. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20the`20files
  588. V,`20using`20Lempel-Ziv`20compression
  589. X`0C
  590. XQUALIFIER:
  591. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DCONFIRM
  592. X
  593. X
  594. XPURPOSE:
  595. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Require`20user`20confirmation
  596. V`20of`20all`20files`20selected
  597. X
  598. X
  599. XDEFAULT:
  600. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOCONFIRM`09User`20is`20not
  601. V`20asked`20to`20confirm`20each`20file
  602. X
  603. X
  604. XASSOCIATED`20LOGICAL`20NAME:
  605. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_CONFIRM
  606. X
  607. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
  608. V`20be`20defined`20with`20a`20true`20or`20false`20value.`20It
  609. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifies`20the`20default`20fo
  610. Vr`20all`20subsequent`20executions`20which`20do
  611. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20not`20specify`20the`20/COMPRES
  612. VS`20qualifier
  613. X
  614. X
  615. XPRIVILEGES`20REQUIRED:
  616. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  617. X
  618. X
  619. XDESCRIPTION:
  620. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20selection`20of`20files
  621. V`20for`20packaging`20can`20be`20automatic,`20or`20with
  622. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20confirmation.`20With`20confirm
  623. Vation,`20the`20user`20is`20asked`20about`20each
  624. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20matching`20the`20qualif
  625. Viers`20and`20parameters`20to`20see`20if`20it`20should
  626. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20included`20in`20the`20pac
  627. Vkage.`20A`20simple`20Y`20or`20N`20response`20is`20then
  628. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20required`20from`20the`20user
  629. V`20to`20select`20or`20not`20select`20it`20for
  630. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20inclusion.
  631. X
  632. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOCONFIRM`20specifies`20that
  633. V`20confirmation`20is`20not`20required.
  634. X
  635. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/CONFIRM`20specifies`20that
  636. V`20confirmation`20is`20required.
  637. X
  638. X
  639. XRESTRICTIONS:
  640. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Because`20confirmation`20requi
  641. Vres`20a`20response`20from`20the`20user,`20it`20is
  642. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20not`20permitted`20in`20non-int
  643. Veractive`20environments.`20`20A`20warning
  644. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20message`20will`20be`20issued
  645. V`20and`20confirmation`20turned`20off.
  646. X
  647. X
  648. XEXAMPLE:
  649. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  650. V`20`20/CONFIRM
  651. X
  652. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Request`20confirmation`20from
  653. V`20the`20user`20of`20each`20file`20selected.`20Each
  654. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20requires`20a`20Y`20(to
  655. V`20select)`20or`20a`20N`20(to`20not`20select)`20response.
  656. X`0C
  657. XQUALIFIER:
  658. X`09`09/CREATED
  659. X
  660. X
  661. XPURPOSE:
  662. X`09`09Specifies`20that`20the`20creation`20date`20should`20be`20used`20for`20th
  663. Ve
  664. X`09`09purpose`20of`20date`20based`20file`20selection`20by`20the`20/BEFORE`20an
  665. Vd
  666. X`09`09/SINCE`20qualifiers
  667. X
  668. X
  669. XDEFAULT:
  670. X`09`09Use`20the`20last-modified`20date
  671. X
  672. X
  673. XASSOCIATED`20LOGICAL`20NAME:
  674. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  675. X
  676. X
  677. XPRIVILEGES`20REQUIRED:
  678. X`09`09NONE
  679. X
  680. X
  681. XDESCRIPTION:
  682. X`09`09Files`20may`20be`20selected`20for`20packaging`20on`20the`20basis`20of
  683. V`20the`20dates
  684. X`09`09associated`20with`20the`20file,`20using`20the`20/BEFORE`20and`20/SINCE
  685. X`09`09qualifiers.`20`20The`20/CREATED`20qualifier`20says`20that`20the`20creati
  686. Von
  687. X`09`09date`20should`20be`20used`20as`20the`20comparison`20date.
  688. X
  689. X
  690. XRESTRICTIONS:
  691. X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
  692. VORE
  693. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
  694. X
  695. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
  696. V`20are`20mutually`20exclusive;`20only`20the`20last
  697. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
  698. V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
  699. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
  700. X
  701. X`0C
  702. XQUALIFIER:
  703. X`09`09/`5BNO`5DDEBUG`5B=nnn`5D
  704. X
  705. X
  706. XPURPOSE:
  707. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specify`20that`20debugging`20o
  708. Vutput`20is`20to`20be`20produced;`20nnn`20is`20the
  709. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20level`20of`20debugging`20requi
  710. Vred,`20from`200`20to`204.
  711. X
  712. X
  713. XDEFAULT:
  714. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NODEBUG`09`09Debugging`20outp
  715. Vut`20is`20OFF
  716. X
  717. X
  718. XASSOCIATED`20LOGICAL`20NAME:
  719. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_DEBUG
  720. X
  721. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20logical`20name`20can`20b
  722. Ve`20defined`20with`20any`20true`20or`20false`20value,
  723. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20an`20integer`20in`20the
  724. V`20range`200-4.`20When`20defined,`20it`20will`20determine
  725. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20default`20value`20for
  726. V`20subsequent`20executions`20that`20do`20not`20specify
  727. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20/DEBUG`20qualifier.
  728. X
  729. X
  730. XPRIVILEGES`20REQUIRED:
  731. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Either`20SETPRV`20or`20SYSPRV
  732. V`20required`20in`20the`20user's`20list`20of
  733. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20AUTHORIZED`20privileges
  734. X
  735. X
  736. X
  737. XDESCRIPTION:
  738. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20For`20developing`20VMS_SHARE,
  739. V`20or`20investigating`20problems,`20it`20may`20be
  740. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20helpful`20to`20use`20the`20deb
  741. Vugging`20code`20built`20into`20the`20package.
  742. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Several`20levels`20of`20debugg
  743. Ving`20are`20built`20in`20-`20Level`200`20is`20no
  744. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20debugging,`20level`204`20is
  745. V`20the`20most`20detailed`20and`20verbose`20level`20of
  746. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20debugging.`20Debugging`20cause
  747. Vs`20informational`20messages`20to`20be`20output
  748. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20describing`20the`20state`20of
  749. V`20VMS_SHARE`20and`20can`20be`20used`20to
  750. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20investigate`20undocumented`20b
  751. Vehaviour.
  752. X
  753. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20following`20qualifier
  754. V`20formats`20are`20recognized:
  755. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NODEBUG`09`09Debu
  756. Vgging`20is`20off
  757. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG`20`20`20
  758. V`20`20`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`201
  759. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=0`20`20`20
  760. V`20`20`20`20`20`20`20`20`20Debugging`20is`20OFF
  761. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=1`20`20`20
  762. V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`201
  763. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=2`20`20`20
  764. V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`202
  765. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=3`20`20`20
  766. V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`203
  767. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DEBUG=4`20`20`20
  768. V`20`20`20`20`20`20`20`20`20Debugging`20is`20on`20at`20level`204
  769. X
  770. X
  771. XRESTRICTIONS:
  772. X`09`09NONE
  773. X
  774. X
  775. XEXAMPLES:
  776. X`20`20`20`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/NODEBUG
  777. X`09`09`20`20`20`20`20`20Package`20files,`20with`20a`20debug`20level`20of`200
  778. X
  779. X`20`20`20`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/DEBUG
  780. X`09`09`20`20`20`20`20`20Package`20files,`20with`20a`20debug`20level`20of`201
  781. X
  782. X`20`20`20`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/DEBUG=2
  783. X`09`09`20`20`20`20`20`20Package`20files,`20with`20a`20debug`20level`20of`202
  784. X`0C
  785. XQUALIFIER:
  786. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DDIRECTORY
  787. X
  788. X
  789. X
  790. XPURPOSE:
  791. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Select`20preservation`20of`20s
  792. Vubdirectory`20names`20on`20each`20file`20packaged
  793. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20in`20order`20to`20re-create
  794. V`20them`20during`20unpacking.
  795. X
  796. X
  797. XDEFAULT:
  798. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/DIRECTORY`09`09Directories
  799. V`20are`20preserved
  800. X
  801. X
  802. X
  803. XASSOCIATED`20LOGICAL`20NAME:
  804. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_DIRECTORY
  805. X
  806. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
  807. V`20be`20defined`20with`20any`20true`20or`20false`20value.
  808. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20defined`20it`20specifie
  809. Vs`20the`20default`20value`20for`20all`20subsequent
  810. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20executions`20that`20do`20not
  811. V`20specify`20the`20/DIRECTORY`20qualifier.
  812. X
  813. X
  814. XPRIVILEGES`20REQUIRED:
  815. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  816. X
  817. X
  818. XDESCRIPTION:
  819. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20/NODIRECTORY`20is`20spe
  820. Vcified,`20the`20subdirectory`20name`20of`20each
  821. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20discarded`20and
  822. V`20all`20files`20will`20be`20created`20in`20the
  823. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20directory`20current`20at`20the
  824. V`20time`20of`20unpacking.`20The`20input`20files`20may
  825. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20from`20any`20source`20at
  826. V`20all,`20although`20care`20should`20be`20taken`20with
  827. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20multiple`20input`20directories
  828. V`20to`20ensure`20that`20clashing`20filenames`20do
  829. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20not`20occur.
  830. X
  831. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20/DIRECTORY`20is`20speci
  832. Vfied,`20the`20subdirectory`20name`20of`20each
  833. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20preserved`20so`20t
  834. Vhat`20the`20unpacking`20process`20can`20recreate`20a
  835. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20copy`20of`20the`20directory
  836. V`20tree`20below`20thge`20current`20directory.`20The
  837. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20input`20files`20must`20lie`20o
  838. Vn`20the`20same`20disk`20at`20or`20below`20the`20current
  839. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20subdirectory.`20`20This`20is
  840. V`20to`20ensure`20that`20a`20well-defined`20set`20of
  841. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20directories`20are`20recreated
  842. V`20at`20unpacking`20time.
  843. X
  844. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20option`20is`20supplied
  845. V`20primarily`20for`20compatibility`20with
  846. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20previous`20versions`20of`20the
  847. V`20utility`20which`20did`20not`20preserve`20version
  848. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20numbers.
  849. X
  850. X
  851. XRESTRICTIONS:
  852. X`09`09NONE
  853. X
  854. X
  855. XEXAMPLES:
  856. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20`5B...`5D*.*
  857. V`20PACKAGE`20/DIRECTORY
  858. X
  859. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Preserve`20the`20subdirectory
  860. V`20names`20to`20cause`20recreation`20of`20the
  861. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20directory`20tree`20when`20unpa
  862. Vcked.
  863. X
  864. X
  865. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20`5B...`5D*.*
  866. V`20PACKAGE`20/NODIRECTORY
  867. X
  868. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Do`20not`20preserve`20director
  869. Vy`20names;`20all`20files`20will`20be`20created`20in
  870. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20current`20directory`20wh
  871. Ven`20unpacked.`20Care`20must`20be`20taken`20to
  872. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20avoid`20clashing`20file`20name
  873. Vs.
  874. X`0C
  875. XQUALIFIER:
  876. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DEXCLUDE`5B=list`5D
  877. X
  878. X
  879. XPURPOSE:
  880. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specify`20a`20list`20of`20file
  881. V`20patterns`20which,`20if`20matched,`20prevent`20a
  882. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20from`20being`20packaged
  883. V.
  884. X
  885. XDEFAULT:
  886. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOEXCLUDE`09`09No`20files`20a
  887. Vre`20excluded`20from`20packaging
  888. X
  889. X
  890. XASSOCIATED`20LOGICAL`20NAME:
  891. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_EXCLUDE
  892. X
  893. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
  894. V`20be`20defined`20with`20a`20comma`20separated`20list`20of
  895. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20partial`20file`20specification
  896. Vs`20(see`20description`20below).`20When
  897. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20defined,`20it`20specifies`20th
  898. Ve`20default`20list`20of`20excluded`20files`20for
  899. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20all`20subsequent`20executions
  900. V`20that`20do`20not`20specify`20the`20/EXCLUDE
  901. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifier.
  902. X
  903. X
  904. XPRIVILEGES`20REQUIRED:
  905. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  906. X
  907. X
  908. XDESCRIPTION:
  909. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20will`20normally
  910. V`20package`20up`20all`20files`20matching`20the`20file
  911. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifications`20given`20on
  912. V`20the`20command`20line.`20Sometimes,`20it`20is
  913. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20necessary`20to`20specifically
  914. V`20exclude`20particular`20files.`20For
  915. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20example,`20if`20generating`20a
  916. V`20share`20file`20containing`20only`20sources,`20it
  917. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20would`20be`20usual`20to`20excl
  918. Vude`20all`20files`20with`20a`20type`20of`20.EXE`20or`20.OBJ
  919. X
  920. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20allows`20files`20t
  921. Vo`20be`20excluded`20from`20the`20packaging
  922. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20operation`20based`20upon`20any
  923. V`20combination`20of`20the`20Directory,`20Name,
  924. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Type`20and`20Version`20fields
  925. V`20of`20the`20filename.
  926. X
  927. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20/EXCLUDE`20qualifier`20i
  928. Vs`20used`20to`20specify`20a`20list`20of`20file
  929. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20exclusion`20clauses:
  930. X
  931. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=list
  932. X
  933. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`60list'`20is`20a`20list`20of
  934. V`20file`20specifications`20which`20match`20the`20files
  935. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20to`20be`20excluded`20from`20th
  936. Ve`20packaging`20operation.`20Each`20file
  937. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specification`20may`20be`20any
  938. V`20combination`20of`20directory,`20name,`20type
  939. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20version`20field`20of`20a
  940. V`20filename,`20with`20missing`20fields`20taken`20as
  941. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20matching`20anything`20(equival
  942. Vent`20to`20a`20`60*'`20wildcard`20in`20that
  943. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20particular`20field).
  944. X
  945. X
  946. XRESTRICTIONS:
  947. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Although`20wildcards`20are`20s
  948. Vupported,`20it`20is`20limited`20support`20only.
  949. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20wildcard`20may`20be`20us
  950. Ved`20only`20to`20represent`20a`20COMPLETE`20field
  951. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20(directory,`20name,`20type`20o
  952. Vr`20version)`20and`20not`20a`20partial`20field.
  953. X
  954. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20All`20directory`20names`20must
  955. V`20be`20the`20full`20name.`20Relative`20directory
  956. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifications`20are`20not`20p
  957. Vermitted.
  958. X
  959. X
  960. XEXAMPLES:
  961. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=.EXE`09`09Excludes
  962. V`20all`20files`20with`20a`20type`20of`20.EXE
  963. X
  964. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=.EXE,.OBJ`09Excludes
  965. V`20all`20files`20with`20a`20type`20of`20.EXE
  966. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`09`09`09or`20.OBJ
  967. X
  968. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=NAME.TXT`09Excludes
  969. V`20all`20files`20called`20NAME.DAT`20in
  970. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`09`09`09any`20directory
  971. X
  972. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=;1`09`09Exclude`20all
  973. V`20version`201`20files
  974. X
  975. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=`5BXYZ`5D`09Exclude
  976. V`20all`20files`20in`20directory`20`5BXYZ`5D
  977. X
  978. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Note`20that`20a`20wildcard`20c
  979. Van`20be`20used`20to`20represent`20a`20whole`20field`20of
  980. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20specification`20but`20NO
  981. VT`20a`20partial`20field.`20For`20example:
  982. X
  983. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VALID:
  984. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=*.FOR`09Excl
  985. Vude`20all`20files`20with`20a`20type`20of`20.FOR
  986. X
  987. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20INVALID:
  988. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/EXCLUDE=XYZ*.FOR`09C
  989. Vannot`20use`20the`20*`20as`20PART`20of`20a`20field
  990. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`09`09`09specification
  991. X`0C
  992. XQUALIFIER:
  993. X`09`09/EXPIRED
  994. X
  995. X
  996. XPURPOSE:
  997. X`09`09Specifies`20that`20the`20expiration`20date`20should`20be`20used`20for
  998. V`20the
  999. X`09`09purpose`20of`20date`20based`20file`20selection`20by`20the`20/BEFORE`20an
  1000. Vd
  1001. X`09`09/SINCE`20qualifiers
  1002. X
  1003. X
  1004. XDEFAULT:
  1005. X`09`09Use`20the`20last-modified`20date
  1006. X
  1007. X
  1008. XASSOCIATED`20LOGICAL`20NAME:
  1009. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  1010. X
  1011. X
  1012. XPRIVILEGES`20REQUIRED:
  1013. X`09`09NONE
  1014. X
  1015. X
  1016. XDESCRIPTION:
  1017. X`09`09Files`20may`20be`20selected`20for`20packaging`20on`20the`20basis`20of
  1018. V`20the`20dates
  1019. X`09`09associated`20with`20the`20file,`20using`20the`20/BEFORE`20and`20/SINCE
  1020. X`09`09qualifiers.`20`20The`20/EXPIRED`20qualifier`20says`20that`20the`20expira
  1021. Vtion
  1022. X`09`09date`20should`20be`20used`20as`20the`20comparison`20date.
  1023. X
  1024. X
  1025. XRESTRICTIONS:
  1026. X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
  1027. VORE
  1028. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
  1029. X
  1030. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
  1031. V`20are`20mutually`20exclusive;`20only`20the`20last
  1032. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
  1033. V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
  1034. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
  1035. X
  1036. X`0C
  1037. XQUALIFIER:
  1038. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DLOG`5B=nnn`5D
  1039. X
  1040. X
  1041. XPURPOSE:
  1042. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specify`20that`20informational
  1043. V`20progress`20messages`20are`20to`20be
  1044. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20displayed`20at`20various`20sta
  1045. Vges`20of`20the`20packaging.`20nnn`20specifies`20the
  1046. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20level`20of`20information`20req
  1047. Vuired`20(0`20through`202).
  1048. X
  1049. X
  1050. XDEFAULT:
  1051. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOLOG`09`09`09Suppress`20all
  1052. V`20informational`20messages
  1053. X
  1054. X
  1055. XASSOCIATED`20LOGICAL`20NAME:
  1056. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_LOG
  1057. X
  1058. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
  1059. V`20be`20defined`20with`20any`20true`20or`20false`20value,
  1060. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20an`20integer`20in`20the
  1061. V`20range`200-2.`20When`20defined,`20it`20specifies`20the
  1062. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20default`20for`20all`20subseque
  1063. Vnt`20executions`20that`20do`20not`20specify`20the
  1064. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/LOG`20qualifier.
  1065. X
  1066. X
  1067. XPRIVILEGES`20Required:
  1068. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  1069. X
  1070. X
  1071. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20DESCRIPTION:`20Each`20stage
  1072. V`20in`20the`20packaging`20process,`20typically`20the
  1073. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20name`20of`20each`20file`20as
  1074. V`20it`20is`20processed,`20can`20be`20logged`20with`20an
  1075. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20informational`20message.`20The
  1076. V`20/LOG`5B=nnn`5D`20qualifier`20selects`20this
  1077. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20option.`20The`20value`20of`20n
  1078. Vnn`20is`20an`20integer`20(default`201)`20which
  1079. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20selects`20how`20much`20informa
  1080. Vtion`20is`20displayed.`20It`20may`20take`20values
  1081. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20between`200`20and`202,`20where
  1082. V`200`20is`20no`20logging`20and`202`20is`20the`20most
  1083. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20comprehensive`20logging.
  1084. X
  1085. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOLOG`20suppresses`20all`20lo
  1086. Vg`20messages;`20this`20is`20the`20same`20as
  1087. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifying`20/LOG=0
  1088. X
  1089. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/LOG=n`20selects`20logging`20a
  1090. Vt`20level`20n.
  1091. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20n=0`20turns`20all`20log`20mess
  1092. Vages`20off.
  1093. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20n=1`20displays`20a`20log`20mes
  1094. Vsage`20for`20each`20file`20processed.
  1095. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20n=2`20includes`20everything
  1096. V`20at`20n=1,`20with`20the`20addition`20of`20statistics
  1097. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20on`20the`20file`20compression
  1098. V`20before`20and`20after`20packaging.`20This`20can`20be
  1099. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20useful`20for`20determining`20t
  1100. Vhe`20effectiveness`20(or`20otherwise)`20of`20the
  1101. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20selected`20compression`20techn
  1102. Vique`20on`20a`20given`20file.
  1103. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20
  1104. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/LOG`20without`20a`20numeric
  1105. V`20value`20defaults`20to`20level`201`20logging.
  1106. X
  1107. X
  1108. XRESTRICTIONS:
  1109. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  1110. X
  1111. X
  1112. X
  1113. XEXAMPLES:
  1114. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  1115. V`20/LOG
  1116. X
  1117. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files
  1118. V`20and`20log`20each`20one`20as`20it`20is`20processed.
  1119. X
  1120. X
  1121. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  1122. V`20/LOG=2
  1123. X
  1124. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files,
  1125. V`20log`20each`20one`20as`20it`20is`20processed`20and`20show
  1126. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20compression`20statistics
  1127. V`20for`20each.
  1128. X`0C
  1129. XQUALIFIER:
  1130. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DLONGLINES
  1131. X
  1132. X
  1133. XPURPOSE:
  1134. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Allow`20VMS_SHARE`20to`20take
  1135. V`20advantage`20of`20the`20support`20for`20long
  1136. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20records`20in`20recent`20versio
  1137. Vns`20of`20VMS`20and`20TPU.
  1138. X
  1139. X
  1140. XDEFAULT:
  1141. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOLONGLINES`09`09Long`20line
  1142. V`20support`20not`20enabled
  1143. X
  1144. X
  1145. X
  1146. XASSOCIATED`20LOGICAL`20NAME:
  1147. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_LONGLINES
  1148. X
  1149. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20can
  1150. V`20be`20defined`20with`20any`20true`20or`20false`20value.
  1151. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20When`20defined,`20it`20specifi
  1152. Ves`20the`20default`20value`20for`20all`20subsequent
  1153. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20executions`20that`20do`20not
  1154. V`20specify`20the`20/LONGLINES`20qualifier.
  1155. X
  1156. X
  1157. XPRIVILEGES`20REQUIRED:
  1158. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  1159. X
  1160. X
  1161. XDESCRIPTION:
  1162. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20VMS_SHARE`20utility`20is
  1163. V`20layered`20upon`20the`20VAXTPU`20language.`20As
  1164. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20such,`20most`20of`20its`20rest
  1165. Vrictions`20are`20because`20of`20the`20limitations
  1166. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20of`20VAXTPU.`20One`20particula
  1167. Vr`20limitation`20is`20that`20of`20maximum`20record
  1168. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20length.`20Older`20versions`20o
  1169. Vf`20TPU`20(prior`20to`20VMS`205.4)`20allowed
  1170. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20records`20to`20be`20no`20longe
  1171. Vr`20than`20960`20bytes.`20This`20restricted`20the
  1172. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20maximum`20record`20length`20of
  1173. V`20the`20files`20that`20could`20be`20packaged.
  1174. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Versions`20of`20TPU`20at`20VMS
  1175. V`205.4`20and`20later`20allow`20much`20longer`20records,
  1176. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20up`20to`2065535`20bytes.
  1177. X
  1178. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20To`20maintain`20backwards`20co
  1179. Vmpatibility,`20the`20old`20record`20length`20is
  1180. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20used`20unless`20requested`20ot
  1181. Vherwise.
  1182. X
  1183. X
  1184. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/NOLONGLINES`20is`20speci
  1185. Vfied,`20then`20the`20following`20restrictions
  1186. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20apply:
  1187. X`09`09`09o`20Records`20may`20be`20no`20longer`20than`20960`20bytes
  1188. X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20run`20is`205.0
  1189. X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20unpack`20is`204.4
  1190. X
  1191. X`09`09If`20/LONGLINES`20is`20specified,`20then`20the`20following`20restriction
  1192. Vs
  1193. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20apply:
  1194. X`09`09`09o`20Records`20may`20be`20up`20to`2065535`20bytes
  1195. X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20run`20is`205.4
  1196. X`09`09`09o`20The`20minimum`20version`20of`20VMS`20to`20unpack`20is`205.4
  1197. X
  1198. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20An`20important`20use`20for`20t
  1199. Vhe`20/LONGLINES`20qualifier`20is`20to`20allow
  1200. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20BACKUP`20savesets`20to`20be
  1201. V`20directly`20packaged.`20These`20have`20a`20minimum
  1202. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20record`20length`20of`202048
  1203. V`20bytes`20so`20/LONGLINES`20is`20required.`20This
  1204. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20provides`20a`20convenient`20me
  1205. Vchanism`20for`20shipping`20VMSINSTALable
  1206. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20products,`20and`20any`20type
  1207. V`20of`20file`20(including`20INDEXED`20and
  1208. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20RELATIVE).`20
  1209. X
  1210. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20It`20is`20helpful`20to`20recog
  1211. Vnize`20when`20to`20use`20and`20when`20not`20to`20use`20the
  1212. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20long`20line`20support:
  1213. X
  1214. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20First,`20there`20is`20NO`20adv
  1215. Vantage`20if`20none`20of`20the`20files`20to`20be
  1216. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20packaged`20have`20records`20gr
  1217. Veater`20than`20960`20bytes.`20In`20fact`20this`20may
  1218. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20turn`20out`20to`20be`20detrime
  1219. Vntal`20for`20the`20recipient`20as`20we`20mention
  1220. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20below.
  1221. X
  1222. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Secondly,`20using`20it`20requi
  1223. Vres`20that`20the`20current`20version`20of`20VMS`20is
  1224. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20at`20least`205.4.`20An`20error
  1225. V`20is`20issued`20if`20not.
  1226. X
  1227. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Finally,`20the`20recipient`20o
  1228. Vf`20the`20share`20file`20will`20require`20VMS`205.4
  1229. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20or`20greater`20in`20order`20to
  1230. V`20unpack`20it`20(if`20it`20needed`20long`20line
  1231. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20support`20to`20pack`20it,`20it
  1232. +-+-+-+-+-+-+-+-  END  OF PART 8 +-+-+-+-+-+-+-+-
  1233.