HP OpenVMS Systems Documentation

Content starts here

HP DECwindows Motif
for HP OpenVMS Alpha

Installation Guide

Order Number: AA--RT26A--TE

February 2003

This manual provides step-by-step instructions for installing HP DECwindows Motif for HP OpenVMS Alpha Version 1.3.

Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2--6 for OpenVMS Installation Guide.

Operating System: 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.


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.

Contents Index


Intended Audience

This manual is intended for anyone who plans to install the HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software.

Document Structure

This manual contains the following chapters and appendixes:

  • Chapter 1 discusses how to prepare for installing DECwindows Motif software.
  • Chapter 2 discusses how to install DECwindows Motif using the POLYCENTER Software Installation utility.
  • Chapter 3 provides startup procedures. This chapter also includes a sample Installation Verification Procedure (IVP).
  • Chapter 4 discusses customizing the environment, and reporting errors.
  • Appendix A presents a sample DECwindows Motif installation using the POLYCENTER Software Installation utility on an OpenVMS Alpha Version 7.3-1 system.
  • Appendix B shows how to obtain a list of the software components for the DECwindows Motif product using the POLYCENTER Software Installation utility.

Related Documents

In addition to this manual, the following documents are useful when installing the DECwindows Motif software:

  • HP DECwindows Motif for HP OpenVMS Alpha New Features
  • HP DECwindows Motif for HP OpenVMS Alpha Release Notes
  • Guide to the HP DECwindows Motif for HP OpenVMS Alpha CD--ROM
  • Getting Started With the New Desktop
  • Managing DECwindows Motif for OpenVMS Systems
  • OpenVMS System Manager's Manual
  • OpenVMS System Management Utilities Reference Manual

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


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:



DECwindows Motif contains a graphical user interface that is derived from the Common Desktop Environment (CDE). This interface is referred to throughout this document as the New Desktop.

Unless otherwise specified, references to OpenVMS Clusters, VMSclusters, or clusters in this document are synonymous with HP OpenVMS Clusters.

All uses of DECwindows and DECwindows Motif refer to the HP DECwindows Motif for HP OpenVMS Alpha software; and all uses of X server and X display server refer to the HP DECwindows X11 Display Server. Additionally, all uses of DECwindows XUI (X User Interface) refer to the DECwindows product prior to DECwindows Motif Version 1.0.

The following conventions are also used in this manual:

Ctrl/ x A sequence such as Ctrl/ x indicates that you must hold down the key labeled Ctrl while you press another key or a pointing device button.
[Return] In examples, a key name enclosed in a box indicates that you press a key on the keyboard. (In text, a key name is not enclosed in a box.)

In the HTML version of this document, this convention appears as brackets, rather than a box.

... Horizontal ellipsis points in examples indicate one of the following possibilities:
  • Additional optional arguments in a statement have been omitted.
  • The preceding item or items can be repeated one or more times.
  • Additional parameters, values, or other information can be entered.
Vertical ellipsis points indicate the omission of items from a code example or command format; the items are omitted because they are not important to the topic being discussed.
( ) In command format descriptions, parentheses indicate that you must enclose the choices in parentheses if you choose more than one.
[ ] In command format descriptions, brackets indicate optional elements. You can choose one, none, or all of the options. (Brackets are not optional, however, in the syntax of a directory name in an OpenVMS file specification or in the syntax of a substring specification in an assignment statement.)
| In command format descriptions, vertical bars separating items inside brackets indicate that you choose one, none, or more than one of the options.
{ } In command format descriptions, braces surround a required choice of options; you must choose one of the options listed.
text style This text style represents the introduction of a new term or the name of an argument, an attribute, or a reason.

In the HTML version of this document, this convention appears as italic text.

italic text Italic text indicates important information, complete titles of manuals, or variables. Variables include information that varies in system messages (Internal error number), in command lines (/PRODUCER= name), and in command parameters in text (where dd represents the predefined code for the device type).
UPPERCASE TEXT Uppercase text indicates a command, the name of a routine, the name of a file, or the abbreviation for a system privilege.
Monospace type Monospace type indicates code examples and interactive screen displays.

In the C programming language, monospace type in text identifies the following elements: keywords, the names of independently compiled external functions and files, syntax summaries, and references to variables or identifiers introduced in an example.

- A hyphen at the end of a command format description, command line, or code line indicates that the command or statement continues on the following line.
numbers All numbers in text are assumed to be decimal unless otherwise noted. Nondecimal radixes---binary, octal, or hexadecimal---are explicitly indicated.

