SUMMARY: ODL for Tru64 and OpenVMS on same PC

From: Tom Linden (tom@kednos.com)
Date: Thu Jul 18 2002 - 10:27:26 EDT


Some months ago I posted a query about installing the Online
Documentation Library on a W2K box. The problem was that when
I installed the Tru64 documentation after having installed the
same for OpenVM, it overwrote it, because of a name clash.

I have finally received a work-around from HP and it follows.
This also may be useful to put into the OpenVMS FAQ. The following is
courtesy of Frank Klum.

1 - Load VMS ODL using SETUP.EXE (D:\VMS ODL)

2 - Use Copy ODL utility to copy VMS ODL books to hard disk
(D:\VMS_ODL_data)

When prompted for the destination directory, enter the name of a directory.
It will
create this directory, or ask you to overwrite it, if it exists.

3 - Manually copy Unix ODL docs to hard disk (D:\UNIX_ODL_data\disk1)

Create the directory D:\Unix_ODL_data\disk1 then copy the two folders (avscd
and
U01Q1) over. The U01Q1 folder takes a few minutes since it contains all the
ODL books.

4A - Edit Registry

HKEY_LOCAL_MACHINE -> Software -> Compaq ODL -> Online Documentation Library
Edit the String Value ODL_lib to point to the file 'odl_lib.bnu' instead of
'odl_lib.qnu'

4B - Edit Registry some more

HKEY_LOCAL_MACHINE -> Software -> Compaq ODL -> Online Documentation
Library -> Releases
Add a Key (folder) named U01Q1

Inside U01Q1 create a String Value like this:
U01Q1_1 [REG_SZ] D:\Unix_ODL_data\disk1\U01Q1\U01Q1_1

5 - Edit the D:\VMS ODL\Releases\AXPDOCMAR01\odl_lib.bnu file and add this
line:

 SHELF %U01Q1_1/contents.odl Tru64 Unix, January 2001

%U01Q1_1 will translate to the Registry entry made in step 4B, so the file
name listed
here can really be anything, but it has to exist in that directory. The
string
following the file name ('Tru64 Unix, January 2001') can also be anything
you please,
but it will show up in BNU as the name of the bookshelf.

You will note that in the odl_lib.bnu file there is a line for the OpenVMS
file and it
has two %'s in front of it. Leave it that way and only use one % for the
line you are
adding here.

6 - Edit the D:\Unix_ODL_data\disk1\U01Q1\U01Q1_1\contents.odl

First thing to do is remove the Read-only attribute on this file, or you
will not be
able to save any changes. Right click on the file and go to Properties.
Click off
the 'Read-only' check box and click 'OK'.

Each of the 'shelf' lines, except the first one for 'prodlist.odl', has a
reference to
%1 which points to the directory for the filename that follows. Since the
installed
version of ODL is the OpenVMS one, it translates this %1 to be AXPDOCMAR01_1
(and if it
found a %2, it would go to AXPDOCMAR01_2.) Since all our Tru64 Unix
documentation is
in another directory, we need to change this pointer.

Simply replace all the '%1' instances with '%U01Q1_1', like this:

Original entry:
        shelf %1/odldoc/odldoc.odl Getting Started
New entry:
        shelf %U01Q1_1/odldoc/odldoc.odl Getting Started

---
Outgoing mail is certified Virus Free.
Checked by AVG anti-virus system (http://www.grisoft.com).
Version: 6.0.373 / Virus Database: 208 - Release Date: 7/1/2002


This archive was generated by hypermail 2.1.7 : Sat Apr 12 2008 - 10:48:46 EDT