[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

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


© 2003 Hewlett-Packard Development Company, L.P.

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.

Related Documents

For additional information about OpenVMS or DECwindows Motif products and services, visit the following web site:


http://www.openvms.compaq.com

Refer to the following documents to learn about the changes and enhancements included in this release of DECwindows Motif and for instructions on installing and configuring the software:

  • HP DECwindows Motif for HP OpenVMS Alpha Cover Letter
  • 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

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:

  1. 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
    
  2. From the File menu, choose the Open File or Open Local item.
  3. 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
    
  4. 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:

  1. 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]
    
  2. 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.
  3. 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.