Order Number: AA--Q1EAD--TE
This manual provides step-by-step instructions for installing DECwindows Motif Version 1.2-5 for OpenVMS.
Revision/Update Information: This manual supersedes the DECwindows Motif Version 1.2-4 for OpenVMS Installation Guide.
Operating System:
OpenVMS Alpha Version 6.2, 7.1
VMS Version 5.5-2
Software Version:
DECwindows Motif Version 1.2-5 for OpenVMS Alpha
DECwindows Motif Version 1.2-5 for OpenVMS VAX
Compaq Computer Corporation Houston, Texas
Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description.
Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor.
Compaq conducts its business in a manner that conserves the environment and protects the safety and health of its employees, customers, and the community.
© Compaq Computer Corporation 1998. All rights reserved.
The following are trademarks of Compaq Computer Corporation: Alpha, Compaq, DECdirect, DECwindows, DIGITAL, OpenVMS, VAX, VAX DOCUMENT, VAXcluster, VMS, and the Compaq logo.
The following are third-party trademarks:
Ada is a registered trademark of the United States government.
Adobe, Adobe Illustrator, Display POSTSCRIPT, and POSTSCRIPT are registered trademarks of Adobe Systems Incorporated.
Compaq is a registered trademark of Compaq Computer Corporation.
Motif, OSF, OSF/1, OSF/Motif, and Open Software Foundation are registered trademarks of the Open Software Foundation, Inc.
NCSA Mosaic and Mosaic are trademarks of the University of Illinois at Urbana--Champaign.
X Window System is a trademark of the Massachusetts Institute of Technology.
Windows is a trademark, and Windows NT, NT, and Microsoft are registered trademarks of Microsoft Corporation.
All other trademarks and registered trademarks are the property of their respective holders.
ZK6538
The DIGITAL OpenVMS documentation set is available on CD-ROM.
This document was prepared using VAX DOCUMENT, Version V3.2n.
| Contents | Index |
This manual is intended for anyone who plans to install DECwindows Motif Version 1.2-5 for OpenVMS software.
This manual contains the following chapters and appendixes:
In addition to this manual, the following documents are useful when installing DECwindows Motif Version 1.2-5 for OpenVMS software:
For additional information on the Open Systems Software Group (OSSG) products and services, access the following OpenVMS World Wide Web address:
http://www.openvms.digital.com |
Compaq welcomes your comments on this manual.
Print or edit the online form SYS$HELP:OPENVMSDOC_COMMENTS.TXT and send us your comments by:
| Internet | openvmsdoc@zko.mts.dec.com |
| Fax | 603 884-0120, Attention: OSSG Documentation, ZKO3-4/U08 |
|
Compaq Computer Corporation
OSSG Documentation Group, ZKO3-4/U08 110 Spit Brook Rd. Nashua, NH 03062-2698 |
Use the following World Wide Web address to order additional documentation:
http://www.openvms.digital.com:81/ |
If you need help deciding which documentation best meets your needs, call 800-DIGITAL (800-344-4825).
DECwindows Motif Version 1.2-5 for OpenVMS Alpha 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.
VMScluster systems are now referred to as OpenVMS Cluster systems. Unless otherwise specified, references to OpenVMS Clusters or clusters in this document are synonymous with VMSclusters.
In this manual, every use of DECwindows and DECwindows Motif refers to DECwindows Motif for OpenVMS software.
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:
|
|
.
. . |
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. |
This chapter describes the preparation and requirements for installing DECwindows Motif Version 1.2-5 for OpenVMS software using either the POLYCENTER Software Installation utility or the VMSINSTAL procedure. Your Bill of Materials (BOM) specifies the number and contents of your media. Verify the contents of your kit with this information. If your kit is damaged or if you find that parts are missing, contact your Compaq representative.
Compaq strongly recommends that you read the release notes before proceeding with the installation. The DECwindows Motif Version 1.2-5 for OpenVMS product provides online release notes. For information about accessing the release notes:
|
This chapter presents information about the following topics:
Before you install and run DECwindows Motif Version 1.2-5 for OpenVMS 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 Version 1.2-5 for OpenVMS 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 Version 1.2-5 for OpenVMS 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:
If you plan to use DECwindows Motif Version 1.2-5 for OpenVMS 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
DECwindows Motif Version 1.2-5 for OpenVMS software can be installed on any supported Alpha or VAX
processor. For a complete list of supported hardware, see the
DECwindows Motif Version 1.2-5 for OpenVMS Software Product Description (SPD).
1.3 Prerequisites for the Installation Procedures
Before you can install and configure DECwindows Motif Version 1.2-5 for OpenVMS software, you must have the required versions 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 or the VMSINSTAL procedure to install your DECwindows Motif software according to the operating system information that follows.
| Operating System | Installation Method |
|---|---|
|
OpenVMS Alpha Version 7.1 (or higher)
OpenVMS VAX Version 7.1 (or higher) |
POLYCENTER Software Installation utility |
|
OpenVMS Alpha Version 6.2xx
OpenVMS VAX Version 6.2xx |
POLYCENTER Software Installation utility |
| VMS Version 5.5--2 | VMSINSTAL procedure |
The DECwindows Motif Version 1.2-5 for OpenVMS software requires one of the following operating systems:
If your system is not running one of these versions before you attempt to install DECwindows Motif Version 1.2-5 for OpenVMS, the installation fails.
A minimum of 16 MB of memory is required for OpenVMS VAX systems; 32 MB of memory is highly recommended. A minimum of 64 MB of memory is required for OpenVMS Alpha systems; at least 128 MB of memory is highly recommended.
The OpenVMS operating system provides two subsets of components to support DECwindows Motif Version 1.2-5 for OpenVMS. To use DECwindows Motif Version 1.2-5 for OpenVMS software, your system should be running a version of the OpenVMS system that includes the following components:
$ DIR SYS$LIBRARY:DECW$TRANSPORT_COMMON.EXE |
$ DIR SYS$SYSTEM:DECW$SERVER_MAIN.EXE |
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. |
If you are installing the DECwindows Motif Version 1.2-5 for OpenVMS software on an OpenVMS Version 6.2 or 7.1 system, you must first install an ECO to the POLYCENTER Software Installation (PCSI) utility. See the Guide to the DECwindows Motif Version 1.2--5 for OpenVMS CD--ROM for details about this ECO. OpenVMS Version 7.2 includes this functionality in the operating system; therefore, you need not apply this ECO if you are running OpenVMS Version 7.2.
The following example shows a PCSI ECO installation on an OpenVMS Alpha Version 7.1 system (installations on other OpenVMS versions differ slightly):
$ PRODUCT INSTALL VMS62TO71U2_PCSI
The following product has been selected:
DEC AXPVMS VMS62TO71U2_PCSI V1.0 Patch (maintenance update)
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for each selected product and for
any products that may be installed to satisfy software dependency requirements.
DEC AXPVMS VMS62TO71U2_PCSI V1.0
* This product does not have any configuration options.
Execution phase starting ...
The following product will be installed to destination:
DEC AXPVMS VMS62TO71U2_PCSI V1.0 DISK$1:[VMS$COMMON.]
Portion done: 0%
...10%
...40%
...70%
...80%
...90%
...100%
The following product has been installed:
DEC AXPVMS VMS62TO71U2_PCSI V1.0 Patch (maintenance update)
|
The X Window and OSF/Motif libraries that are provided with DECwindows Motif Version 1.2-5 for OpenVMS software are incompatible with those libraries provided with versions of DECwindows Motif for OpenVMS 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 was provided in previous versions of DECwindows Motif is no longer supported in the DECwindows Motif Version 1.2-5 for OpenVMS 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-1 and moves the previous files into the new [.DECW$113] subdirectory.
| Directory | Contents | New Location |
|---|---|---|
| DECW$INCLUDE | C header files | SYS$SYSROOT:[DECW$INCLUDE.DECW$113] |
| SYS$SYSTEM | UIL compiler | SYS$SYSROOT:[SYSEXE.DECW$113] |
| SYS$LIBRARY | Non-C language bindings | SYS$SYSROOT:[SYSLIB.DECW$113] |
Refer to Section 3.2.7 for additional information about saving previous programming environments.
The process for using the saved programming environment is documented in the programmer chapter of the release notes. |
The installation procedure replaces the following file with a new version:
SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF
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 Version 1.2-5 for OpenVMS 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:
$ CREATE/DIRECTORY/PROTECTION=WORLD:R - _$ SYS$COMMON:[DECW$BOOK_LOCAL] |
$ COPY SYS$SYSROOT:[DECW$BOOK]LIBRARY.DECW$BOOKSHELF - _$ SYS$COMMON:[DECW$BOOK_LOCAL]*/LOG |
$ COPY SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.TEMPLATE - _$ SYS$MANAGER:DECW$PRIVATE_APPS_SETUP.COM/LOG |
$ DECW$BOOK == "SYS$COMMON:[DECW$BOOK_LOCAL]" |
$ @SYS$MANAGER:DECW$STARTUP RESTART |
For more information about customizing your DECwindows Motif environment, see Managing DECwindows Motif for OpenVMS Systems.
| Next | Contents | Index |