home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #16 / NN_1992_16.iso / spool / comp / os / vms / 12639 < prev    next >
Encoding:
Internet Message Format  |  1992-07-22  |  5.7 KB
  1. Path: sparky!uunet!gatech!destroyer!sol.ctr.columbia.edu!zaphod.mps.ohio-state.edu!cis.ohio-state.edu!ucbvax!cdclu1.genrad.com!dongray
  2. From: dongray@cdclu1.genrad.com (Derek Dongray)
  3. Newsgroups: comp.os.vms
  4. Subject: Re: Librarian bug?
  5. Message-ID: <9207220947.AA02928@genrad.com>
  6. Date: 22 Jul 92 09:47:36 GMT
  7. Sender: daemon@ucbvax.BERKELEY.EDU
  8. Distribution: world
  9. Organization: The Internet
  10. Lines: 134
  11.  
  12. Jerry writes:
  13. >     In response to an earlier question, Arne Vajhxj writes:
  14. >     > Librarian bug or undocumented feature!?
  15. >     >
  16. >     > $ LIBRARY/INSERT text_library  help_library
  17. >     > $ LIBRARY/EXTRACT=help_library/OUTPUT=help_library.hlb  text_library
  18. >     > $
  19. >     > $ LIBRARY/LIST help_library.hlb
  20. >     > %LIBRAR-F-OPENIN, error opening RC$:[STANE]HELP_LIBRARY.HLB;1 as input
  21. >     > -LBR-E-ILLFMT, illegal library format
  22. >
  23. >     I would not call it either a bug or a undocumented feature.
  24. >
  25. > This is absolutely true.
  26. >
  27. >                                     Modules
  28. >     extracted from text-libraries end up as variable line-length files,
  29. >     while libraries themselves are fixed line-length files.
  30. >
  31. > This is true but irrelevant.
  32. >
  33. >     If you convert your extracted help_library.hlb to fixed line-length
  34. >     (with CONVERT/FDL), then it can be used again.
  35. >
  36. > This is absolutely false.
  37.  
  38. No it's quite true. It's just that Jerry assumes that the input wasn't a help
  39. library but the text form of a help library.
  40.  
  41. > A text library is a collection of arbitrary sequential files with an appro-
  42. > priate internal organization that is used by the Librarian.  If we go
  43. > through the steps above, we get:
  44. >
  45. >     ! Input:  help_library is a sequential text file, of whatever
  46. >     !        organization (most likely variable length records
  47. >     !        with carriage return carriage control, because
  48. >     !        that's what most editors create).
  49.  
  50. This is the false assumption.
  51.  
  52. >     $ LIBRARY/INSERT text_library  help_library
  53. >     ! text_library is a text library:  A sequential file with fixed-length
  54. >     !        512-byte records containing various information needed
  55. >     !        by the Librarian, and the text of help_library (per-
  56. >     !        haps in a compressed format, and perhaps other files
  57. >     !        as well).  Think of this as similar to a BACKUP save-
  58. >     !        set.
  59. >     $ LIBRARY/EXTRACT=help_library/OUTPUT=help_library.hlb  text_library
  60. >     ! The Librarian reconstructs help_library.hlb as it originally was.
  61. >     !        The .HLB file type is accepted because VMS always
  62. >     !        (well, almost always!) lets you use any file type you
  63. >     !        like, but this is NOT a text library - it's the text
  64. >     !        file you started with.  Think of this as restoring the
  65. >     !        file from the BACKUP saveset.
  66.  
  67. Wrong. It's not the file I started with. I started with a help library with
  68. fixed length 512 byte records. I now have a file with variable length records
  69. all of which happen to be 512 bytes long!
  70.  
  71. >     $ LIBRARY/LIST help_library.hlb
  72. >     %LIBRAR-F-OPENIN, error opening RC$:[STANE]HELP_LIBRARY.HLB;1 as input
  73. >     -LBR-E-ILLFMT, illegal library format
  74. >     ! Exactly what you would have gotten had you instead tried to do a
  75. >     !        LIBRARY/LIST on the original text input file.
  76.  
  77. Wrong. It wasn't a text file to start with!
  78.  
  79. >                             -- Jerry
  80.  
  81. Here's what happened when I tried what I think the original author intended.
  82.  
  83. $ libr/list sys$help:ess$ladcp.hlb
  84. Directory of HELP library SYS$COMMON:[SYSHLP]ESS$LADCP.HLB;1 on 22-JUL-1992 10:45:12
  85. Creation date:  12-OCT-1991 03:40:57      Creator:  VAX-11 Librarian V04-00
  86. Revision date:  12-OCT-1991 03:40:58      Library format:   3.0
  87. Number of modules:      5                 Max. key length:  15
  88. Other entries:          0                 Preallocated index blocks:      1
  89. Recoverable deleted blocks:      0        Total index blocks used:        1
  90. Max. Number history records:      20      Library history records:        0
  91.  
  92. BIND
  93. EXIT
  94. HELP
  95. SHOW
  96. UNBIND
  97. $ libr/create/insert/text trial.tlb sys$help:ess$ladcp.hlb
  98. $ libr/list trial.tlb
  99. Directory of TEXT library U$C:[DONGRAY.TIME]TRIAL.TLB;1 on 22-JUL-1992 10:45:40
  100. Creation date:  22-JUL-1992 10:45:34      Creator:  VAX-11 Librarian V04-00
  101. Revision date:  22-JUL-1992 10:45:34      Library format:   3.0
  102. Number of modules:      1                 Max. key length:  39
  103. Other entries:          0                 Preallocated index blocks:     11
  104. Recoverable deleted blocks:      0        Total index blocks used:        1
  105. Max. Number history records:      20      Library history records:        0
  106.  
  107. ESS$LADCP
  108. $ libr/extr=ess$ladcp/out=extract.hlb trial.tlb
  109. $ libr/list extract.hlb
  110. %LIBRAR-F-OPENIN, error opening U$C:[DONGRAY.TIME]EXTRACT.HLB;1 as input
  111. -LBR-E-ILLFMT, illegal library format
  112. $ type fixhlb.fdl
  113. FILE
  114.     ORGANIZATION            sequential
  115. RECORD
  116.     CARRIAGE_CONTROL        none
  117.     FORMAT                  fixed
  118.     SIZE                    512
  119. $ convert/fdl=fixhlb.fdl extract.hlb fixed.hlb
  120. $ libr/list fixed.hlb
  121. Directory of HELP library U$C:[DONGRAY.TIME]FIXED.HLB;1 on 22-JUL-1992 10:46:58
  122. Creation date:  12-OCT-1991 03:40:57      Creator:  VAX-11 Librarian V04-00
  123. Revision date:  12-OCT-1991 03:40:58      Library format:   3.0
  124. Number of modules:      5                 Max. key length:  15
  125. Other entries:          0                 Preallocated index blocks:      1
  126. Recoverable deleted blocks:      0        Total index blocks used:        1
  127. Max. Number history records:      20      Library history records:        0
  128.  
  129. BIND
  130. EXIT
  131. HELP
  132. SHOW
  133. UNBIND
  134.  
  135. As Arne says:
  136. >     If you convert your extracted help_library.hlb to fixed line-length
  137. >     (with CONVERT/FDL), then it can be used again.
  138.  
  139. --------------------------------------------------------------------------------
  140. Name : Derek Dongray, Systems Manager, GenRad Ltd.
  141. Phone : 061 486 1511 ext 166
  142. PSS : 234261600119::Dongray                 UKnet : Derek.Dongray@GenRad.co.uk
  143. InterNet : Dongray@cdclu1.GenRad.com        CompuServe : 70374,2745
  144. Address : Monmouth House, Monmouth Road, Cheadle Hulme, Cheshire, SK8 7AY, UK.
  145.  
  146.