Chapter 1
Preparing to Install the Software

This chapter describes the preparation and requirements for installing HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software using the POLYCENTER Software Installation utility.


HP strongly recommends that you read the release notes before proceeding with the installation. The DECwindows Motif product provides online release notes. See Section 2.2 for instructions on how to access this information.

This chapter presents information about the following topics:

1.1 License Registration

Before you install and run DECwindows Motif software on a newly licensed node or cluster, you must first register a License Product Authorization Key (License PAK) using the License Management Facility (LMF). The License PAK is provided along with the kit if you ordered the license and media together; otherwise, it is provided separately to a location based on your license order.

If you are installing DECwindows Motif software as an update on a node or cluster already licensed for this software, you have already completed the License PAK registration requirements.

You must register and load your license for DECwindows Motif before you run the Installation Verification Procedure (IVP) and use the software.

To register a license, log in to the system manager account (SYSTEM). Then choose one of the following options to register the license:

  • Invoke the SYS$UPDATE:VMSLICENSE.COM procedure. When the procedure prompts you for information, respond with data from your License PAK.
  • At the DCL prompt, enter the LICENSE REGISTER command with the appropriate qualifiers that correspond to License PAK information.

If you plan to use DECwindows Motif software on more than one node in a VMScluster, load the license on the other nodes after you complete this installation.

For complete information about using LMF, see the OpenVMS License Management Utility Manual.

1.2 Supported Hardware

HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software can be installed on any supported Alpha processor. For a complete list of supported hardware, see the OpenVMS Alpha Version 7.3-1 and HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 Software Product Descriptions (SPDs).

1.3 Prerequisites for the Installation Procedures

Before you can install and configure DECwindows Motif software, you must have the required version of the OpenVMS operating system software, sufficient memory, and a license. (Refer to Section 1.1 for information about registering a License Product Authorization Key [PAK].)

Use the POLYCENTER Software Installation utility to install your DECwindows Motif software according to the following operating system information.

1.4 Required Operating System Software

The HP DECwindows Motif for HP OpenVMS Alpha Version 1.3 software requires that the OpenVMS Alpha Version 7.3-1 operating system be installed with the DECwindows support options described in Table 1-1.

If your system is not running a supported version of OpenVMS before you attempt to install DECwindows Motif, the installation fails.

A minimum of 64 MB of memory is required; at least 128 MB of memory is highly recommended.

The OpenVMS operating system provides two subsets of components to support DECwindows Motif. To use DECwindows Motif software, your system must be running a version of the OpenVMS system that includes the following components, as described in Table 1-1.

Table 1-1 DECwindows Motif Support Options for OpenVMS
Option Description
DECwindows Motif network transport and base system support This component is required to install DECwindows Motif and to run DECwindows Motif applications. During the installation of OpenVMS, you are prompted to specify whether you want to install this option.

To determine whether this option was installed during the installation of OpenVMS, check for the existence of the following file:


DECwindows X11 Display Server, fonts, and device drivers This component is necessary to display DECwindows Motif applications or any other X Window applications on your system. During the installation of OpenVMS, you are prompted to specify whether you want to install this option.

To determine whether this option was installed during the installation of OpenVMS, check for the existence of the following file:


If the DECW$SERVER_MAIN.EXE file is not on your system, you cannot display DECwindows Motif or other X Window applications on your local system 1. The DECwindows Motif installation procedure asks whether you want to continue the installation without workstation support.

1If this component is not installed locally, note that you can run DECwindows Motif applications and redirect their display to a remote system that does have the DECwindows X11 Display Server installed.


See the release notes and cover letter for the version of the OpenVMS operating system that you are running for more information about the DECwindows X11 Display Server.

1.5 OSF/Motif Release 1.1.3 and XUI Programming Support

The X Window System and OSF/Motif libraries that are provided with DECwindows Motif software are incompatible with those libraries provided with versions of DECwindows Motif prior to Version 1.2. Run-time compatibility is preserved, but the earlier OSF/Motif Release 1.1.3 and XUI programming environments are not compatible with the later OSF/MOTIF Release 1.2 programming environment.

Programming in the XUI and OSF/Motif Release 1.1.3 environments that were provided in previous versions of DECwindows Motif is no longer supported in the DECwindows Motif product. However, the installation procedure gives you the option of saving the XUI and OSF/Motif Release 1.1.3 programming files that already exist on your system. If you choose to save these programming files, they are moved to subdirectories where you can access them for programming. Specifically, the installation creates a subdirectory called [.DECW$113] in each of the directories listed in Table 1-2 and moves the previous files into the new [.DECW$113] subdirectory.

