| T.R | Title | User | Personal
Name | Date | Lines |
|---|
| 429.1 | Cover Letters for VAX/AXP ODL Releases | DONVAN::PIAZZA | | Thu Mar 06 1997 16:15 | 130 |
|
DIGITAL
Online Documentation Library (ODL) New Directions
Dear Online Documentation Library Customer,
We are pleased to inform you that this release features the
Bookshelf Navigation Utility (BNU). BNU provides a seamless
interface to continue viewing Bookreader[TM] documentation,
as well as documentation in other industry-standard formats.
BNU replaces the Bookreader bookshelf, providing similar func-
tionality and giving you access to documentation on DIGITAL
products.
The goal of DIGITAL is to provide you with increasing amounts of
online documentation using state-of-the-art browser technology.
BNU provides a single interface by which you can access any of
the online books in the online documentation library, regardless
of format. We believe this strategy responds to your requests
for greater functionality, providing you with a globally com-
petitive environment that takes advantage of the latest browser
technologies.
PLEASE READ: Online Documentation Library CD-ROM User's Guide
WHY: To be able to read all of the online books, you must
install the Online Documentation Library and the Bookshelf
Navigation Utility (BNU). The User's Guide contains critical
installation information.
The User's Guide is located in the [README] directory on Disc 1
of the Online Documentation Library in the following formats:
[README]ODL_USER_GUIDE.PS (Postscript)
[README]ODL_USER_GUIDE.TXT (Text)
[README]ODL_USER_GUIDE.BKB (Bookreader)
If your environment does not meet the requirements outlined in
the User's Guide:
o For the VAX platform, instructions are provided in the
$README.TXT file located in the [README] directory which
will enable you to access the Bookreader books on the CD-ROM
by using a Bookreader hierarchy.
o For the AXP platform, we will be providing a Bookreader
hierarchy for the ODL. This saveset will be made available
shortly.
To mount a CD-ROM, use the following mount command:
$ MOUNT/SYSTEM device volume-label
For example, to mount Disc 1 in drive DKA400:
$ MOUNT/SYSTEM DKA400: VAXDOCMAR971
We look forward to your comments and feedback and encourage you
to provide any information on the new features being initiated
within the Online Documentation Library. You can send comments
via electronic mail to:
[email protected]
Please include "ODL New Directions" in the subject line of your
message to ensure that your mail is directed to the correct
person.
�Digital Equipment Corporation. 1997. All rights reserved.
___________________
[TM] Bookreader, DIGITAL, and the DIGITAL logo are trademarks of
Digital Equipment Corporation.
2
|
| 429.2 | BNU Description | DONVAN::PIAZZA | | Thu Mar 06 1997 16:17 | 64 |
|
BNU -- Bookshelf Navigation Utility
BNU is a tool for navigating hierarchical online documentation
libraries. BNU is based on Bookreader's bookshelf navigation
mechanism. Like Bookreader, BNU allows you to expand and
collapse libraries to navigate the hierarchy. However, BNU is
different from Bookreader in a number of ways:
1. BNU libraries may contain books in formats other than
Bookreader. Currently supported formats (in addition to
Bookreader) include: HTML, HyperHelp, and DynaText (Unix only).
Other formats may be added in the future.
2. BNU does not actually display the books. When a book is
"opened", BNU identifies the format from the bookshelf
entry, launches the appropriate viewer if necessary, and
passes the task to the viewer.
3. BNU does not use searchlists, logical names, or
environment variables to locate books. References in
bookshelf files are either absolute, or relative to the
directory where the bookshelf file is stored. Specific
viewers may still require logical names.
4. File specifications in bookshelf files use only ISO-9660
pathname format. File extensions are required--BNU will
not add default file extensions. Note, however, that
individual viewers may apply defaults.
5. A 'TITLE' line is required in BNU bookshelf files
(TITLE is optional in Bookreader bookshelves).
FORMATS/VIEWERS SUPPORTED
BOOKREADER
BookReader ships with DECwindows on Digital UNIX and
OpenVMS.
HTML
BNU uses Netscape to display HTML books.
Netscape is shipping with the Internet Product Suite
on OpenVMS.
Netscape is shipping with Digital UNIX 4.0 and later.
NOTE: Future versions of BNU may allow the user to
select which HTML browser to use.
HYPERHELP
BNU uses HyperHelp v5.0 from Bristol Technology Inc.
to display HyperHelp books.
DYNATEXT
BNU uses the dtext run-time browser from Electronic
Book Technologies, Inc. to display books from DynaText
collections. The DynaText format is only supported on
Digital UNIX. There is no DynaText viewer for OpenVMS.
|
| 429.3 | Internal BNU Kits are Coming | DONVAN::PIAZZA | | Thu Mar 06 1997 16:19 | 8 |
|
Please note that at the moment, the BNU kits are only available on
CD-ROM distributed through the ODL.
In the near future, we will make kits available internally which can
be copied off the network.
Janet
|
| 429.4 | | COMICS::SHELLEY | Don't get mad, get even. | Mon Mar 10 1997 12:19 | 19 |
| Hi,
A customer has just received the Mar 97 CD shipment
with BNU and is concerned as it "strongly recommends" that BNU
is not installed on earlier versions of OpenVMS than 7.1
Is this a polite way of saying its not supported below 7.1 or what ?
As 7.1 only hit the streets a few weeks ago and that 6.2 is still
fully supported, many customers will probably not be going to 7.1 for
several months yet.
What is the reasoning behind this and what is the impact of installing
BNU on 6.2 ? Will it work ok ?
Thanks
Royston
UK CSC
|
| 429.5 | | QUARK::LIONEL | Free advice is worth every cent | Mon Mar 10 1997 13:04 | 3 |
| Why are you still using the term "AXP"?
Steve
|
| 429.6 | Please clarify .4 | DONVAN::PIAZZA | | Mon Mar 10 1997 15:49 | 14 |
| Re .4
Where are you referring to that it says version 7.1 is "strongly
recommended"? Are you referring to something in the ODL User's Guide
or to something in the BNU install script? Also, please clarify what
platform you're referring to (Alpha or VMS) and whether this is for the
Online Documentation Library CD-ROM or the Enterprise Integration
Packages Documentation CD-ROM.
Thanks,
Janet
|
| 429.7 | \ | COMICS::SHELLEY | Don't get mad, get even. | Tue Mar 11 1997 06:49 | 6 |
| It is Alpha. He was referring to the Online Doc Lib CD and the
message about strongly recommended was during the installation.
Thanks
Royston
|
| 429.8 | BNU works on V6.1 | DONVAN::PIAZZA | | Tue Mar 11 1997 11:09 | 13 |
|
If the customer is installing the BNU off the SPL Online Doc CDROM,
then it should only be prompting him for OpenVMS Version 6.1 or
greater.
However, if the customer is using the Enterprise Integration Packages
Documentation CD-ROM (which also has BNU on it, that version requires
version 7).
Basically, if he doesn't have V7.0, then he should install BNU off the
SPL Doc CDROM, and it will work fine with V6.1.
Janet
|
| 429.9 | | HYDRA::SCHAFER | Mark Schafer, SPE MRO | Fri Mar 14 1997 09:14 | 6 |
| Will the BNU FAQ notes topic be turned into a Web page on the DIGITAL
server?
Mark Schafer
SPE MRO
297-3524
|
| 429.10 | FAQ Info | DONVAN::PIAZZA | | Tue Mar 18 1997 14:12 | 8 |
|
We had not planned to put it on the Digital server.
However, the FAQ is being distributed to customers in a number of ways
through the efforts of the CSC (DSNlink, Flash), as well as being sent
out in an updated cover letter to customers.
Janet
|
| 429.11 | not terribly smooth... | BEET::EAGAN | Among the fashion impaired... | Mon Mar 31 1997 17:48 | 14 |
| I just opened up my new (Mar 97) OLD and scanned the stuff
and started trying to move the .DECW$BOOK files to 'real'
disk as I've done for years.
Geeeeez. It doesn't work. All the files are gone.
Only after considerable searching do I find that there is this
new BNU 'thing'. I've not got it all figured out yet. Guess
there's not much choice.
There is *no* cover letter, or ANYTHING in the packet to indicate
that things have changed. Quite a disappointing and frustrating
way to spring things on folks. ...then again... maybe I missed
the 'heads up' in earlier OLD releases???
|
| 429.12 | Alpha platform? | DONVAN::PIAZZA | | Mon Apr 07 1997 14:10 | 15 |
|
There were announcements made in previous cover letters.
I am assuming you're on the Alpha platform. The cover letter
announcing the BNU did not get put in the correct box, so you and many
others were a bit baffled by the new BNU and files and CD-ROM.
We have since sent out a new cover letter to all existing ALpha
customers giving them additional information about the BNU and how to
get started. We've also provided them with a saveset to continue to
access the Bookreader bookshelf hierarchy in the short term.
I'll post a copy of the Alpha Cover Letter in the next reply for your
reference.
Janet
|
| 429.13 | Alpha ODL Cover Letter | DONVAN::PIAZZA | | Mon Apr 07 1997 14:14 | 522 |
|
DIGITAL
Online Documentation Library (ODL) Bookshelf Navigation Utility
(BNU) Update
AV-R5CLA-TE
IMPORTANT INFORMATION
Dear Online Documentation Library Customer,
This letter provides important information on how to access the
online information in the Online Documentation Library for Open-
VMS Alpha. Starting with this release, the Online Documentation
Library is now featuring the Bookshelf Navigation Utility (BNU).
The BNU provides an interface to allow you to access online
bookshelves and books. However, the BNU may contain books in
formats other than Bookreader. In the OpenVMS Alpha Online
Documentation Library release, for example, there are some books
in HTML format which require Netscape Navigator[TM] for viewing.
Once you have installed Netscape Navigator, the BNU will launch
it automatically when it encounters an HTML book in the Online
Documentation Library.
The goal of DIGITAL is to provide you with increasing amounts of
online documentation using state-of-the-art browser technology.
The BNU provides a single interface by which you can access
any of the online books in the Online Documentation Library,
regardless of format. We believe this strategy responds to
your requests for greater functionality, providing you with
a globally competitive environment that takes advantage of the
latest browser technologies.
Although we encourage you to install the BNU, we are also making
available a Bookreader bookshelf hierarchy for the OpenVMS Alpha
Online Documentation Library. If you need to continue to use the
Bookreader bookshelf interface while planning your BNU implemen-
tation, this saveset is provided through ECO ALPCDDOCMAR97 which
is available from:
o DIGITAL Electronic Service Delivery Tools (such as DSNlink,
Web Information and Support Service (WIS), and DIGITAL Dial-
In Access (DIA))
o the World Wide Web at:
http://www.service.digital.com/html/patch_main.html
___________________
[TM] Bookreader, DIGITAL, and the DIGITAL logo are trademarks of
Digital Equipment Corporation. Netscape Navigator is a trade-
mark of Netscape Communications Corporation.
o the following FTP address:
ftp://ftp.service.digital.com/public/vms/
If you need further information, please contact your normal
DIGITAL support channel.
The remaining information in this package about the BNU contains
the following:
o Instructions for installing Netscape Navigator for use with
the BNU
o System requirements and pointers to BNU installation informa-
tion
o Frequently Asked Questions (FAQ) about the BNU
We look forward to your comments and feedback and encourage you
to provide any information on the new features being initiated
within the Online Documentation Library. You can send comments
via electronic mail to:
[email protected]
Please include "ODL New Directions" in the subject line of your
message to ensure that your mail is directed to the correct
person.
�Digital Equipment Corporation. 1997. All rights reserved.
2
Instructions for Installing Netscape Navigator for Use with the
BNU
If you are planning to install the BNU, you should install
Netscape Navigator first in order to be able to access HTML
books available on the BNU.
The following instructions describe how to install the Netscape
Navigator to make it available on your system for use with the
Bookshelf Navigation Utility (BNU):
o If you have access to the OpenVMS Internet Product Suite
CD-ROM[1] and you want to install the Netscape Navigator
without installing any of the other products on that CD-ROM,
follow these steps:
1. Mount Version 1.1 of the OpenVMS Internet Product Suite
CD-ROM by entering the following command (where cd-device
is the device holding the CD-ROM):
$ MOUNT/OVERRIDE=ID cd-device:
2. Copy the image to SYS$SYSTEM from the ALPHA directory. The
file is located as follows on the V1.1 OpenVMS Internet
Product Suite CD-ROM:
cd-device:[INTERNET_PRODUCT_SUITE.NS_NAV_EXPORT.ALPHA]NETSCAPE-EXPORT.EXE
o If your kit does NOT include the OpenVMS Internet Product
Suite CD-ROM, follow these steps:
1. Use any available browser to access the following OpenVMS
web site:
http://www.openvms.digital.com/openvms/products/ips/nsdownload.html
2. Download the appropriate file to SYS$SYSTEM on your Alpha
system.
NOTE
o If you are running DECwindows Motif Version 1.2-3 for
OpenVMS, you must install update ALPMOTF07_U3012. This
update is provided on the OpenVMS Internet Product
Suite CD-ROM. You can check the following web site as
well:
http://www.service.digital.com:8031/
o By default, the BNU accesses the Netscape Navigator
image in SYS$SYSTEM. If you copied the file to a dif-
ferent directory, the BNU will prompt you for that
directory specification.
___________________
[1] The OpenVMS Internet Product Suite CD-ROM is included with the
OpenVMS V7.1 Operating System kit and also with the DIGITAL
Enterprise Integration Server V1.0 kit.
3
System Requirements and Pointers to BNU Installation Information
The Bookshelf Navigation Utility (BNU) has the following Operat-
ing System and layered product requirements:
o OpenVMS Version 6.1 or later
o DECwindows Motif Version 1.2-4 or DECwindows Motif Version
1.2-3 with mandatory update (MUP) ALPMOTF07_U3012 applied.
This MUP is available on the OpenVMS Internet Product Suite
CD-ROM[1].
o Netscape Navigator V2.02 or higher. Netscape Navigator re-
quires Digital TCP/IP Services for OpenVMS software (minimum
Version 3.3 or later with corresponding mandatory update) or
any TCP/IP software supporting a Berkeley socket interface.
Refer to the previous page for information on how to access
and install Netscape Navigator for use with the BNU.
NOTE
You can install the BNU without Netscape Navigator, but
the BNU will then be unable to access any HTML books. Cur-
rently, there are only a small number of books available
exclusively in HTML format on the Online Documentation
Library.
The BNU also has the following device requirements:
o A bitmap DECwindows display (a workstation or personal com-
puter using PC Xserver software, or X Terminal).
o A CD-ROM reader
The BNU requires approximately 250 blocks of disk space to be
installed on the system disk.
Instructions for Installing the BNU
Once you have installed Netscape Navigator, refer to the Online
Documentation Library CD-ROM User's Guide for detailed instruc-
tions on installing the BNU. This guide is available in the
[README] directory on Disc 1 of the Online Documentation Library
in the following formats:
[README]ODL_USER_GUIDE.PS (Postscript)
[README]ODL_USER_GUIDE.TXT (Text)
[README]ODL_USER_GUIDE.BKB (Bookreader)
In addition, be sure to read the Frequently Asked Questions
(FAQ) available in this information package.
4
Frequently Asked Questions (FAQ) About the BNU
Question:
Can Bookreader use the new bookshelf (.ODL) and book (.BKB)
files on the March 1997 OpenVMS Online Documentation Library
(ODL) CD-ROMs?
Answer:
Bookreader cannot read the bookshelf (.ODL) files, but can read
book (.BKB) files.
The new ODL CD-ROMs are designed to be used with the BNU to
present a homogeneous user interface to a heterogeneous library.
Even though the BNU's user interface looks like the familiar
Bookreader bookshelves, the file formats are different.
The .BKB files are Bookreader books, and in fact, the BNU uses
Bookreader to display them. (The BNU only displays the .ODL
files). The .BKB extension is used instead of .DECW$BOOK to
promote consistency across platforms.
For customers who cannot meet the system requirements for the
BNU, a saveset containing a Bookreader bookshelf hierarchy is
available through ECO ALPCDDOCMAR97. This library enables access
to all Bookreader books in the OpenVMS Alpha ODL. For the next
release of the ODL offering for OpenVMS Alpha, the Bookreader
bookshelf hierarchy will be made available on CD-ROM.
Question:
What are the requirements to run the BNU on my system?
Answer:
At a minimum, your system environment must include:
OpenVMS Alpha V6.1 (or later)
DECwindows Motif V1.2-3 (or later)
CD-ROM reader(s)
DECwindows display
To display HTML books, the BNU requires Netscape Navigator
V2.02 for OpenVMS. Netscape Navigator also requires DECwindows
Motif V1.2-4, or an update applied to V1.2-3 of DECwindows Motif
(ALPMOTF07_U3012 for Alpha Systems or VAXMOTF07_U3012 for VAX
systems).
Question:
Where can I find Netscape Navigator for OpenVMS?
Answer:
5
The Netscape Navigator for OpenVMS Alpha and VAX is available on
the OpenVMS Internet Product Suite (IPS) CD-ROM. The IPS CD-ROM
ships with the OpenVMS V7.1 Operating System kit. It also ships
with the DIGITAL Enterprise Integration Server (EIS) V1.0 (on
the disc labeled OVMSIPS11). The EIS CD-ROMs are included in the
March 1997 OpenVMS Alpha Layered Product Software Library. The
IPS CD-ROM may also be ordered separately from Digital.
Netscape Navigator may also be downloaded from the OpenVMS
Internet Product Suite website at:
http://www.openvms.digital.com/openvms/products/ips/
Question:
Where can I find documentation for the BNU?
Answer:
The Online Documentation Library User's Guide includes informa-
tion on installing and running the BNU. This manual is available
on Disc 1 of the Online Documentation Library in three formats:
[README]ODL_USER_GUIDE.PS Postscript
[README]ODL_USER_GUIDE.TXT Text
[README]ODL_USER_GUIDE.BKB Bookreader
Additional information on customizing the BNU and ODL will be
included in a future Online Documentation Library release.
Question:
Why do I get BOOKBROWSER license warning messages (%LICENSE-W-
...) while installing the BNU from the March ODL? What should I
do?
Answer:
The BNU installation installs or replaces the BOOKBROWSER
license. BOOKBROWSER permits access to Bookreader books for
unlicensed products.
If you only get %LICENSE-W-... messages, you may safely ig-
nore them. However, they may be followed by these Polycenter
messages:
%PCSI-E-OPFAILED, operation failed
Terminating is strongly recommended. Do you want to terminate? [YES]
In this case, you should terminate the installation. The error
is a result of having an existing BOOKBROWSER license loaded on
the system.
The workaround is to deactivate your current BOOKBROWSER li-
cense:
$ LICENSE UNLOAD BOOKBROWSER /PRODUCER=DEC
6
Then rerun SETUP.COM
This problem will be corrected in a future release of the Open-
VMS ODL.
Question:
How do I configure the BNU to read the new Online Documenta-
tion Library? Do I need to define logical names like I did for
Bookreader? If not, how does the BNU find the libraries?
Answer:
Every Online Documentation Library (ODL) shipment contains
a setup command procedure to configure the BNU to read that
library. The procedure is located at [SETUP]SETUP.COM on Disc 1
of the CD-ROM set. Each time you get a new ODL, run the setup
procedure that comes with it.
The BNU does not use logical names or search lists to find
files. The bookshelves (.ODL files) use relative pathnames for
references to files on the same CD-ROM. Bookshelf references to
files on another CD-ROM rely on X Window System resource defi-
nitions. The resources are defined by the setup procedure. One
resource is defined for each volume of the ODL. The resource
name is simply the volume label of the target CD-ROM. The re-
source value identifies the device where the CD-ROM is mounted.
We recommend the resource values be logical, rather than phys-
ical, device names. The default resource value for a CD-ROM is
the logical device name, DISK$volume_label. This name is defined
by OpenVMS when you mount the CD-ROM anywhere on the OpenVMS
system.
Question:
Can the new format Online Documentation Library CD-ROMs be
accessed over a network connection via the BNU?
Answer:
No, the BNU is designed to access local devices on the system
running the BNU. However, you can transparently mount remote
devices as local devices using one of the following mechanisms:
o TCP/IP and NFS
o DECdfs with DECnet or DECnet/OSI
o InfoServer
If you have none of the above mechanisms available, you can use
logical names to make remote devices look like local devices to
the BNU. This approach is not supported, but will allow you to
access the BNU (.ODL) bookshelves and Bookreader (.BKB) books
7
on the remote device. However, you may get errors from other
browsers such as Netscape Navigator.
Define the DISK$volume_label logical names to the remote devices
where the CD-ROMs are mounted.
For example:
$ DEFINE/SYSTEM DISK$AXPDOCMAR971 NODEB::DISK$AXPDOCMAR971:
$ DEFINE/SYSTEM DISK$AXPDOCMAR972 NODEC::DISK$AXPDOCMAR972:
Note that you do not need to know the physical device name on
the remote node.
Question:
I only have one CD-ROM reader on my system. How do I know which
products are on each CD-ROM disc of the Online Documentation
Library? Do I always need to have Disc 1 mounted?
Answer:
The CD-ROMs are divided into categories. There may be several
categories on each disc, but each category is entirely on a
single disc. The "Getting Started" category is always on Disc
1, but the other categories may be on any disc of the set. The
master index in [README]ODL_MASTER_INDEX.* on Disc 1 identifies
which disc each product is on.
You only need to have one disc mounted to get at the files on
that disc. Every disc contains a copy of the library's top-level
shelf in [000000]CONTENTS.ODL.
When you run the setup for the library, specify the default
logical volume name as the mount point for each disc (e.g.
DISK$AXPDOCMAR971, DISK$AXPDOCMAR972). Then, if you attempt
to open a shelf on another disc that is not mounted, you will
get an error message that the device does not exist. The first
component of the filespec in the message tells you the device
name (e.g. DISK$AXPDOCMAR972) you specified when you setup the
library. You can then mount that disc (Disc 2 in this example)
and proceed.
8
|
| 429.14 | skip the CD stuff... | BEET::EAGAN | Among the fashion impaired... | Tue Apr 08 1997 17:41 | 14 |
| Thanks for posting the letter!
More questions (I've read the FAQ). Maybe you can save me some
time???
I want to move both CDs' worth of ODL files to hard-disk. I don't
want to be swapping CDs around.
Is there a recommended procedure to do this? Are there logicals
to set? Do I need to modify CONTENTS.ODL to change the %AXPDOCMAR971
to something else?
Thanks
|
| 429.15 | copying to hard disk | DONVAN::KRAETSCH | | Wed Apr 09 1997 18:08 | 7 |
| The easiest way is to copy the entire CD-ROM hard disk preserving the
directory structure. If you copy it to the top-level directory of the
disk, you should be able to run [SETUP]SETUP.COM and you will be all set.
You can copy both CD-ROMs to the same hard drive since the directory names
are unique and the .ODL files in [000000] are identical on both disks.
Just answer with the same device name when SETUP asks where each disk will
be mounted.
|