HP OpenVMS Systems Documentation

Guide to the HP DECwindows Motif
for HP OpenVMS Alpha CD-ROM

Order Number: AA--RT27A--TE

February 2003

This guide lists the contents of the HP DECwindows Motif for
HP OpenVMS Alpha Version 1.3 CD-ROM.

Revision/Update Information: This is a revised manual.

Operating System Version: HP OpenVMS Alpha Version 7.3--1

Software Version: HP DECwindows Motif for
HP OpenVMS Alpha Version 1.3

Hewlett-Packard Company
Palo Alto, California

Motif, OSF/1, UNIX, and the "X" device are registered trademarks and The Open Group is a trademark of The Open Group in the U.S. and other countries.

Confidential computer software. Valid license from HP and/or its subsidiaries required for possession, use, or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.

Neither HP nor any of its subsidiaries shall be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for HP products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty.

ZK6474

The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 documentation set is available on CD-ROM.

This document was prepared using VAX DOCUMENT, Version V3.2n.

Preface

This guide contains information about the contents of the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 (DECwindows Motif) CD-ROM.

Reader's Comments

HP welcomes your comments on this manual. Please send comments to either of the following addresses:

Internet	openvmsdoc@hp.com
Mail	Hewlett-Packard Company OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698

How To Order Additional Documentation

For information about how to order additional documentation, visit the following World Wide Web address:

http://www.openvms.compaq.com/doc/

Chapter 1
The HP DECwindows Motif for HP OpenVMS Alpha CD-ROM

This guide lists the contents of the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 CD-ROM and describes how to access the product installation instructions and reference documentation.

1.1 Contents of this CD-ROM

The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 CD-ROM contains the following:

DECwindows Motif software kits
DECwindows Motif documentation
New Desktop documentation

1.2 Handling the CD-ROM

The CD-ROM accompanying this guide is enclosed in an antistatic envelope. For instructions on how to insert the CD-ROM into the disc drive, see the associated owner's manual.

1.3 Directories on this CD-ROM

The CD-ROM contains binary files for the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 product. You can install this product by using the POLYCENTER Software Installation utility (PCSI).

Table 1-1 lists the contents of each directory on the CD-ROM.

**Table 1-1 DECwindows Motif Version 1.3 CD-ROM Directory Structure**
Directory Name	Contents
[PCSI_ALPHA_DWMOTIF13]	DECwindows Motif Version 1.3 media kit. Install using PCSI on systems running OpenVMS Alpha Version 7.3--1 only.
[DOCUMENTATION]	Contains PostScript and ASCII text files for for the DECwindows Motif Version 1.3 release documentation. Product release documentation includes the Software Product Description (SPD), new features manual, release notes, documentation overview, installation guide, and cover letter.
[DOCUMENTATION.DECW$BOOK]	Contains Bookreader files from the DECwindows Motif for OpenVMS Version 1.2--4 documentation set and select DECwindows Motif manuals.
[DOCUMENTATION.HTML]	Contains HTML files for the DECwindows Motif Version 1.3 release documentation, and New Desktop (Common Desktop Environment) documentation.

See the HP DECwindows Motif for HP OpenVMS Alpha Installation Guide for specific installation instructions.

1.4 Accessing the Documentation on the CD-ROM

The following sections describe how to access the product documentation included on this CD-ROM. Note that Portable Document Format (PDF) and HTML versions of select DECwindows Motif manuals are also available online from the OpenVMS Alpha documentation web site:

http://www.openvms.compaq.com/doc/

1.4.1 Printing PostScript or ASCII Text Documentation

The following DECwindows Motif documentation is provided in ASCII text and PostScript formats:

Guide to the HP DECwindows Motif for HP OpenVMS Alpha CD--ROM
HP DECwindows Motif for HP OpenVMS Alpha Cover Letter
HP DECwindows Motif for HP OpenVMS Alpha Software Product Description
HP DECwindows Motif for HP OpenVMS Alpha Documentation Overview
HP DECwindows Motif for HP OpenVMS Alpha New Features
HP DECwindows Motif for HP OpenVMS Alpha Release Notes
HP DECwindows Motif for HP OpenVMS Alpha Installation Guide

To print the PostScript or ASCII text documentation, mount the CD-ROM and enter the appropriate PRINT command, as follows:

$ MOUNT/OVERRIDE=ID device-name:
$ PRINT device-name:[DOCUMENTATION]filename.PS
$ DISMOUNT device-name:

where:

device-name is the name of the drive on which you have placed the CD-ROM, and filename is the name of the file you want to print.

For example:

$ MOUNT/OVERRIDE=ID DKB700:
$ PRINT DKB700:[DOCUMENTATION]DW_V13_INSTAL_GD.PS
$ DISMOUNT DKB700:

1.4.2 Viewing HTML Documentation

The following DECwindows Motif documentation is provided in HTML format:

Guide to the HP DECwindows Motif for HP OpenVMS Alpha CD--ROM
HP DECwindows Motif for HP OpenVMS Alpha Documentation Overview
HP DECwindows Motif for HP OpenVMS Alpha Release Notes
HP DECwindows Motif for HP OpenVMS Alpha New Features
HP DECwindows Motif for HP OpenVMS Alpha Installation Guide
Getting Started With the New Desktop
Common Desktop Environment: User's Guide
Common Desktop Environment: Advanced User's and System Administrator's Guide
Common Desktop Environment: Help System Author's and Programmer's Guide
Common Desktop Environment: Programmer's Overview
Common Desktop Environment: Programmer's Guide
Common Desktop Environment: Style Guide and Certification Checklist
Common Desktop Environment: Internationalization Programmer's Guide
Common Desktop Environment: Glossary

View the HTML files on the CD-ROM, as follows:

Invoke the web browser currently installed on your system. If one is not installed, visit the following web site to download and install the Compaq Secure Web Browser for OpenVMS:
http://www.openvms.compaq.com/openvms/products/ips/cswb/cswb.html
From the File menu, choose the Open File or Open Local item.
In the selection field, enter the following file specification:
device-name:[DOCUMENTATION.HTML]INDEX.HTML
where:
device-name is the name of the drive on which you have placed the CD-ROM.
For example:
DKB700:[DOCUMENTATION.HTML]INDEX.HTML
The set of titles is displayed; click on the title of the manual that you want to open.

1.4.3 Viewing Bookreader Documentation

The following documentation is provided in Bookreader format:

Using DECwindows Motif for OpenVMS
DECwindows Motif for OpenVMS Applications Guide
Managing DECwindows Motif for OpenVMS Systems
DECwindows Companion to the OSF/Motif Style Guide
DECwindows Extensions to Motif
VMS DECwindows Guide to Application Programming
DECwindows Motif for OpenVMS Guide to Non-C Bindings
Porting XUI Applications to Motif
VMS DECwindows Guide to Xlib (Release 4) Programming: MIT C Binding
VMS DECwindows Guide to Xlib (Release 4) Programming: VAX Binding

If you have a workstation and have installed the DECwindows Motif software, you can view the manuals in Bookreader format with DECwindows Bookreader.

During installation or upgrade, the DECwindows Motif software automatically creates a library directory for Bookreader on your system disk and defines the logical name DECW$BOOK to refer to this directory. When you start Bookreader, it looks for the library file in the directory defined by DECW$BOOK.

View the Bookreader files on the CD-ROM, as follows:

Enter the following DCL command:
$ DEFINE DECW$BOOK device-name:[DOCUMENTATION.DECW$BOOK]
where:
device-name is the name of the drive on which you have mounted the CD-ROM.
For example:
$ DEFINE DECW$BOOK DKB700:[DOCUMENTATION.DECW$BOOK]
Define the DECW$BOOKSHELF logical to point to the appropriate LIBRARY.DECW$BOOKSHELF. Use the following command to define DECW$BOOKSHELF:
$ DEFINE DECW$BOOKSHELF device-name:[DOCUMENTATION.DECW$BOOK]- _$ LIBRARY.DECW$BOOKSHELF
where:
device-name is the name of the drive on which you have placed the CD-ROM.
For example:
$ DEFINE DECW$BOOKSHELF - _$ DKB700:[DOCUMENTATION.DECW$BOOK]LIBRARY.DECW$BOOKSHELF
You can also copy the DECW$BOOK files from the CD-ROM to another location on your system. Always remember to define the DECW$BOOK and the DECW$BOOKSHELF logical names to point to the location of the files you want to read.
Start Bookreader by choosing Bookreader from the Session Manager Applications menu. You can also start Bookreader with the following command:
$ RUN SYS$SYSTEM:DECW$BOOKREADER
On Alpha systems running the New Desktop, start Bookreader by clicking on the Bookreader icon in Application Manager's DECwindows Apps group.
For more information about Bookreader, see the DECwindows Motif for OpenVMS Applications Guide.

Note

If you want to provide systemwide definitions for the DECW$BOOK and DECW$BOOKSHELF logical names (that is, for all users on the system), you need the SYSNAM privilege.

1.5 Locating Installation Instructions

The installation instructions for the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software are available in the HP DECwindows Motif for HP OpenVMS Alpha Installation Guide.

HP strongly suggests that you read the installation instructions prior to installing the DECwindows Motif software.