From: carl@SOL1.GPS.CALTECH.EDU (Carl J Lydick)
Newsgroups: comp.os.vms
Subject: Re: Librarian bug?
Date: 22 Jul 92 00:21:25 GMT
Reply-To: carl@SOL1.GPS.CALTECH.EDU
Organization: HST Wide Field/Planetary Camera

In article <9207201955.AA13531@uu3.psi.com>, leichter@lrw.com (JERRY LEICHTER) writes:
>
>	In response to an earlier question, Arne Vajhxj writes:
>	> Librarian bug or undocumented feature!?
>	> 
>	> $ LIBRARY/INSERT text_library  help_library
>	> $ LIBRARY/EXTRACT=help_library/OUTPUT=help_library.hlb  text_library
>	> $
>	> $ LIBRARY/LIST help_library.hlb
>	> %LIBRAR-F-OPENIN, error opening RC$:[STANE]HELP_LIBRARY.HLB;1 as input
>	> -LBR-E-ILLFMT, illegal library format
>
>	I would not call it either a bug or a undocumented feature.
>
>This is absolutely true.
>
>								    Modules
>	extracted from text-libraries end up as variable line-length files,
>	while libraries themselves are fixed line-length files.
>
>This is true but irrelevant.
>
>	If you convert your extracted help_library.hlb to fixed line-length
>	(with CONVERT/FDL), then it can be used again.
>
>This is absolutely false.
>
>A text library is a collection of arbitrary sequential files with an appro-
>priate internal organization that is used by the Librarian.  If we go
>through the steps above, we get:
>
>	! Input:  help_library is a sequential text file, of whatever
>	!		organization (most likely variable length records
>	!		with carriage return carriage control, because
>	!		that's what most editors create).
>
>	$ LIBRARY/INSERT text_library  help_library
>	! text_library is a text library:  A sequential file with fixed-length
>	!		512-byte records containing various information needed
>	!		by the Librarian, and the text of help_library (per-
>	!		haps in a compressed format, and perhaps other files
>	!		as well).  Think of this as similar to a BACKUP save-
>	!		set.
>
>	$ LIBRARY/EXTRACT=help_library/OUTPUT=help_library.hlb  text_library
>	! The Librarian reconstructs help_library.hlb as it originally was.
>	!		The .HLB file type is accepted because VMS always
>	!		(well, almost always!) lets you use any file type you
>	!		like, but this is NOT a text library - it's the text
>	!		file you started with.  Think of this as restoring the
>	!		file from the BACKUP saveset.
>
>	$ LIBRARY/LIST help_library.hlb
>	%LIBRAR-F-OPENIN, error opening RC$:[STANE]HELP_LIBRARY.HLB;1 as input
>	-LBR-E-ILLFMT, illegal library format
>	! Exactly what you would have gotten had you instead tried to do a
>	!		LIBRARY/LIST on the original text input file.

I didn't see the original item in this thread, but it looks to me like Arne's
right:

$	SET NOON
$	LIBRARY/HELP/EXTRACT=ALLOCATE/OUTPUT=ALLOCATE.HLP SYS$HELP:HELPLIB
$	LIBRARY/CREATE/HELP ALLOCATE ALLOCATE
$	LIBRARY/CREATE/TEXT ALLOCATE ALLOCATE.HLB
$	DELETE ALLOCATE.HLB;
$	LIBRARY/TEXT/EXTRACT=ALLOCATE/OUT=ALLOCATE.HLB ALLOCATE
$	LIBRARY/LIST/HELP ALLOCATE
%LIBRAR-F-OPENIN, error opening $1$DIA0:[CARL]ALLOCATE.HLB;1 as input
-LBR-E-ILLFMT, illegal library format
$	CONVERT/FDL=SYS$INPUT: ALLOCATE.HLB ALLOCATE.HLB
RECORD
	FORMAT			FIXED
	SIZE			512
	CARRIAGE_CONTROL	NONE
$	LIBRARY/LIST/HELP ALLOCATE
Directory of HELP library $1$DIA0:[CARL]ALLOCATE.HLB;2 on 21-JUL-1992 16:16:32
Creation date:  21-JUL-1992 16:16:27      Creator:  VAX-11 Librarian V04-00
Revision date:  21-JUL-1992 16:16:27      Library format:   3.0
Number of modules:      1                 Max. key length:  15
Other entries:          0                 Preallocated index blocks:      5
Recoverable deleted blocks:      0        Total index blocks used:        1
Max. Number history records:      20      Library history records:        0

ALLOCATE
$	LIBRARY/HELP/EXTRACT=ALLOCATE/OUT=ALLOCATE.HLP ALLOCATE
$	DIFF ALLOCATE.HLP
Number of difference sections found: 0
Number of difference records found: 0

DIFFERENCES /IGNORE=()/MERGED=1-
    $1$DIA0:[CARL]ALLOCATE.HLP;2-
    $1$DIA0:[CARL]ALLOCATE.HLP;1

--------------------------------------------------------------------------------
Carl J Lydick | INTERnet: CARL@SOL1.GPS.CALTECH.EDU | NSI/HEPnet: SOL1::CARL

Disclaimer:  Hey, I understand VAXen and VMS.  That's what I get paid for.  My
understanding of astronomy is purely at the amateur level (or below).  So
unless what I'm saying is directly related to VAX/VMS, don't hold me or my
organization responsible for it.  If it IS related to VAX/VMS, you can try to
hold me responsible for it, but my organization had nothing to do with it.