/* acf4:comp.os.vms / system@fallout.uucp /  7:13 pm  Sep 26, 1990 */
> I have a copy of the VAX Documentation Bookreader CD on loan from
> DEC and it's great. I hope I can talk my manager into springing the
> cash to get it for good.
> 
> My question is this. We have a VS3600 in our computer room which I
> have the VAXcluster Console System running on. (btw, the DECwindows
> interface with V1.3 of VCS is really neat, too) This WS is naturally
> used mostly by operators. One thing operators consult on a regular
> basis is operations procedures manuals. So I thought, wouldn't it
> be neat to have the operations procedures on line in bookreader format
> so the operators can call them up on the WS? After all, the bookreader
> software is included with DECwindows. Only I don't know how to set
> up the manuals in such a manner that the bookreader can access
> them.
...
>
> Zack C. Sessions
> Sessions@Sparev.dnet.ge.com (Internet)
> Sessions%Sparev.dnet.ge.com@crdgw1.ge.com (Alternate Internet)
> ...!uflorida!ki4pv!macs!stetson!rewop!sencland!sessions (UUCP at home)


Zack,

The main pointer is a logical DECW$BOOK:

If you define this pointer in SYS$STARTUP:DECW$STARTAPPS.COM
and it points at a location on your system or network (if you access
books over DECnet it's slower than over DFS or an LAVC connect.

The system for bookreader is as follows

LIBRARY.DECW$BOOKSHELF  -- MAIN LISTINGS OF DECW$BOOKSHELFS
  shelf.DECW$BOOKSHELF  -- BOOKS ON A RELATED TOPIC
   book.DECW$BOOK       -- The actual book in book reader format

LIBRARY.DECW$BOOKSHELF is a special file that BOOKREADER is looking
for.  All other shelfs and books can be called to from this file.

here is the first several lines of my LIBRARY.DECW$BOOKSHELF:
SHELF\BOOKREADER_INFO.DECW$BOOKSHELF\Using the Bookreader
SHELF\sys$common:[decw$book.bible]library.decw$bookshelf\King James Bible
SHELF\vms.decw$bookshelf\VMS Operating System
SHELF\DW4125_DOC.DECW$BOOKSHELF\DECwindows Tektronix 4125 Terminal Emulator
BOOK\VMS_V54_UPG_INST_PROC_EFT.DECW$BOOK\VMS 5.4 install guide
BOOK\AA-NY13A-TE.DECW$BOOK\VAX Disk Striping Driver for VMS Guide to Operations
BOOK\VPA_V21_MANUAL.DECW$BOOK\VAX Performance Advisor V2.1 Manual
...


Bookshelfs can either contain books or other bookshelves.

When I get a new CDrom I copy the LIBRARY.DECW$BOOKSHELF into my 
SYS$COMMON:[DECW$BOOK] and include it in a writeable copy of the file.

Then I define a search list that includes this directory and the CDrom
and modify DECW$STARTAPPS.COM 


okfine

$ !
$ ! DECW$STARTAPPS.COM - Initialize the DECwindows user environment
$ !
$ !****************************************************************************
$ !*									      *
$ !*  COPYRIGHT (c) 1987, 1989 BY					      *
$ !*  DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASSACHUSETTS.		      *
$ !*  ALL RIGHTS RESERVED.						      *
$ !* 									      *
$ decw$define decw$book		sys$common:[decw$book],dkb400:[decw$book]
$ decw$define vue$library	decw$syscommon:[vue$library.user],-
				decw$syscommon:[vue$library.system]


This lets me have books or older books/shelves I've taken from other 
CDs and put them on disk for use!


Multiple LIBRARY.DECW$BOOKSHELFs in the search list wrap in the bookreader
choice menu, so, if you have one LIBRARY.DECW$BOOKSHELF in the 
first searchlist member, and then use the existing one on the CDrom,
you can have custom and standard books/shelf for your system.

Hope this helps!

Be seeing you,

+-----------------+--------------------------------------------------------+
| John Wisniewski |         Consultant/DFW DECUS LUG Counterpart           |
| +-+-+-+-+-+-+-+ | Internet: montagar!fallout!wisniewski@egsner.cirr.com  |
| |d|i|g|i|t|a|l| |    UUCP:  ...utacfd!egsner!montagar!fallout!wisniewski | 
| +-+-+-+-+-+-+-+ | At Work:  wisniewski@dpdmai.enet.dec.com               |
| Dallas, TX  USA |                                                        |
+-----------------+--------------------------------------------------------+
/* ---------- */