home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1993 #3 / NN_1993_3.iso / spool / vmsnet / sources / 499 < prev    next >
Encoding:
Internet Message Format  |  1993-01-26  |  21.9 KB
  1. Path: sparky!uunet!zaphod.mps.ohio-state.edu!sol.ctr.columbia.edu!hamblin.math.byu.edu!arizona.edu!mvb.saic.com!vmsnet-sources
  2. Newsgroups: vmsnet.sources
  3. Subject: VMS_SHARE V8.2, part 09/09
  4. Message-ID: <10312321@MVB.SAIC.COM>
  5. From: "Andy, Systems Manager" <UDAA055@ELM.CC.KCL.AC.UK>
  6. Date: Mon, 25 Jan 1993 21:35:07 GMT
  7. Followup-To: vmsnet.sources.d
  8. Approved: Mark.Berryman@Mvb.Saic.Com
  9. Lines: 532
  10.  
  11. Submitted-by: "Andy, Systems Manager" <UDAA055@ELM.CC.KCL.AC.UK>
  12. Posting-number: Volume 4, Issue 53
  13. Archive-name: vms_share/part09
  14. Supersedes: vms_share: Volume 3, Issue 87-89
  15.  
  16. -+-+-+-+-+-+-+-+ START OF PART 9 -+-+-+-+-+-+-+-+
  17. V`20will`20also`20need`20long`20line`20support`20to
  18. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unpack`20it!).`20This`20is`20t
  19. Vrue`20even`20if`20none`20of`20the`20files`20have`20lines
  20. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20longer`20than`20960.
  21. X
  22. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20
  23. X
  24. XRESTRICTIONS:
  25. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20option`20is`20only`20va
  26. Vlid`20with`20VMS`205.4`20and`20above.`20Note
  27. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20therefore`20that`20BACKUP`20sa
  28. Vvesets`20can`20only`20be`20packaged`20on`20VMS`205.4
  29. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20systems`20and`20later,`20and
  30. V`20require`20a`20similar`20system`20to`20unpack.
  31. X
  32. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20VMS_SHARE`20examines`20the`20f
  33. Vile`20header`20to`20determine`20the`20maximum
  34. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20record`20size`20in`20the`20fil
  35. Ve.`20If`20it`20exceeds`20the`20maximum`20record
  36. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20length`20supported,`20then`20t
  37. Vhe`20file`20is`20rejected.`20However,`20certain
  38. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20types`20of`20record`20structur
  39. Ve`20have`20misleading`20information`20stored
  40. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20about`20the`20maximum`20record
  41. V`20length`20(usually`20a`200`20value`20to`20indicate
  42. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unknown`20or`20no`20fixed`20ma
  43. Vximum).`20These`20files`20may`20be`20selected`20for
  44. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20packaging`20but`20subsequently
  45. V`20turn`20out`20to`20have`20records`20that`20are
  46. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20too`20long,`20giving`20errors
  47. V`20at`20either`20the`20packing`20or`20unpacking
  48. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20stages,`20depending`20on`20the
  49. V`20various`20combinations`20of`20VMS`20used.
  50. X
  51. X
  52. X
  53. XEXAMPLES:
  54. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  55. V`20/LONGLINES
  56. X
  57. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files
  58. V`20in`20the`20current`20directory,`20with`20long`20lines
  59. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20support
  60. X
  61. X`09`09$`20BACKUP/BLOCK=2048`20`5B...`5D*.*;*`20`20PACKAGE.BCK/SAVE
  62. X`09`09$`20VMS_SHARE`20PACKAGE.BCK`20PACKAGE`20/LONGLINES`20/COMPRESS
  63. X
  64. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Would`20be`20a`20means`20of
  65. V`20packaging`20a`20complete`20subdirectory`20tree
  66. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20containing`20any`20mixture`20o
  67. Vf`20files.`20
  68. X`0C
  69. XQUALIFIER:
  70. X`09`09/MODIFIED
  71. X
  72. X
  73. XPURPOSE:
  74. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Specifies`20that`20the`20last
  75. V`20modified`20date`20should`20be`20used`20for`20the
  76. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20purpose`20of`20date`20based
  77. V`20file`20selection`20on`20the`20/BEFORE`20and`20/SINCE
  78. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers
  79. X
  80. X
  81. XDEFAULT:
  82. X`09`09Use`20the`20last-modified`20date
  83. X
  84. X
  85. XASSOCIATED`20LOGICAL`20NAME:
  86. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  87. X
  88. X
  89. XPRIVILEGES`20REQUIRED:
  90. X`09`09NONE
  91. X
  92. X
  93. XDESCRIPTION:
  94. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Files`20may`20be`20selected
  95. V`20for`20packaging`20on`20the`20basis`20of`20the`20dates
  96. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20associated`20with`20the`20file
  97. V,`20using`20the`20/BEFORE`20and`20/SINCE
  98. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers.`20`20The`20/MODIFI
  99. VED`20qualifier`20says`20that`20the`20last
  100. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20modified`20date`20should`20be
  101. V`20used`20as`20the`20comparison`20date.
  102. X
  103. X
  104. XRESTRICTIONS:
  105. X`09`09The`20qualifier`20is`20ignored`20if`20neither`20the`20/SINCE`20or`20/BEF
  106. VORE
  107. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifiers`20are`20specified.
  108. X
  109. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Each`20of`20these`20qualifiers
  110. V`20are`20mutually`20exclusive;`20only`20the`20last
  111. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20one`20specified`20has`20any
  112. V`20effect`20-`20`20/BACKUP,`20/CREATED,`20/EXPIRED`20and
  113. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/MODIFIED
  114. X
  115. X`0C
  116. XQUALIFIER:
  117. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DPACKAGE_INDEX`5B=suff
  118. Vix`5D
  119. X
  120. X
  121. XPURPOSE:
  122. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Select`20the`20automatic`20cre
  123. Vation`20of`20a`20package`20index`20file`20for`20use
  124. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20by`20file`20servers.
  125. X
  126. X
  127. XDEFAULT:
  128. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/NOPACKAGE_INDEX`09No`20packag
  129. Ve`20index`20file`20is`20created
  130. X
  131. X
  132. XASSOCIATED`20LOGICAL`20NAME:
  133. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_PACKAGE_INDEX
  134. X
  135. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
  136. V`20be`20defined`20with`20any`20true/false`20value`20OR
  137. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20with`20a`20specific`20file`20t
  138. Vype`20field`20(starting`20with`20a`20dot).`20If
  139. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20defined,`20it`20specifies`20th
  140. Ve`20default`20for`20all`20subsequent`20executions
  141. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20that`20do`20not`20specify`20th
  142. Ve`20/PACKAGE_INDEX`20qualifier.
  143. X
  144. X
  145. XPRIVILEGES`20REQUIRED:
  146. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  147. X
  148. X
  149. XDESCRIPTION:
  150. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20The`20content`20of`20the`20pac
  151. Vkage`20index`20file`20is`20a`20list`20of`20the`20parts`20of
  152. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20sharefile`20containing
  153. V`20all`20the`20packaged`20files,`20one`20name`20per
  154. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20line.`20Only`20the`20name`20pa
  155. Vrt`20and`20the`20type`20part`20are`20listed.`20It`20is
  156. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20common`20to`20find`20such`20pa
  157. Vckage`20files`20on`20mail`20based`20file`20servers,
  158. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20where`20a`20number`20of`20file
  159. Vs`20may`20be`20retrieved`20by`20issuing`20a`20single
  160. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20request`20for`20the`20p
  161. Vackage.`20Each`20file`20listed`20in`20the`20package
  162. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20index`20file`20will`20be`20sen
  163. Vt`20in`20response`20to`20the`20request.
  164. X
  165. X`09`09If`20/NOPACKAGE_INDEX`20is`20specified,`20then`20no`20package`20index
  166. V`20file
  167. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20will`20be`20created.
  168. X
  169. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/PACKAGE_INDEX`20is`20spe
  170. Vcified,`20then`20a`20package`20index`20file`20will
  171. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20created.`20This`20file
  172. V`20be`20have`20the`20same`20name`20as`20the`20individual
  173. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20parts`20of`20the`20generated
  174. V`20share`20file`20but`20with`20a`20file`20type`20of
  175. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20".$PACKAGE".
  176. X
  177. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/PACKAGE_INDEX=suffix`20i
  178. Vs`20specified,`20the`20"suffix"`20string`20must
  179. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20be`20a`20file`20type.`20This
  180. V`20creates`20the`20package`20index`20file,`20as`20above,
  181. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20but`20with`20the`20specified
  182. V`20suffix`20as`20the`20file`20type.`20suffix`20must`20be
  183. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20a`20valid`20file`20type,`20inc
  184. Vluding`20the`20leading`20period`20character.
  185. X
  186. X
  187. XRESTRICTIONS:
  188. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  189. X
  190. X
  191. XEXAMPLES:
  192. X`20`20`20`09`09$`20VMS_SHARE`20*.*`20FILESERV:ZIPPO`20/PACKAGE_INDEX
  193. X
  194. X`09`09Creates`20the`20package`20files`20as`20a`20series`20of`20parts`20called
  195. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.nnn-OF-mmm`20in`20the
  196. V`20directory`20FILESERV:.`20The`20package`20index
  197. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20created`20in`20thi
  198. Vs`20directory`20too`20and`20is`20named
  199. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.$PACKAGE.
  200. X
  201. X
  202. X`20`20`20`09`09$`20VMS_SHARE`20*.*`20FILESERV:ZIPPO`20/PACKAGE_INDEX=.LIBRARY
  203. X
  204. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Creates`20the`20package`20file
  205. Vs`20as`20a`20series`20of`20parts`20called
  206. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.nnn-OF-mmm`20in`20the
  207. V`20directory`20FILESERV:.`20The`20package`20index
  208. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20file`20is`20created`20in`20thi
  209. Vs`20directory`20too`20and`20is`20named
  210. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20ZIPPO.LIBRARY
  211. X`0C
  212. XQUALIFIER:
  213. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/PART_SIZE=nnn
  214. X
  215. X
  216. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20PURPOSE:`20Define`20the`20maxi
  217. Vmum`20size`20in`20blocks`20of`20each`20part`20of`20the
  218. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20generated`20share`20file.
  219. X
  220. X
  221. XDEFAULT:
  222. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/PART_SIZE=30`09`09Part`20size
  223. V`20is`2030`20blocks
  224. X
  225. X
  226. XASSOCIATED`20LOGICAL`20NAME:
  227. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_PART_SIZE
  228. X
  229. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
  230. V`20be`20defined`20with`20a`20positive`20numeric`20value
  231. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20indicating`20the`20maximum`20s
  232. Vize`20of`20a`20part`20in`20blocks.`20If`20defined,`20it
  233. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specifies`20the`20default`20fo
  234. Vr`20all`20subsequent`20executions`20that`20do`20not
  235. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specify`20the`20/PART_SIZE`20q
  236. Vualifier.
  237. X
  238. X
  239. XPRIVILEGES`20REQUIRED:
  240. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  241. X
  242. X
  243. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20DESCRIPTION:`20Some`20mail`20s
  244. Vystems`20are`20known`20to`20truncate`20mail
  245. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20messages`20if`20they`20are`20l
  246. Varger`20than`20a`20certain`20size.`20Experience`20has
  247. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20shown`20that`20messages`20of
  248. V`2032`20blocks`20or`20less`20are`20fairly`20safe`20from
  249. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20this`20problem.`20Thus`20the
  250. V`20default`20part`20size`20is`2030`20blocks,`20allowing
  251. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`202`20blocks`20for`20the`20addit
  252. Vional`20mail`20headers`20that`20accumulate`20on`20the
  253. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20journey`20through`20the`20netw
  254. Vork.
  255. X
  256. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20it`20is`20known`20that
  257. V`20larger`20messages`20can`20pass`20unscathed,`20then
  258. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20part`20size`20can`20be
  259. V`20increased.`20using`20the`20/PART_SIZE=n
  260. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20qualifier`20(where`20n`20is
  261. V`20the`20part`20size`20in`20blocks).
  262. X`20
  263. X
  264. X
  265. XRESTRICTIONS:
  266. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Although`20there`20are`20no
  267. V`20restrictions`20on`20the`20part`20size`20that`20can`20be
  268. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20specified,`20too`20small`20a
  269. V`20value`20can`20cause`20packaging`20to`20fail.`20This
  270. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20is`20because`20certain`20parts
  271. V`20of`20the`20generated`20share`20file`20must`20be
  272. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20kept`20together`20in`20one`20f
  273. Vile.`20If`20VMS_SHARE`20is`20unable`20to`20do`20this
  274. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20because`20the`20part`20isze
  275. V`20is`20too`20small,`20an`20error`20message`20will`20be
  276. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20issued`20and`20the`20part`20si
  277. Vze`20should`20be`20increased.
  278. X
  279. X
  280. XEXAMPLES:
  281. X`09`09$`20VMS_SHARE`20*.*`20PACKAGE`20/PART_SIZE=100
  282. X`09`09
  283. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Collect`20all`20files`20in`20t
  284. Vhe`20current`20directory`20into`20a`20multi-part
  285. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20package`20called`20"PACKAGE",
  286. V`20where`20each`20part`20is`20no`20larger`20than`20100
  287. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20blocks.
  288. X`0C
  289. XQUALIFIER:
  290. X`09`09/SINCE`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`20at`20or`20after`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*.*`20Z`20/SINCE=TODAY
  389. X
  390. X`09`09This`20will`20select`20all`20files`20which`20have`20a`20modified`20date
  391. V`20(the
  392. X`09`09default)`20at`20or`20after`20today's`20date.
  393. X
  394. X
  395. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20Z`20/SIN
  396. VCE=YESTERDAY`20/BEFORE=TODAY
  397. X
  398. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20will`20select`20all`20f
  399. Viles`20which`20have`20a`20modified`20date`20(the
  400. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20default)`20sometime`20during
  401. V`20yesterday.
  402. X`0C
  403. XQUALIFIER:
  404. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/`5BNO`5DVERSION
  405. X
  406. X
  407. XPURPOSE:
  408. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Select`20the`20preservation
  409. V`20of`20version`20numbers`20across`20the`20packaging
  410. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20operation.
  411. X
  412. X
  413. XDEFAULT:
  414. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20/VERSION`09`09Version`20number
  415. Vs`20are`20preserved
  416. X
  417. X
  418. XASSOCIATED`20LOGICAL`20NAME:
  419. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20SHARE_VERSION
  420. X
  421. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20logical`20name`20may
  422. V`20be`20defined`20with`20any`20true`20or`20false`20value.
  423. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20defined,`20it`20specifies
  424. V`20the`20default`20for`20all`20subsequent
  425. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20executions`20that`20do`20not
  426. V`20specify`20the`20/VERSION`20qualifier.
  427. X
  428. X
  429. XPRIVILEGES`20Required:
  430. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  431. X
  432. X
  433. XDESCRIPTION:
  434. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Version`20numbers`20may`20be
  435. V`20preserved`20across`20the`20packaging`20operation
  436. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20if`20required.
  437. X
  438. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20If`20/NOVERSION`20is`20specifi
  439. Ved,`20version`20numbers`20are`20not`20preserved.
  440. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20During`20unpacking,`20files
  441. V`20will`20be`20created`20with`20the`20next`20highest
  442. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20available`20version`20number.
  443. V`20If`20a`20previous`20version`20already`20exists,
  444. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20a`20warning`20message`20will
  445. V`20be`20issued.
  446. X
  447. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20IF`20/VERSION`20is`20specified
  448. V,`20version`20numbers`20are`20preserved.`20During
  449. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unpacking,`20files`20will`20be
  450. V`20created`20with`20the`20same`20version`20number
  451. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20irrespective`20of`20any`20othe
  452. Vr`20versions`20that`20may`20exist.`20However,`20if
  453. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20the`20specific`20version`20num
  454. Vber`20is`20already`20in`20use,`20a`20warning
  455. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20message`20is`20issued`20and
  456. V`20the`20file`20is`20not`20re-created.
  457. X
  458. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20This`20option`20is`20supplied
  459. V`20primarily`20for`20compatibility`20with
  460. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20previous`20versions`20of`20the
  461. V`20utility`20which`20did`20not`20preserve`20version
  462. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20numbers.
  463. X
  464. X
  465. XRESTRICTIONS:
  466. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20NONE
  467. X
  468. X
  469. XEXAMPLES:
  470. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*`20PACKAGE
  471. V`20/NOVERSION
  472. X
  473. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20the`20files
  474. V`20but`20do`20not`20preserve`20the`20version`20numbers.
  475. X
  476. X
  477. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20$`20VMS_SHARE`20*.*;*`20PACKAG
  478. VE`20/VERSION
  479. X
  480. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20Package`20all`20versions`20of
  481. V`20each`20file`20in`20the`20current`20directory`20and
  482. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20preserve`20the`20version`20num
  483. Vbers`20to`20keep`20them`20distinct`20when
  484. X`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20`20unpacked.
  485. X`0C
  486. X`09`09`20`20`20`20`20`20A`20P`20P`20E`20N`20D`20I`20X`20`20`20A
  487. X
  488. X`09`09R`20E`20D`20U`20N`20D`20A`20N`20T`20`20`20F`20E`20A`20T`20U`20R`20E`20S
  489. X
  490. X
  491. XThe`20features`20described`20in`20this`20appendix`20are`20still`20available
  492. V`20but`20are`20superceded
  493. Xby`20alternative`20mechanisms.`20They`20will`20be`20withdrawn`20in`20future
  494. V`20releases`20of`20the
  495. Xutility.
  496. X
  497. X
  498. XB.1`09File`20Exclusions
  499. X
  500. XVMS_SHARE`20allows`20files`20to`20be`20excluded`20on`20the`20basis`20of`20dire
  501. Vctory,`20name,`20type,`20or
  502. Xfilename`20(Combined`20name`20and`20type).`20The`20list`20of`20items`20to`20be
  503. V`20excluded`20are`20passed
  504. Xto`20VMS_SHARE`20by`20means`20of`20logical`20names.`20Each`20logical`20name
  505. V`20contains`20a`20comma
  506. Xseparated`20list`20of`20the`20exclusions.`20Wildcards`20are`20not`20permitted
  507. V`20and`20directories
  508. Xmust`20be`20given`20in`20full.
  509. X
  510. X`20`20Logical`20Name`09`09Content`09`09`09Example
  511. X
  512. X`20`20SHARE_EXCLUDE_DIRS`09List`20of`20directories`09"`5BA.B`5D,`5BA.XYZ.C`5D"
  513. V
  514. X`20`20SHARE_EXCLUDE_NAMES`09List`20of`20names`09`09"FRED,JIM,BERT,TEST"
  515. X`20`20SHARE_EXCLUDE_TYPES`09List`20of`20types`09`09".OBJ,.EXE,.OLB"
  516. X`20`20SHARE_EXCLUDE_FILES`09List`20of`20name+types`09"Z.DAT,FILE.IDX"
  517. X
  518. XEach`20file`20matching`20the`20file`20specification`20given`20as`20a`20paramet
  519. Ver`20is`20check`20to`20see
  520. Xif`20it`20matches`20any`20of`20the`20exclusions.`20If`20so,`20it`20is`20not
  521. V`20selected.
  522. X
  523. XFor`20example:
  524. X
  525. XThe`20above`20settings`20will`20exclude`20any`20file`20in`20the`20directories
  526. V`20`5BA.B`5D`20and
  527. X`5BA.XYZ.C`5D;`20any`20file`20with`20a`20name`20of`20FRED,`20JIM,`20BERT`20or
  528. V`20TEST;`20any`20file`20with`20a
  529. Xtype`20of`20.OBJ,`20.EXE`20or`20.OLB;`20and`20any`20file`20called`20Z.DAT,`20F
  530. VILE.IDX`20in`20any
  531. Xdirectory.
  532. X
  533. XThe`20functionality`20of`20the`20above`20has`20been`20replaced`20by`20the`20/E
  534. VXCLUDE`20qualifier`20and
  535. Xthe`20SHARE_EXCLUDE`20logical`20name.`20However,`20files`20specified`20by`20th
  536. Vese`20logical`20names
  537. Xwill`20be`20added`20to`20the`20list`20specified`20by`20SHARE_EXCLUDE`20and`20w
  538. Vill`20be`20overridden`20by
  539. Xthe`20use`20of`20the`20/EXCLUDE`20qualifier.
  540. $ call unpack VMS_SHARE.USER_GUIDE;33 70361547 ""
  541. $ v=f$verify(v)
  542. $ exit
  543.