Table 1-2 Directories for Previous XUI or OSF/Motif Programming Environments
Directory Contents New Location
SYS$LIBRARY Non-C language bindings SYS$SYSROOT:[SYSLIB.DECW$113]


The process for using the saved programming environment is documented in the programmer chapter of the release notes.

1.6 Saving Customized Bookreader Files

The installation procedure replaces the following file with a new version:


If you customized this file and want to save it, copy the file to another directory or rename the file prior to the installation of DECwindows Motif software so that it is not deleted.

To copy your customized file to another directory, create the directory and define a global symbol in the file DECW$PRIVATE_APPS_SETUP.COM.

To create a Bookreader directory called SYS$COMMON:[DECW$BOOK_LOCAL], perform the following steps:

  1. Create the directory and assign world read access as follows:

  2. Copy the LIBRARY.DECW$BOOKSHELF file to the new directory as follows:


  3. If the SYS$MANAGER directory does not contain the DECW$PRIVATE_APPS_SETUP.COM command file, copy the template file to a command file as follows:

  4. Edit the DECW$PRIVATE_APPS_SETUP.COM file and define the global symbol DECW$BOOK to point to your Bookreader directory by adding the following line to the file:

  5. Restart DECwindows Motif using the following command if you performed step 4 after installing the product and after DECwindows had been started (for example, after a reboot):


For more information about customizing your DECwindows Motif environment, see Managing DECwindows Motif for OpenVMS Systems.

1.7 Installation Procedure Requirements

This section discusses the requirements for installing the DECwindows Motif software using PCSI.

The installation procedure checks the following:

  • Whether any other users are logged in to the system
  • Whether you have the minimum required system account quotas and limits
  • Whether you have the minimum required disk space
  • Whether you have the minimum required system parameter values

1.7.1 Process Account Quotas

The installation procedure requires that the installation account has the minimum quotas shown in Table 1-3.

Table 1-3 Process Quotas for the Installation Account
Quota Name Value
BYTLM 64,000
ENQLM 2,000

Use the OpenVMS AUTHORIZE utility to verify and to change process quotas for the installation account in the user authorization file (UAF). (Some sites may restrict the use of the AUTHORIZE utility to certain accounts or users.) For example, to change the BYTLM quota for the account-name installation account, enter the following commands:

UAF> SHOW account-name
UAF> MODIFY account-name /BYTLM = 64000
UAF> SHOW account-name

After you change the quotas for the installation account, log out of the installation account and log in again for the new quotas to take effect. You can then proceed with the installation.

User account quotas are stored in the file SYS$SYSTEM:SYSUAF.DAT. For more information about modifying account quotas, see the description of the AUTHORIZE utility in the OpenVMS System Management Utilities Reference Manual.

1.7.2 Disk Space

Use Table 1-4 to determine the amount of free disk space that is required on the system disk to install DECwindows Motif components. However, because you can choose not to install all the components, your actual disk space requirement may be less.

To determine the number of free blocks on the system disk, enter the following command at the DCL prompt:


The installation procedure checks for free disk space on the system disk. If sufficient space is not available, the installation procedure provides the following options:

  • Install fewer optional files.
  • Terminate the installation, create more free disk space on the system disk, and restart the installation.
  • Continue the installation and risk running out of disk space.


If you run out of free disk space during the installation, the installation procedure fails.

Table 1-4 Required Disk Space by Component (in Blocks)
Component/Subcomponent Requirement Subtotals Totals
Installation overhead: 40,000 1 40,000 40,000
Server software:      
  Server base kit 4,120 4,120  
  Euro currency support 19,880 19,880  
  Server total     24,000
LBX support: 950 950 950
Client software:      
  Client base kit 58,450 58,450  
  Desktop support      
    New Desktop 42,340    
    DECwindows desktop 7,860    
    Manual pages for
New Desktop
    Desktop subtotal   53,010  
  Programming environment      
    C, C++ 7,870    
    FORTRAN 2,060    
    Pascal 3,020    
    New Desktop 150    
    Programming subtotal   13,100  
  Example programs      
    Sound examples 1,560    
    Programming examples 10,220    
    New Desktop examples 1,250    
    Examples subtotal   13,030  
  Translated image support 28,330 28,330  
  Client total     165,920
Total for all components:     230,870

1Includes excess disk space allocation (dependent on disk cluster size), PCSI overhead, and log files. The value shown is for the combined installation of the server, LBX, and client software.

Next Contents Index