How do I install the Bookreader files after Diskeeper has been reinstalled?
Diskeeper V7.1 includes on-line documentation in Bookreader format. Bookreader is compatible with DECwindows and DECwindows Motif.
Installing the Bookreader Files
To install the Diskeeper Bookreader files after Diskeeper has been installed, follow these steps:
Physically mount the distribution tape or disk containing the Diskeeper savesets. MSA0 is the name of the tape device used in this example.
$ MOUNT /FOREIGN MSA0:
Next, enter the following command, where
device
is the device and [
directory
] is the directory where you want to install the Diskeeper Bookreader files.
$ BACKUP MSAO:DISKEEPER070.H -_$
device
:[
directory
]
After a short period, the DCL prompt re-appears. Now dismount the distribution tape or disk:
$ DISMOUNT MSA0:
Defining the DECW$1300K Logical Name
Digital uses the logical name DECW$BOOK to point to directories where Bookreader files reside. The logical name DECW$BOOK may point to more than one location (including CD readers). The Diskeeper Bookreader files are installed in the directory where the Diskeeper files reside, and the DECW$BOOK logical name must be redefined to point to this directory.
A file named LIBRARY.DECW$BOOKSHELF is included with the Diskeeper Bookreader files. This file contains information necessary for the Bookreader utility to open the Diskeeper Bookreader books. Typically, the DECW$BOOK logical name points to any directory containing a LIBRARY. DECW$BOOKSHELF file. On some systems, there may be several files with this name located in different directories on different devices.
To access the Bookreader files, it is necessary to ensure that the DECW$BOOK logical name points to the location of the Diskeeper Bookreader files, as well as the location of the other Bookreader files on your system.
When OpenVMS DECwindows is installed, the DECW$BOOK logical is defined to refer to the SYS$COMMON:[DECW$BOOK] directory. When you invoke Bookreader, it translates DECW$BOOK and displays the books that reside in the SYS$COMMON: [DECW$BOOK] directory. You can redefine the DECW$BOOK logical to read additional directories (such as the OpenVMS Online Documentation Library CD).
To redefine the DECW$BOOK logical to also read books located in the directory where the Diskeeper Bookreader files reside, follow these steps:
Determine the devices and directories that are pointed to by the DECW$BOOK logical name by entering this command from the DCL command line:
$ SHOW LOGICAL DECW$BOOK
A listing similar to this will be displayed:
"DECW$BOOK" = "BOOT$DKB400: [DECW$BOOK] " (LNM$SYSTEM-TABLE)= "SYS$COMMON:[DECW$BOOK]""DECW$BOOK" = "SYS$COMMON: [DECW$BOOK] " (DECW$LOGICAL-NAMES)
In the example above, BOOT$ DKB400:[DECW$BOOK] represents a CD reader, and SYS$COMMON:[DECW$BOOK] represents a directory on the system disk.
Redefine the DECW$BOOK logical name to include not only the CD reader and the system disk directory, but also the device and directory where the Diskeeper Bookreader files reside. In this example, device and [directory] represent the location you specified for the Diskeeper Bookreader files during installation. By default, this is SYS$SYSDEVICE:[ESICM.Diskeeper]:
$ DEFINE/SYSTEM DECW$BOOK SYS$COMMON:[DECW$BOOK], -_$ BOOT$DKB400:[DECW$BOOK], -_$
device
:[
directory
]
Also include this command in your SYSTARTUP command procedure to ensure that the DECW$BOOK logical name is properly defined each time your system is re-started.
Invoke Bookreader to display all the books available in the SYS$COMMON:[DECW$BOOK] directory, the CD reader, and the Diskeeper Bookreader files directory.
Refer to Digital's
Using Bookreader
for information about using Bookreader on-line documentation.
If this FAQ helped, please let us know. If you didn't find the answer to your question here please e-mail
|